NAME attribute

A string identifier for the specified object or widget.

Data type:

CHARACTER

Access:

Readable/Writeable

Applies to:

Asynchronous request object handle, BROWSE widget (browse, column, and cell), Buffer object handle, Buffer-field object handle, BUTTON widget, COMBO-BOX widget, CONTROL-FRAME widget, Data-relation object handle, Data-source object handle, DIALOG-BOX widget, EDITOR widget, FIELD-GROUP widget, FILL-IN widget, FRAME widget, IMAGE widget, LITERAL widget, MENU widget, MENU-ITEM widget, Procedure object handle, ProDataSet object handle, Query object handle, RADIO-SET widget, RECTANGLE widget, SELECTION-LIST widget, Server object handle, Server socket object handle, SLIDER widget, SOAP-header object handle, SOAP-header-entryref object handle, Socket object handle, SOURCE-PROCEDURE system handle, Stream object handle, SUB-MENU widget, TARGET-PROCEDURE system handle, Temp-table object handle, TEXT widget, THIS-PROCEDURE system handle, TOGGLE-BOX widget, WINDOW widget, X-document object handle, X-noderef object handle

For the SOAP-header and SOAP-header-entryref object handles, this attribute is read-only.

For static data representation widgets, the default value is 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 a state-reset, state-aware, or stateless AppServer, this attribute returns the connection ID for the AppServer associated with the server handle. For a state-free AppServer, it returns the connection ID of the first AppServer connection created in the session pool with this server handle when the application service is first bound using the CONNECT( ) method. The default value is the unique connection name of the AppServer.

For Web services, the default value is the URL of the Web service procedure object from the WSDL. This is the portType name used on the RUN statement that instantiated this object.

For a non-Web service procedure, returns the pathname of the procedure file that contains the current procedure.

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 the SOAP-header object handle, this attribute is the qualified name of the SOAP-header object, which consists of a namespace prefix + “:” + HEADER.

For the SOAP-header-entryref object handle, this attribute is the qualified name of the SOAP-header-entryref object, which consists of a namespace prefix + “:” + localname. You cannot change this attribute directly; you must use the local-name and namespace-prefix.

The NAME attribute of the Temp-table object handle is writeable for dynamic and AVM-generated temp-tables. A new temp-table name cannot be assigned until after the TEMP-TABLE-PREPARE() method has been executed.

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.