messaggio SB_GETTEXT
Recupera il testo dalla parte specificata di una finestra di stato.
Parametri
-
wParam
-
Indice in base zero della parte da cui recuperare il testo.
-
lParam
-
Puntatore al buffer che riceve il testo come stringa con terminazione Null. Usare il messaggio SB_GETTEXTLENGTH per determinare le dimensioni necessarie del buffer.
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 |
|---|---|
|
Il testo viene disegnato con un bordo da visualizzare inferiore al piano della finestra. |
|
Il testo viene disegnato senza bordi. |
|
Il testo viene disegnato con un bordo da visualizzare più alto del piano della finestra. |
|
Il testo viene visualizzato nella direzione opposta del testo nella finestra padre. |
Commenti
Avviso di sicurezza: L'uso di questo messaggio in modo non corretto può compromettere la sicurezza del programma. Questo messaggio non consente di conoscere le dimensioni del buffer. Se si usa questo messaggio, chiamare prima SB_GETTEXTLENGTH per ottenere il numero di caratteri necessari e quindi chiamare il messaggio per recuperare la stringa. Se si attende prima di chiamare SB_GETTEXT il testo potrebbe cambiare, invalidando così il valore restituito di SB_GETTEXTLENGTH. Prima di continuare, esaminare le considerazioni sulla sicurezza: Controlli di Microsoft Windows .
Questo messaggio restituisce un massimo di 65.535 caratteri. Se la stringa di testo è più lunga di quella, viene troncata.
Se il testo ha il tipo di disegno SBT_OWNERDRAW, questo messaggio restituisce il valore a 32 bit associato al testo anziché alla lunghezza e al tipo di operazione.
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, la stringa lParam legge nella direzione opposta dal testo nella finestra padre.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Intestazione |
|
| Nomi Unicode e ANSI |
SB_GETTEXTW (Unicode) e SB_GETTEXTA (ANSI) |