DR SELECT

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 SELECT (area; scope; action)

ParameterTypeDescription
areaLongint4D Draw area
scopeLongint-1=All
0=Selected
>0=Object ID
actionInteger0=Deselect
1=Select
2=Toggle

Description

The command DR SELECT selects or deselects the objects in area described by scope.

If scope equals -1, DR SELECT affects all objects in the document.

If scope equals 0, DR SELECT affects the selected objects.

If scope is greater than 0, it must be equal to a specific object's ID; DR SELECT affects that object. If the object does not exist, DR SELECT does nothing, and DR Error returns error number 2.

DR SELECT selects or deselects the objects described by scope are according to the action parameter.

If action equals 0, the command deselects the objects described by scope.

If action equals 1, the command deselects the objects described by scope.

If action equals 2, the command toggles the current state of the objects, that is, it selects deselected objects and vice-versa.

Objects outside of scope are not affected by DR SELECT. That is, objects that are already selected in area and have not been specified by scope remain selected.

Example

The following example deselects all objects in the document and then selects the object with an ID number equal to 1.

   DR SELECT (Area;-1;0)
   DR SELECT (Area;1;1)

See Also

DR Get ID, DR SELECT BY ATTRIBUTE, DR SELECT BY REGION, DR SET HIGHLIGHT.


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