Modifica dell'etichetta del controllo Tree
L'utente può modificare direttamente le etichette degli elementi in un controllo albero (CTreeCtrl) con lo stile TVS_EDITLABELS . L'utente inizia a modificare facendo clic sull'etichetta dell'elemento con lo stato attivo. Un'applicazione inizia la modifica usando la funzione membro EditLabel . Il controllo albero invia la notifica all'inizio della modifica e quando viene annullata o completata. Al termine della modifica, l'utente è responsabile dell'aggiornamento dell'etichetta dell'elemento, se appropriato.
All'inizio della modifica delle etichette, un controllo albero invia un messaggio di notifica TVN_BEGINLABELEDIT . Elaborando questa notifica, è possibile consentire la modifica di alcune etichette e impedire la modifica di altre. La restituzione di 0 consente la modifica e la restituzione di un valore diverso da zero ne impedisce la restituzione.
Quando la modifica delle etichette viene annullata o completata, un controllo albero invia un messaggio di notifica TVN_ENDLABELEDIT. Il parametro lParam è l'indirizzo di una struttura NMTVDISPINFO . Il membro dell'elemento è una struttura TVITEM che identifica l'elemento e include il testo modificato. L'utente è responsabile dell'aggiornamento dell'etichetta dell'elemento, se appropriato, ad esempio dopo la convalida della stringa modificata. Il membro pszText di TV_ITEM è 0 se la modifica viene annullata.
Durante la modifica delle etichette, in genere in risposta al messaggio di notifica TVN_BEGINLABELEDIT , è possibile ottenere un puntatore al controllo di modifica usato per la modifica delle etichette usando la funzione membro GetEditControl . È possibile chiamare la funzione membro SetLimitText del controllo di modifica per limitare la quantità di testo che un utente può immettere o sottoclassare il controllo di modifica per intercettare ed eliminare caratteri non validi. Si noti, tuttavia, che il controllo di modifica viene visualizzato solo dopol'invio di TVN_BEGINLABELEDIT .