AcDbOrdinateDimension( Adesk::Boolean useXAxis, const AcGePoint3d& definingPoint, const AcGePoint3d& leaderEndPoint, const ACHAR * dimText = NULL, AcDbObjectId dimStyle = AcDbObjectId::kNull );
This constructor uses the parameters passed in to initialize the dimension. In addition, the origin point is set to (0,0,0) in WCS coordinates and the rest of the AcDbDimension, AcDbEntity, etc., default constructor initializations are performed.
A copy of the dimText string will be used by the dimension.
The dimText string needs to contain any desired MText formatting characters. The substring "<>" may be used anywhere within the string as a marker to indicate that the default text should be displayed there in place of the "<>" (it is possible to have more than one set of "<>" in the text string, but only the first set will be interpreted as the default text place holder).
If dimText is NULL, then when the Dimension is closed, the Dimension text string is set to an empty string and the default Dimension text (that is, a text string automatically generated based on the dimStyle, dimVar settings, and the actual measurement of the angle) is used.
If dimStyle is left as AcDbObjectId::kNull, then the object ID of the current default dimStyle within the AutoCAD editor is used.
useXAxis is reflected in bit 7 of DXF group code 70 (if useXAxis is Adesk::kTrue then bit 7 is set).
definingPoint is used for DXF group code 13.
leaderEndPoint is used for DXF group code 14.
dimText is used for DXF group code 1.
The name string within the dimension style specified by dimStyle is used for DXF group code 3.
Parameters | Description |
---|---|
useXAxis | Input Boolean indicating whether to use the X axis (Adesk::kTrue) or the Y axis (Adesk::kFalse) |
definingPoint | Input point where ordinate leader should start |
leaderEndPoint | Input point where ordinate leader should end |
dimText | Input text string to use as the dimension annotation |
dimStyle | Input object ID of AcDbDimStyleTableRecord to use |