Windows Dev Center

DrawStatusText function

The DrawStatusText function draws the specified text in the style of a status window with borders.

Syntax


void DrawStatusText(
   HDC     hdc,
   LPCRECT lprc,
   LPCTSTR pszText,
   UINT    uFlags
);

Parameters

hdc

Type: HDC

Handle to the display context for the window.

lprc

Type: LPCRECT

Pointer to a RECT structure that contains the position, in client coordinates, of the rectangle in which the text is drawn. The function draws the borders just inside the edges of the specified rectangle.

pszText

Type: LPCTSTR

Pointer to a null-terminated string that specifies the text to display. Tab characters in the string determine whether the string is left-aligned, right-aligned, or centered.

uFlags

Type: UINT

Text drawing flags. This parameter can be a combination of these values:

ValueMeaning
SBT_NOBORDERS

Prevents borders from being drawn around the specified text.

SBT_POPOUT

Draws highlighted borders that make the text stand out.

SBT_RTLREADING

Indicates that the string pointed to by pszText will be displayed in the opposite direction to the text in the parent window.

 

Return value

This function does not return a value.

Remarks

Normal windows display text left-to-right (LTR). Windows can be mirrored to display languages such as Hebrew or Arabic that read right-to-left (RTL). Normally, the pszText string will be displayed in the same direction as the text in its parent window. If SBT_RTLREADING is set, the pszText string will read in the opposite direction from the text in the parent window.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

Library

Comctl32.lib

DLL

Comctl32.dll

Unicode and ANSI names

DrawStatusTextW (Unicode) and DrawStatusTextA (ANSI)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft