Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message sets the text in the specified part of a status window.

Syntax 

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. It is one of the following values.

Value Description

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

Null-terminated string that specifies the text to set. If uTypeis 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_DRAWITEMmessage. The text for each part is limited to 127 characters.

Return Value

TRUE indicates success. FALSE indicates failure.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also