DR SELECT BY REGION

version 6.0

DR SELECT BY REGION (area; method; action; left; top; right; bottom)

Parameter	Type		Description
area	Longint		4D Draw area
method	Integer		0=Enclose
			1=Intersect
action	Integer		0=Deselect
			1=Select
			2=Toggle
left	Number		Left boundary
top	Number		Top boundary
right	Number		Right boundary
bottom	Number		Bottom boundary

The command DR SELECT BY REGION selects or deselects objects within a rectangular region of area. This command is the procedural equivalent of the user dragging a selection rectangle to select objects.

The region is described by left, top, right, and bottom. All four coordinates are specified in base units according to the current origin. Use the DR Scale to base function to convert from scale units to base units.

method determines whether objects must be completely enclosed to be affected.

• If method equals 0, objects must be completely enclosed within the region to be affected.

• If method equals 1, objects need only intersect the region to be affected.

The objects are selected or deselected based on the action parameter.

• If action equals 0, DR SELECT BY REGION deselects the objects.

• If action equals 1, the command selects the objects.

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

DR SELECT BY REGION does not affect objects outside of the region. This means that if objects are already selected in area and are not within the region, they remain selected.

The following example deselects all objects in Area and then selects any objects on the first page of the document.

   DR SELECT (Area;-1;0)
   DR SET ORIGIN (Area;0;0;0)
   DR SELECT BY REGION (Area;0;1;0;0;7.67;10.14)

DR GET BOUNDARY.