C++ Syntax

bool

MKI_EditFitAlign(

__int32 f_nFlag,

double f_dX,

double f_dY,

__int32 f_nFitMode,

double f_dFitSizeX,

double f_dFitSizeY,

__int32 f_nAlignMode,

__int32 f_nScaleMode );

Multiplies all entities included with the given flag to fit into a given rectangle or to align to a given point. This will directly edit the entities without creating a duplicate and bypassing the undo structure.

This procedure will not create undo information, regardless of whether it is called inside a MKI_UndoInitProcess and MKI_UndoFinishProcess bracket or not!

Parameters

f_nFlag

[__int32] Determines which entities shall be modified. Use 0 to modify all entities in the drawing, MKI_FLAG_USE to modify identified entities, or MKI_FLAG_PREVIOUS to modify all previously identified entities (see MKI_FLAG_*).

f_dX

f_dY

[double] Alignment point in internal [mm] (relative to the internal origin, scale-independent).

f_nFitMode

[__int32] Fitting mode, see MKI_FITMODE_*.

f_dFitSizeX

f_dFitSizeY

[double] Absolute size of a rectangle in internal [mm] to fit into. It starts at f_dX and f_dY and extents to the right and upwards. If one or both values are zero or negative, no fitting will occur. Will be ignored if f_nFitMode is MKI_FITMODE_NONE.

f_nAlignMode

[__int32] Alignment mode, see MKI_ALIGNMODE_*.

f_nScaleMode

[__int32] Determines if dimension texts sizes, line widths, and line type length factors shall be scaled according to the matrix or not. A bit-wise OR combination of the following values (see MKI_DISPLAYMODE_*):

MKI_DISPLAYMODE_DEFAULT

MKI_DISPLAYMODE_SCALED_WIDTH

MKI_DISPLAYMODE_SCALED_LENGTH

MKI_DISPLAYMODE_SCALED_DIMTEXT

Return Value

Returns true if successful. If false is returned, this is usually due to invalid parameters.