Progress
Language Reference
NAME Attribute
A string identifier for the specified object or widget.
Data Type: CHARACTERAccess: Readable/WriteableApplies To: Asynchronous Request Object Handle, Browse, Browse cell, Buffer Object Handle, Buffer-field Object Handle, Button, Combo-box, Control-frame, Dialog-box, Editor, Field-group, Fill-in, Frame, Image, Literal, Menu, Menu-item, Query Object Handle, Radio-set, Rectangle, Selection-list, Server Object Handle, Server-socket Object Handle, Slider, Socket Object Handle, Sub-menu, Temp-table Object Handle, Text, Toggle-box, Window, X-document Object Handle, X-noderef Object HandleFor static data representation widgets, this attribute value defaults to the value of the name of the field or variable associated with the widget. You can use the NAME attribute to store any information associated with the widget.
For server handles, the NAME attribute defaults to the name of the Progress AppServer.
For control-frames, this attribute maps to the Name property of the of the control-frame COM object (ActiveX control container).
For dynamic widgets and asynchronous request handles, this attribute defaults to the unknown value (?).
CAUTION: If you change the value of this property at run time, any OCX event procedures that you have defined for a corresponding ActiveX control will not respond to control events because the events are sent with the new name.For query objects, the NAME attribute applies only to static queries. For more information on query objects, see the Progress Programming Handbook .
For temp-table objects, this returns the name of the temp-table as specified in the TEMP-TABLE-PREPARE method. If TEMP-TABLE-PREPARE( ) has not been called or the name has been cleared by CLEAR( ) and no subsequent TEMP-TABLE-PREPARE( ) has been called, then this attribute returns the UNKNOWN value (?), which means that the table is in the UNPREPARED state.
For the X-document Object Handle or X-noderef Object Handle, this attribute returns the name of the XML node.
For any object or widget, this attribute can contain any arbitrary value that you set.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |