L_PLACE

Place a list

WSupported on Windows
USupported on Unix
VSupported on OpenVMS
NSupported in Synergy .NET
xcall L_PLACE(list_id, [row][, column])

Arguments

list_id

The ID of the list to place. (n)

row

(optional) The row position for the list. (n)

column

(optional) The column position for the list. (n)

Discussion

L_PLACE places a list. After you have placed the list, if you remove it at a subsequent environment level, the list will automatically be placed again when you call E_EXIT to exit that later environment.

If row and/or column is not passed, the default position is the previous row and/or column placement position. If no previous position exists, the list will be placed at the row and/or column position that was specified when the list was created.

See also

L_REMOVE routine for information on removing a list

Examples

The following example moves the list, whose ID is stored in order_lst, vertically to row 5. The horizontal position will be the same as the previous placement ,  if it’s valid,  or the original placement.

xcall l_place(order_lst, 5)

The next example removes the list whose ID is stored in trans_lst, and then processes the menu. If the user selects the menu entry whose name is “PRCTRNS,” the list will be placed at its previous location.

xcall l_remove(trans_lst)
xcall m_process
case g_entnam of
  begincase
      .
      .
      .
"PRCTRNS": begin                       ;Place the list at
             xcall l_place(trans_lst)  ; previous position
             call process              ;Process the list
           end
  endcase