C++ Syntax

MKI_ObjectAddDimLarge(

bool f_fUseGlobal,

bool f_fIsAngle );

Adds a large dimension parameter data block (MKI_DB_INFO_DIMLARGE) to a previously opened provisional object (see MKI_ObjectOpen). This type of data block is usually used inside dimension objects that include dimension lines (MKI_OBJ_DDISTANCE, MKI_OBJ_DRADIUS, MKI_OBJ_DDIAMETER, MKI_OBJ_DANGLE and MKI_OBJ_DARCLENGTH).

Parameters

Data

[MKI_CONST_DIMLARGE_REF] Data to be stored in the large dimension parameter data block. The TextXProperty component will be overwritten by the current default properties for that object. In case these properties are to be modified, use the address returned from this procedure to access them directly.

UseGlobal

[bool] If this value is true, most elements of the structure that are part of the MKI_DIMSMALL section of Data will not be used, instead, the current global dimension parameters defined by IsAngle will be used.

IsAngle

[bool] If this value is true, the global dimension parameters for angle dimensions will be used, otherwise the global dimension parameters for length dimensions will be used. IsAngle will be ignored if UseGlobal is false.

Return Value

Returns the address of the TextXProperty component of the created data block if the data block was added successfully. This address can be used to alter the default properties of the dimension text. If nullptr is returned, this indicates that the object would be too large after adding this data block.