C++ Syntax

bool

MKI_ObjectAddTextShort(

const LPCWSTR f_pszText,

bool f_fStaticLength );

Adds a short text data block (MKI_DB_ALL_TEXT) to a previously opened provisional object (see MKI_ObjectOpen). This type of data block is usually used inside dimension objects (MKI_OBJ_D???) and inside comments (MKI_OBJ_COMMENT).

Parameters

f_pszText

[const LPCWSTR] Text to be stored in the text data block. The maximum length is MKI_LENGTH_TEXT_SHORT.

f_fStaticLength

[bool] Indicates whether the text data block should have static length or not. If true, the application will allocate memory for MKI_LENGTH_TEXT_SHORT characters, independent of the length of f_pszText. This allows direct manipulation of that data block without the need to reorganize the object. If false, the application will allocate only as much memory as required to store f_pszText.

Return Value

Returns true if the data block was added successfully. If false is returned, this indicates that the object would be too large after adding this data block.