NEXT-SIBLING attribute
The next entry in a list of handles, relative to a given handle.
Data type:
HANDLE
Access:
Readable
Applies to:
Asynchronous request object handle, BROWSE widget, Buffer object handle, BUTTON widget, COMBO-BOX widget, CONTROL-FRAME widget, Data-source object handle, DIALOG-BOX widget, EDITOR widget, FIELD-GROUP widget, FILL-IN widget, FRAME widget, IMAGE widget, LITERAL widget, MENU-ITEM widget, Procedure object handle, ProDataSet object handle, RADIO-SET widget, RECTANGLE widget, SELECTION-LIST widget, Server object handle, SLIDER widget, Socket object handle, Server socket object handle, SESSION system handle, SUB-MENU widget, TEXT widget, TOGGLE-BOX widget, WINDOW widget
Table 91 summarizes the value of NEXT-SIBLING for each relevant handle type.
Table 91: NEXT-SIBLING attribute values by handle type
|
|
|
|
Asynchronous Request
|
The handle of the next asynchronous request submitted for execution on the AppServer or Web Server that is running the specified request.
|
|
Procedure
|
The handle of the next persistent procedure in the current ABL session. If the current procedure is a proxy for a persistent procedure running on an AppServer or for a Web service, specifies the next procedure object bound to the same server handle.
|
|
Server
|
The next server handle created in the current ABL session (independent of subtype).
|
|
Socket and Server-socket
|
The next socket handle in the chain of socket handles for the current ABL session. Returns the Unknown value (?) for the last handle in the chain.
|
|
ProDataSet object
|
The handle to the next dynamic ProDataSet object in the chain of ProDataSet objects for the current ABL session, which is available after using the SESSION:FIRST-DATASET attribute.
|
|
Dynamic query
|
The handle to the next dynamic query in the chain of dynamic queries for the current ABL session, which is available after using the SESSION:FIRST-QUERY attribute.
|
|
Dynamic Data-source object
|
The handle to the next dynamic Data-source object in the chain of dynamic Data-source objects for the current ABL session, which is available after using the SESSION:FIRST-DATA-SOURCE attribute.
|
|
Buffer object
|
The handle to the next buffer object in the session buffer list, which is available after using the SESSION:FIRST-BUFFER attribute.
|
|
Widget
|
The handle of the next widget in the widget list.
Note:
A widget must first be realized before it can become part of the list. A hidden widget cannot become part of the list since it is not realized. A widget that is already part of the list can be hidden and it remains part of the list.
|
If the given handle is the last handle in the list, NEXT-SIBLING assumes the value of an invalid handle. To check the validity of a handle, use the VALID-HANDLE function.
See also:
PREV-SIBLING attribute
