Function SetUnits( _
   ByVal UseDoc As Boolean, _
   ByVal UType As Integer, _
   ByVal FractBase As Integer, _
   ByVal FractDenom As Integer, _
   ByVal RoundToFraction As Boolean _
) As Integer

Dim instance As IDisplayDimension
Dim UseDoc As Boolean
Dim UType As Integer
Dim FractBase As Integer
Dim FractDenom As Integer
Dim RoundToFraction As Boolean
Dim value As Integer
 
value = instance.SetUnits(UseDoc, UType, FractBase, FractDenom, RoundToFraction)

int SetUnits( 
   bool UseDoc,
   int UType,
   int FractBase,
   int FractDenom,
   bool RoundToFraction
)

int SetUnits( 
&   bool UseDoc,
&   int UType,
&   int FractBase,
&   int FractDenom,
&   bool RoundToFraction
) 

Parameters

UseDoc

True uses the document settings for units, false uses the setting values passed to the arguments (see Remarks)

UType

Unit display setting as defined in swLengthUnits_e or swAngleUnits_e

FractBase

Decimal or fraction display setting as defined in swFractionDisplay_e

FractDenom

Denominator for fraction display

RoundToFraction

True rounds values to the nearest fraction, false displays fractions only if the values are exact

Return Value

Return status (see Remarks)

The unit display settings of a display dimension are controlled by a value stored in one of two places: on the owning document, or on the individual display dimension. This method allows you to determine which setting to use, the document default or the values specified by UType, FractBase, FractDenom, and RoundToFraction.

If the UseDoc argument is True, then the display dimension unit information follows the document settings, and SolidWorks ignores the remainder of the arguments. SolidWorks also removes any local settings so that if you switch back to the local settings, they are set to default values.

The UType argument indicates the units. Depending on the type of dimension (angular or linear), this parameter takes a value from swLengthUnits_e or swAngleUnits_e. If the specified value is invalid, SolidWorks does not change the existing setting and returns an error in the return value.

The FractBase argument indicates whether the dimension is displayed as a fraction or a decimal. This must take a value from swFractionDisplay_e. SolidWorks displays this value as a fraction only if it can be precisely represented as a fraction based on the fraction denominator setting specified in FractDenom. However, if the RoundToFraction argument is True, SolidWorks forces fraction display by rounding the value to the nearest fraction.

The FractDenom argument indicates the fraction precision by specifying the largest fraction denominator used (for example, 4 for 1/4 or 32 for 1/32). Fraction display is valid only if UType is swINCHES or swFEETINCHES.

The return value indicates the success or failure of this function. It may take one of the following values:

After using this method, use IModelDoc2::GraphicsRedraw2 to redraw the graphics window to see your changes.