Funzione DrawStatusTextA (commctrl.h)

La funzione DrawStatusText disegna il testo specificato nello stile di una finestra di stato con bordi.

Sintassi

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  pszText,
  UINT    uFlags
);

Parametri

hDC

Tipo: HDC

Handle per il contesto di visualizzazione per la finestra.

lprc

Tipo: LPCRECT

Puntatore a una struttura RECT che contiene la posizione, nelle coordinate client, del rettangolo in cui viene disegnato il testo. La funzione disegna i bordi all'interno dei bordi del rettangolo specificato.

pszText

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che specifica il testo da visualizzare. I caratteri di tabulazioni nella stringa determinano se la stringa è allineata a sinistra, allineata a destra o allineata al centro.

uFlags

Tipo: UINT

Contrassegni di disegno di testo. Questo parametro può essere una combinazione di questi valori:

Valore Significato
SBT_NOBORDERS
Impedisce che i bordi vengano disegnati intorno al testo specificato.
SBT_POPOUT
Disegna i bordi evidenziati che fanno risaltare il testo.
SBT_RTLREADING
Indica che la stringa a cui punta pszText verrà visualizzata nella direzione opposta al testo nella finestra padre.

Valore restituito

nessuno

Osservazioni

Le finestre normali visualizzano testo da sinistra a destra (LTR). È possibile eseguire il mirroring di Windows per visualizzare lingue come l'ebraico o l'arabo che leggono da destra a sinistra (RTL). In genere, la stringa pszText verrà visualizzata nella stessa direzione del testo nella finestra padre. Se SBT_RTLREADING è impostato, la stringa pszText leggerà nella direzione opposta dal testo nella finestra padre.

Nota

L'intestazione commctrl.h definisce DrawStatusText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione commctrl.h
Libreria Comctl32.lib
DLL Comctl32.dll