Progress
Programming
Handbook


Attribute References

You reference an attribute the same way, whether for reading or setting, and this is the syntax for an attribute reference:

SYNTAX
widget:attribute [ IN { FRAME | MENU | SUB-MENU } name ] 

The widget parameter is the name of a widget (UIC), or a widget, procedure, or system handle. The attribute parameter specifies the name of the widget or handle attribute. You must leave no space between the colon (:) and its parameters.

The name parameter specifies the name of a container widget appropriate for the static UIC specified by widget. If the widget appears in more than one frame or menu, the default frame or menu is the most recently defined container whose description includes the widget. If the widget appears in more than one submenu, the default submenu is the first submenu in the menu tree whose description includes the widget.

Note that specifying a container name is only appropriate where widget specifies a name reference to a static widget. Handles are unique by definition and take no container name as part of the attribute reference.

Whenever possible, use unique names for your static widgets. Otherwise, specify the container widget in the attribute reference. Thus, if you add widget definitions later, you can avoid bugs caused by referencing the wrong default widget in your current attribute references.


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