messaggio di SB_GETTEXTLENGTH

  • Articolo

Recupera la lunghezza, in caratteri, del testo dalla parte specificata di una finestra di stato.

Parametri

wParam

Indice in base zero della parte da cui recuperare il testo.

lParam

Deve essere zero.

Valore restituito

Restituisce un valore a 32 bit costituito da due valori a 16 bit. La parola bassa specifica la lunghezza, espressa in caratteri, del testo. La parola alta specifica il tipo di operazione utilizzata per disegnare il testo. Il tipo può essere uno dei valori seguenti:

Codice restituito Descrizione
0
 Il testo viene disegnato con un bordo da visualizzare inferiore al piano della finestra.
SBT_NOBORDERS
 Il testo viene disegnato senza bordi.
SBT_OWNERDRAW
 Il testo viene disegnato dalla finestra padre.
SBT_POPOUT
 Il testo viene disegnato con un bordo da visualizzare più alto del piano della finestra.
SBT_RTLREADING
 Il testo verrà visualizzato nella direzione opposta al testo nella finestra padre.

Commenti

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). Se SBT_RTLREADING è impostato, il testo della finestra di stato specificato leggerà nella direzione opposta dal testo nella finestra padre.

Questo messaggio restituisce una lunghezza massima di stringa di 65.535 caratteri. Se la stringa di testo effettiva è più lunga di quella, il messaggio SB_GETTEXT lo tronca.

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h
Nomi Unicode e ANSI
 SB_GETTEXTLENGTHW (Unicode) e SB_GETTEXTLENGTHA (ANSI)