Progress
Language Reference
Handle Reference
This chapter describes Progress object handles and lists the attributes and methods of each one. Object handles are essentially addresses that provide access to 4GL objects in memory. These objects include widgets, which encapsulate user interface capabilities, and other object types that provide access to a variety of Progress session capabilities.
Progress makes object handles available in two ways:
- Directly, as system handle values. A system handle is a Progress keyword that evaluates to an object handle whose object type is implied by the keyword. For example, the CURRENT-WINDOW system handle is a handle to a window widget. To access the attributes and methods of a system handle, you can use the keyword directly, or you can assign the keyword value to a handle variable and use the variable to reference the attributes and methods:
- Indirectly, as values output from certain Progress statements, including other handle attributes and methods. You can access the attributes and methods of any object by assigning its handle to a handle variable, which can hold handle values of any type. You can then use this variable to reference the attributes and methods of the object:
The following reference entries include both system handles and handle types for objects not necessarily referenced using system handles. Each system handle is listed by its keyword (all upper case, for example: SESSION System Handle), and each handle type is listed by its type (upper/lower case, for example: Server Object Handle).
Each entry lists the attributes and methods supported by the handle or refers you to a more general entry with the same list. For example, the attributes and methods of the CURRENT-WINDOW system handle appear under the WINDOW Widget entry. Widgets, in general, share a common set of user interface capabilities. For a list of the attributes and methods supported by each widget, see the "Widget Reference" section of this manual.
For more information on how to access attributes and methods using all object handles, see the "Attributes and Methods Reference" section of this manual, which includes a complete reference entry for each attribute and method.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |