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