AcDbAlignedDimension::AcDbAlignedDimension

C++

AcDbAlignedDimension(
    const AcGePoint3d& xLine1Point, 
    const AcGePoint3d& xLine2Point, 
    const AcGePoint3d& dimLinePoint, 
    const ACHAR * dimText = NULL, 
    AcDbObjectId dimStyle = AcDbObjectId::kNull
);

Description

This constructor uses the parameters passed in to initialize the dimension. In addition, the extension line obliquing angle is set to 0.0 and the rest of the AcDbDimension, AcDbEntity, and others, default constructor initializations are performed.

A copy of the dimText string will be used by the dimension.

The dimText string will need 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 placeholder.

If dimText is NULL, then when the dimension is closed, the dimension text string will be set to an empty string and the default dimension text is used. The default dimension text is an automatically generated text string based on the dimStyle, dimVar settings, and the actual measurement of the angle.

If dimStyle is left as AcDbObjectId::kNull, then the object ID of the current default dimStyle within the AutoCAD editor is used.

xLine1Point (the first extension line start point) is used for DXF group code 13.

xLine2Point (the second extension line start point) is used for DXF group code 14.

dimLinePoint (the dimension line definition point) is used for DXF group code 10.

dimText (the dimension annotation text) 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

Parameters Description
xLine1Point Input start point (in WCS coordinates) of first extension line
xLine2Point Input start point (in WCS coordinates) of second extension line
dimLinePoint Input point (in WCS coordinates) on dimension line itself
dimText Input text string to use as the dimension annotation
dimStyle Input object ID of AcDbDimStyleTableRecord to use

Links

AcDbAlignedDimension