macro TreeView_DeleteItem (commctrl.h)

Quita un elemento y todos sus elementos secundarios de un control de vista de árbol. También puede enviar el mensaje TVM_DELETEITEM explícitamente.

Sintaxis

BOOL TreeView_DeleteItem(
   HWND      hwnd,
   HTREEITEM hitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

hitem

Tipo: HTREEITEM

identificador de HTREEITEM al elemento que se va a eliminar. Si hitem está establecido en TVI_ROOT, todos los elementos se eliminan del control de vista de árbol. También puede usar la macro TreeView_DeleteAllItems para eliminar todos los elementos.

Valor devuelto

Tipo: BOOL de

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

Observaciones

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 del 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, vea TreeView_DeleteAllItems.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h