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.

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

Vedi anche

SB_SETTEXT