version 6.0
DR SET NAME (area; scope; name)
| Parameter | Type | Description | |
| area | Longint | 4D Draw area | |
| scope | Longint | -2 = Default, -1 = All, 0 = Selected, >0 = ID | |
| name | String | Name |
Description
The command DR SET NAME makes name the name for the objects in the area described by scope.
A name is a string associated with an object and is not necessarily unique. Names have a maximum length of 31 characters. Names can be set by the user through the Object Attributes dialog box.
If scope equals -2, the command sets the default name.
If scope equals -1, the command sets the name for all objects in the document.
If scope equals 0, the command sets the name for the selected objects.
If scope is greater than 0, it must be equal to a specific object's ID; DR SET NAME and that object's name is set. If the object does not exist, DR SET NAME does nothing, and DR Error returns error code 2.
Example
This example sets the names for all objects in area to empty strings.
DR SET NAME (Area;-1;"")
See Also