C++ Syntax

bool

MKI_CalcRefFrame(

const LPCWSTR f_pszDrawingName,

__int32 f_nDisplayMode,

MKI_CONST_MATRIX_PTR f_pMatrix,

MKI_RECT_PTR f_pFrame );

Calculates the surrounding frame of a referenced drawing.

Parameters

DrawingName

[const LPCWSTR] Filename of the referenced drawing whose surrounding frame is to be calculated.

DisplayMode

[__int32] Bit-wise OR combination of some flags indicating the display mode for references. Possible values are (see MKI_DISPLAYMODE_*):

MKI_DISPLAYMODE_DEFAULT

MKI_DISPLAYMODE_SCALED_WIDTH

MKI_DISPLAYMODE_CONFINED

MKI_DISPLAYMODE_NOGEO

MKI_DISPLAYMODE_SCALED_LENGTH

Matrix

[MKI_CONST_MATRIX_PTR] Matrix with which the block is to be temporarily multiplied before calculating the surrounding frame. If Matrix is nullptr, no temporary modification is performed. The referenced drawing will never be modified!

Frame

[MKI_RECT_PTR] Address of a rectangle buffer to receive the calculated surrounding frame. If Frame is nullptr, the frame will not be calculated. The coordinates are sorted, i.e. x1 <= x2 and y1 <= y2.

Return Value

Returns the true if successful. If false is returned, the rectangle pointed to by Frame is not modified.

Comment

This procedure can be used to check whether a specific referenced drawing already loaded. In this case set both Matrix and Frame to nullptr.