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 |
|
Vedi anche
-
Riferimento
-
Informazioni concettuali
-
Altre risorse