Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/chips/ahelp/arrange_frames.html
Jump to: Description · Example · Bugs · See Also


AHELP for CIAO 4.11 ChIPS v1

arrange_frames

Context: frames

Synopsis

Reorder the frames in a window.

Syntax

arrange_frames(id_list)
arrange_frames(id, id_list)

Description

The function arguments.

Argument Description
id_list An array of frame names indicating the new order.
id A ChipsId structure identifying the item.

The arrange_frames command changes the rendering order of the frames in a window. The frames are displayed in the order they were created by default. In addition to affecting how overlapping frames are drawn, changing the rendering order affects how the frames are displayed by the next_frame and prev_frame commands. The list of frame ids (id_list) is ordered from back to front for rendering; all the frames must exist in the same window.


Example

chips> add_frame(0.1, 0.1, 0.5, 0.6, "bgcolor=red")
chips> add_frame(0.3, 0.3, 0.8, 0.8, "bgcolor=green")
chips> add_frame(.2, 0.2, 0.7, 0.4, "bgcolor=blue")
chips> arrange_frames( ["frm2", "frm1", "frm3"])

Create three frames with different background colors. Rearrange the frames so that "frm1" is drawn on top of "frm2", then "frm3" is drawn.


Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

frames
add_frame, blink_frames, current_frame, delete_frame, display_frame, get_frame, hide_frame, move_frame, next_frame, reposition_frame, set_frame, tile, view_placed_frame, view_single_frame
utilities
erase, get_object_count