arrange_frames

Synopsis

Reorder the frames in a window.

arrange_frames(id_list)
arrange_frames(id, id_list)

Description

• id - an optional ChipsId structure containing values to modify the currency state for the command.
• id_list - list of frame ids indicating the new order of frames.

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 ("ahelp next_frame") . 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(.1, .1, .5, .6, "bgcolor=red");
chips> add_frame(.3, .3, .8, .8, "bgcolor=green");
chips> add_frame(.2, .2, .7, .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.

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