Compartir a través de


Edición de etiquetas de control de árbol

El usuario puede editar directamente las etiquetas de los elementos de un control de árbol (CTreeCtrl) que tenga el estilo TVS_EDITLABELS. El usuario comienza a editar al hacer clic en la etiqueta del elemento que tiene el foco. Una aplicación comienza a editarse mediante la función miembro EditLabel. El control de árbol envía la notificación cuando se inicia la edición y cuando se cancela o se completa. Cuando se completa la edición, usted es responsable de actualizar la etiqueta del elemento, si procede.

Cuando se inicia la edición de etiquetas, un control de árbol envía un mensaje de notificación TVN_BEGINLABELEDIT. Al procesar esta notificación, puede permitir la edición de algunas etiquetas y evitar la edición de otras. Si se devuelve 0 se permite editar y si se devuelve un valor distinto de cero lo impide.

Cuando se cancela o completa la edición de etiquetas, un control de árbol envía un mensaje de notificación TVN_ENDLABELEDIT. El parámetro lParam es la dirección de una estructura NMTVDISPINFO. El miembro item es una estructura TVITEM que identifica el elemento e incluye el texto editado. Usted es responsable de actualizar la etiqueta del elemento, si procede, quizás después de validar la cadena editada. El miembro pszText de TV_ITEM es 0 si se cancela la edición.

Durante la edición de etiquetas, normalmente en respuesta al mensaje de notificación de TVN_BEGINLABELEDIT, puede obtener un puntero al control de edición que se usa para la edición de etiquetas mediante la función miembro GetEditControl. Puede llamar a la función miembro SetLimitText del control de edición para limitar la cantidad de texto que un usuario puede escribir o subclase en el control de edición para interceptar y descartar los caracteres no válidos. Sin embargo, tenga en cuenta que el control de edición solo se muestra después de enviar TVN_BEGINLABELEDIT.

Consulte también

Uso de CTreeCtrl
Controles