Funzione DrawStatusTextA (commctrl.h)

Articolo
11/18/2024

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

Flag 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 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). Windows può essere con mirroring per visualizzare lingue come l'ebraico o l'arabo che leggono da destra a sinistra (RTL). In genere, la stringa di 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h
libreria	Comctl32.lib
dll	Comctl32.dll

Condividi tramite