SftPicture2 Documentation

Sft_InitText

Initialize a freshly allocated SFT_TEXT so it represents an empty text label. Equivalent to memset(0).

C

void Sft_InitText(LPSFT_TEXT lpText);

Parameters

lpText

Pointer to a SFT_TEXT allocated by the application. Must not be NULL.

Comments

Call once on each application-allocated SFT_TEXT before its first use. SFT_TEXT fields embedded in per-product control structures are initialized by the host control automatically and do not need a separate Sft_InitText call.

After Sft_InitText, the structure has zero in every field - which renders as no text, system font, default colors, GDI rendering. Populate lpszText (and optionally hFont, colorFg, align, valign) before passing the structure to a per-product API.

Sft_InitText does not release any resources stored in the structure - the application owns the string, font and brush handles and is responsible for releasing them when the SFT_TEXT (or the host control containing it) is no longer needed.

See Also SftPicture2 | SFT_TEXT | Sft_InitPicture