Progress
Language Reference


NEXT-SIBLING Attribute

The next entry in the list of asynchronous request handles, persistent procedure handles, server handles, temp-table object handles or widget handles, relative to a given handle.

Data Type: WIDGET-HANDLE

Access: Readable

Applies To: Asynchronous Request Object Handle, Browse, Buffer Object Handle, Button, Combo-box, Control-frame, Dialog-box, Editor, Field-group, Fill-in, Frame, Image, Literal, Menu-item, Radio-set, Rectangle, Selection-list, Server Object Handle, Slider, Socket Object Handle, Server-socket Object Handle, Sub-menu, Text, THIS-PROCEDURE System Handle (and all procedure handles), Toggle-box, Window.

Table 58 summarizes the value of NEXT-SIBLING for each relevant handle type.

Table 58: NEXT-SIBLING Attribute 
Handle Type
Value of NEXT-SIBLING
Asynchronous Request
The handle of the next asynchronous request submitted for execution on the AppServer that is running the specified request.
Procedure
The handle of the next persistent procedure in the current Progress session.
Server
The next server handle created in the current Progress session.
Socket and Server-socket
The next socket handle in the chain of socket handles for the current Progress session. Returns the unknown value (?) for the last handle in the chain.
Buffer object
The handle of the next buffer object in the session buffer list which is available using the SESSION:FIRST-BUFFER attribute.
Widget
The handle of the next widget in the widget 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.

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.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095