Function AddDimension( _
   ByVal X As System.Double, _
   ByVal Y As System.Double, _
   ByVal Z As System.Double, _
   ByVal Direction As System.Integer _
) As System.Object

Dim instance As IModelDocExtension
Dim X As System.Double
Dim Y As System.Double
Dim Z As System.Double
Dim Direction As System.Integer
Dim value As System.Object
 
value = instance.AddDimension(X, Y, Z, Direction)

System.object AddDimension( 
   System.double X,
   System.double Y,
   System.double Z,
   System.int Direction
)

System.Object^ AddDimension( 
&   System.double X,
&   System.double Y,
&   System.double Z,
&   System.int Direction
) 

Parameters

X

X coordinate of display dimension text

Y

Y coordinate of display dimension text

Z

Z coordinate of display dimension text

Direction

Direction of dimensioning extension line or rapid dimensioning quadrant as defined in swSmartDimensionDirection_e (see Remarks)

Return Value

X, Y, and Z coordinates of the display dimension text must be appropriate for the specified Direction, or this method fails to add the display dimension.

For parts, Direction specifies the dimensioning manipulator direction that appears in the user interface when an extension line is needed to unambiguously define what is to be dimensioned.

For drawings, Direction specifies the rapid dimensioning selector quadrant to which to add the display dimension.

Before calling this method, you must select the entities for which to add a display dimension. Entities must be selected by location and not name. If you specify line names instead of coordinates, the dimensioning routines randomly pick locations on the lines, which can yield unpredictable results during angular dimension creation.

For example, to create an angular dimension between two lines:

1. Call IModelDocExtension::SelectByID2 to select a sketch segment of the angle you want to dimension, specifying the line's XYZ coordinates.
2. Call IModelDocExtension::SelectByID2 to select the vertex of the angle you want to dimension, specifying the vertex's XYZ coordinates.
3. Call this method, specifying the X, Y, Z coordinates of the display dimension text and the Direction of the extension line that is needed to unambiguously define the angle to dimension.

If the pre-selected entities unambiguously define what you wish to dimension, then no extension lines are needed. In that case, call IModelDoc2::AddDimension2 instead of this method.

You should only use this method on visible documents. Before using this method, use ISldWorks::Visible to check whether a document is visible.

Before calling this method, you might want to call ISldWorks::SetUserPreferenceToggle with swUserPreferenceToggle_e.swInputDimValOnCreate to suppress the dialog box that allows the user to enter the dimension value.