commctrl.h

Macro ListView_GetEditControl

Obtiene el manipulador al control de edición que se está usando para editar el texto del ítem de un list-view. Se puede usar esta macro o enviar el mensaje LVM_GETEDITCONTROL explícitamente.

Definición

HWND ListView_GetEditControl(
     HWND hwndLV
);

Descripción

hwndLV
Un manipulador del control list-view.

Valor de retorno

Devuelve el manipulador del control de edición si tiene éxito, o NULL en caso contrario.

Observaciones

Cuando empieza la edición de etiqueta, se crea un control de edición, se posiciona e inicializa. Antes de que sea mostrado, el control list-view envía a su ventana padre un código de notificación LVN_BEGINLABELEDIT.

Para personalizar la edición de etiquetas, hay que implementar un manipulador para LVN_BEGINLABELEDIT y hacer que use ListView_GetEditControl para enviar un mensaje LVM_GETEDITCONTROL al control list-view. Si se está editando una etiqueta, el valor de retorno será un manipulador del control de edición. Usar este manipulador para personalizar el control de edición enviando los mensajes EM_XXX habituales.

Cuando el usuario completa o cancela la edición, el control de edición es destruido y el manipulador deja de ser válido. Se puede crear una subclase del control de edición, pero no se debe destruir. Para cancelar la edición se puede enviar al control list-view un mensaje WM_CANCELMODE.

El ítem del list-view que se está editando es el que tiene el foco actualmente—esto es, el ítem con el estado en el foco. Para encontrar un ítem basándose en su estado, usar el mensaje LVM_GETNEXTITEM.