API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ISTATIC_SETTEXTEX()

Brew Release
Brew MP 1.0.2
See Also
IStatic ISTATIC_SetText
Description
This method sets the text of the specified IStatic object. The function allows the caller to:
- Specify text of either single-byte or double-byte width according to the flags passed to the ISTATIC_SetProperties
function. By default, text is considered to be double-byte unless the ST_ASCII property has been set.
- Append to or replace the existing text.

- Read text from an input stream. This allows the caller to avoid buffering text from a file or socket.
Params
pIStatic
[]:
Pointer to the IStatic interface object.
pbText
[]:
Pointer to the text.
pStream
[]:
Pointer to the text stream.
bAppend
[]:
TRUE to append text, FALSE to reset text.
Interface
  • ISTATIC
Prototype
  •     boolean ISTATIC_SetTextEx(IStatic * pIStatic, byte * pbText, 
                                  IAStream * pStream, boolean bAppend);
    
Return
  • TRUE: the text was set or added. FALSE: the text was not set or added.
Side Effect
  • Please note the following: - Title text is ALWAYS assumed to be double-byte. ST_ASCII impacts only the text and not the title.

    - Changing the ST_ASCII property automatically frees/resets the text in the control.

    - After the ST_ASCII property has been set or cleared, all text operations are assumed to be either single- or double-byte.

    - Passing both the pbText and pStream parameters add/replace the existing text from pbText and then read from the stream.
Comments
None