AcMapLocationCondition class

Land Desktop Development ARX CPP SDK

 

AcMapLocationCondition class

Header file: MapQuery.h.

A location condition is used to select drawing objects based on their spatial location in a drawing.

A location condition contains a join operator (AND or OR), a location type (either Inside or Crossing), and a boundary.

There are many types of boundaries: location boundaries, all boundaries, circle boundaries, fence boundaries, buffer fence boundaries, polygon boundaries, window boundaries, polyline boundaries, buffer polyline boundaries, and closed polyline boundaries.

Inside and Crossing are not appropriate with all types of boundaries. For example, you cannot use Inside with a fence boundary, only Crossing.

After you have created the location condition, add it to a query branch using the AcMapQueryBranch::AppendOperand, AcMapQueryBranch::InsertOperand, or AcMapQueryBranchSubstituteOperands. Since these functions make a copy of the AcMapLocationCondition object, you can release the location condition after adding it to the query branch.

After you define the query with the query branch, the query will select drawing objects that lie inside or cross the boundary, depending on the location condition’s location type.

The AcMapLocationCondition class is derived from the AcMapQueryCondition class.

Do not subclass from this class.