Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : NEXT-SIBLING attribute
 

NEXT-SIBLING attribute

The next entry in a list of handles, relative to a given handle.
Data type: HANDLE
Access: Read-only
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
The following table summarizes the value of NEXT-SIBLING for each relevant handle type.
Table 92. NEXT-SIBLING attribute values by handle type
Handle type
Value of NEXT-SIBLING
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