The features described in this topic are obsolete
and should not be used in new IDL code.

HANDLE_MOVE

This routine is obsolete and should not be used in new IDL code.

The HANDLE_MOVE procedure moves a handle (specified by Move_ID) to a new location. This new position is specified relative to Static_ID.

Syntax

HANDLE_MOVE, Static_ID, Move_ID

Arguments

Static_ID

The handle ID relative to which the handle specified by Move_ID is moved. By default, Move_ID becomes the last child of Static_ID. This behavior can be changed by specifying one of the keywords described below.

If Static_ID is set to 0, Move_ID becomes a top level handle without any parent. Static_ID cannot be a child of Move_ID.

Move_ID

The ID of the handle to be moved.

Keywords

FIRST_CHILD

Set this keyword to make Move_ID the first child of Static_ID. Any existing children of Static_ID become later siblings of the new first child (i.e., the existing first child becomes the second child, the second child becomes the third child, etc.).

SIBLING

Set this keyword to make Move_ID the sibling handle immediately following Static_ID. Any siblings currently following Static_ID become later siblings of the new handle. Note that you cannot move a handle such that is becomes a sibling of a top-level handle.

Example

; Create top-level handle: 
top = HANDLE_CREATE() 
; Create first child of top: 
child1 = HANDLE_CREATE(top) 
; Create second child of top: 
child2 = HANDLE_CREATE(top) 
; Move the first child to be the last child of top: 
HANDLE_MOVE, top, child1