messaggio EM_GETHANDLE

Ottiene un handle della memoria attualmente allocata per il testo di un controllo di modifica su più righe.

Parametri

wParam

Non utilizzato; deve essere zero.

lParam

Non utilizzato; deve essere zero.

Valore restituito

Il valore restituito è un handle di memoria che identifica il buffer che contiene il contenuto del controllo di modifica. Se si verifica un errore, ad esempio l'invio del messaggio a un controllo di modifica a riga singola, il valore restituito è zero.

Commenti

Se la funzione ha esito positivo, l'applicazione può accedere al contenuto del controllo di modifica eseguendo il cast del valore restituito in HLOCAL e passandolo a LocalLock. LocalLock restituisce un puntatore a un buffer che è una matrice con terminazione Null di CHARs o WCHARs, a seconda che sia stata creata una funzione ANSI o Unicode. Ad esempio, se è stato usato CreateWindowExA il buffer è una matrice di CHARs, ma se CreateWindowExW è stato usato il buffer è una matrice di WCHARs. L'applicazione potrebbe non modificare il contenuto del buffer. Per sbloccare il buffer, l'applicazione chiama LocalUnlock prima di consentire al controllo di modifica di ricevere nuovi messaggi.

Nota

Per Comctl32.dll versione 6, il buffer contiene sempre una matrice di WCHARs, indipendentemente dal fatto che una funzione ANSI o Unicode abbia creato il controllo di modifica. Per altre informazioni sulle versioni dll, vedere Versioni di controllo comuni.

Se l'applicazione non può rispettare le restrizioni imposte da EM_GETHANDLE, usare le funzioni GetWindowTextLength e GetWindowText per copiare il contenuto del controllo di modifica in un buffer fornito dall'applicazione.

Rich Edit:Rich Edit: Il messaggio EM_GETHANDLE non è supportato. I controlli rich edit non archiviano il testo come una semplice matrice di caratteri.

Requisiti

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

Vedi anche

Riferimento

EM_SETHANDLE

Altre risorse

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock