SB_SETTEXT
The
SB_SETTEXT message sets the text in the specified part of a status window.
SB_SETTEXT
wParam = (WPARAM) iPart | uType;
lParam = (LPARAM) (LPSTR) szText;
Parameters
iPart
Zero-based
index of the part to set. If this value is 255, the status window is assumed to
be a simple window having only one part.
uType
Type of
drawing operation. This parameter can be one of the following values:
|
Value |
Meaning |
|
0 |
The text is
drawn with a border to appear lower than the plane of the window. |
|
SBT_NOBORDERS |
The text is
drawn without borders. |
|
SBT_OWNERDRAW |
The text is
drawn by the parent window. |
|
SBT_POPOUT |
The text is
drawn with a border to appear higher than the plane of the window. |
|
SBT_RTLREADING |
Displays
text using right-to-left reading order on Hebrew or Arabic systems. |
szText
Pointer to a
null-terminated string that specifies the text to set. If uType is
SBT_OWNERDRAW, this parameter represents 32 bits of data. The parent window
must interpret the data and draw the text when it receives the WM_DRAWITEM
message.
Return Values
If the
operation succeeds, the return value is TRUE.
If the
operation fails, the return value is FALSE.
Remarks
The message
invalidates the portion of the window that has changed, causing it to display
the new text when the window next receives the WM_PAINT message.
See Also