DR SET NAME

4D - Documentation   Français   English   German   4D Draw 2004, Command Theme List   4D Draw 2004, Command Alphabetical List   Back   Previous   Next

version 6.0


DR SET NAME (area; scope; name)

ParameterTypeDescription
areaLongint4D Draw area
scopeLongint-2 = Default, -1 = All, 0 = Selected, >0 = ID
nameStringName

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

DR Get ID, DR GET NAME.


4D - Documentation   Français   English   German   4D Draw 2004, Command Theme List   4D Draw 2004, Command Alphabetical List   Back   Previous   Next