macro ListView_GetEditControl (commctrl.h)

Ottiene l'handle del controllo di modifica utilizzato per modificare il testo di un elemento della visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_GETEDITCONTROL in modo esplicito.

Sintassi

HWND ListView_GetEditControl(
   HWND hwndLV
);

Parametri

hwndLV

Tipo: HWND

Handle per il controllo visualizzazione elenco.

Valore restituito

Tipo: HWND

Restituisce l'handle al controllo di modifica se ha esito positivo o NULL in caso contrario.

Osservazioni

All'inizio della modifica delle etichette, viene creato, posizionato e inizializzato un controllo di modifica. Prima che venga visualizzato, il controllo visualizzazione elenco invia alla finestra padre un codice di notifica LVN_BEGINLABELEDIT.

Per personalizzare la modifica delle etichette, implementare un gestore per LVN_BEGINLABELEDIT e usarlo ListView_GetEditControl per inviare un messaggio LVM_GETEDITCONTROL al controllo visualizzazione elenco. Se viene modificata un'etichetta, il valore restituito sarà un handle per il controllo di modifica. Utilizzare questo handle per personalizzare il controllo di modifica inviando i normali messaggi di EM_XXX.

Quando l'utente completa o annulla la modifica, il controllo di modifica viene eliminato definitivamente e l'handle non è più valido. È possibile sottoclassare il controllo di modifica, ma non eliminarlo definitivamente. Per annullare la modifica, è possibile inviare il controllo visualizzazione elenco a un messaggio WM_CANCELMODE.

L'elemento della visualizzazione elenco da modificare è l'elemento attualmente attivo, ovvero l'elemento nello stato attivo. Per trovare un elemento in base al relativo stato, usare il messaggio LVM_GETNEXTITEM.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commctrl.h

Vedere anche

LVM_GETEDITCONTROL