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.
| 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.