Compartir a través de


mensaje de TVM_DELETEITEM

Quita un elemento y todos sus elementos secundarios de un control de vista de árbol. Puede enviar este mensaje explícitamente o mediante la macro TreeView_DeleteItem .

Parámetros

wParam

Debe ser cero.

lParam

Identificador HTREEITEM para el elemento que se va a eliminar. Si lParam está establecido en TVI_ROOT o en NULL, se eliminan todos los elementos. También puede usar la macro TreeView_DeleteAllItems para eliminar todos los elementos.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Comentarios

No es seguro eliminar elementos en respuesta a una notificación como TVN_SELCHANGING.

Una vez eliminado un elemento, su identificador no es válido y no se puede usar.

La ventana primaria recibe un código de notificación TVN_DELETEITEM cuando se quita cada elemento.

Si se está editando la etiqueta de elemento, se cancela la operación de edición y la ventana primaria recibe el código de notificación TVN_ENDLABELEDIT .

Si elimina todos los elementos de un control de vista de árbol que tiene el estilo TVS_NOSCROLL , es posible que los elementos agregados posteriormente no se muestren correctamente. Para obtener más información, consulte TreeView_DeleteAllItems.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Commctrl.h