messaggio WM_GETTEXT

Copia il testo corrispondente a una finestra in un buffer fornito dal chiamante.

#define WM_GETTEXT                      0x000D

Parametri

wParam

Numero massimo di caratteri da copiare, incluso il carattere null di terminazione.

Le applicazioni ANSI possono avere la stringa nel buffer ridotta di dimensioni (fino a un minimo di metà del valore wParam ) a causa della conversione da ANSI a Unicode.

lParam

Puntatore al buffer che deve ricevere il testo.

Valore restituito

Tipo: LRESULT

Il valore restituito è il numero di caratteri copiati, non incluso il carattere null terminante.

Commenti

La funzione DefWindowProc copia il testo associato alla finestra nel buffer specificato e restituisce il numero di caratteri copiati. Nota, per i controlli statici non di testo, il testo con cui è stato creato originariamente il controllo, ovvero il numero ID. Tuttavia, fornisce l'ID del controllo statico non di testo come originariamente creato. In questo caso, se successivamente è stato usato un STM_SETIMAGE per modificarlo, l'ID originale verrà comunque restituito.

Per un controllo di modifica, il testo da copiare è il contenuto del controllo di modifica. Per una casella combinata, il testo è il contenuto della parte di controllo di modifica (o testo statico) della casella combinata. Per un pulsante, il testo è il nome del pulsante. Per altre finestre, il testo è il titolo della finestra. Per copiare il testo di un elemento in una casella di riepilogo, un'applicazione può usare il messaggio di LB_GETTEXT .

Quando il messaggio WM_GETTEXT viene inviato a un controllo statico con lo stile SS_ICON , verrà restituito un handle all'icona nei primi quattro byte del buffer a cui punta lParam. Questo valore è true solo se il messaggio di WM_SETTEXT è stato usato per impostare l'icona.

Modifica avanzata: Se il testo da copiare supera 64K, usare il messaggio EM_STREAMOUT o EM_GETSELTEXT .

L'invio di un messaggio di WM_GETTEXT a un controllo statico non testuale, ad esempio un controllo bitmap statico o un'icona statica, non restituisce un valore stringa. Restituisce invece zero. Inoltre, nelle prime versioni di Windows, le applicazioni potrebbero inviare un messaggio WM_GETTEXT a un controllo statico non testuale per recuperare l'ID del controllo. Per recuperare l'ID di un controllo, le applicazioni possono usare GetWindowLong passando GWL_ID come valore di indice o GetWindowLongPtr usando GWLP_ID.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM_GETTEXTLENGTH

WM_SETTEXT

Informazioni concettuali

Windows

Altre risorse

EM_GETSELTEXT

EM_STREAMOUT

LB_GETTEXT