version 6.0
DR SELECT (area; scope; action)
| Parameter | Type | Description | |
| area | Longint | 4D Draw area | |
| scope | Longint | -1=All | |
| 0=Selected | |||
| >0=Object ID | |||
| action | Integer | 0=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.