macro TreeView_EditLabel (commctrl.h)

Inizia la modifica sul posto del testo dell'elemento specificato, sostituendo il testo dell'elemento con un controllo di modifica a riga singola contenente il testo. Questa macro seleziona in modo implicito e concentra l'elemento specificato. È possibile utilizzare questa macro o inviare il messaggio di TVM_EDITLABEL in modo esplicito.

Sintassi

HWND TreeView_EditLabel(
   HWND      hwnd,
   HTREEITEM hitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione albero.

hitem

Tipo: HTREEITEM

Handle per l'elemento da modificare.

Valore restituito

Tipo: HWND

Restituisce l'handle al controllo di modifica utilizzato per modificare il testo dell'elemento in caso di esito positivo oppure NULL in caso contrario.

Osservazioni

Questa macro invia un codice di notifica TVN_BEGINLABELEDIT all'elemento padre del controllo visualizzazione albero.

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.

Il controllo deve avere lo stato attivo prima di chiamare questa macro. Lo stato attivo può essere impostato usando la funzione SetFocus .

Fabbisogno