macro TreeView_DeleteAllItems (commctrl.h)

Elimina todos los elementos de un control de vista de árbol.

Sintaxis

BOOL TreeView_DeleteAllItems(
   HWND hwnd
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

Valor devuelto

Tipo: BOOL de

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

Observaciones

Una vez que se elimina un elemento de un control de vista de árbol, su identificador de HTREEITEM 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.

También puede eliminar todos los elementos con la macro TreeView_DeleteItem o el mensaje de TVM_DELETEITEM estableciendo lParam en TVI_ROOT.

Si el estilo de ventana de un control de vista de árbol contiene TVS_NOSCROLL y se eliminan todos los elementos, los nuevos elementos no se muestran hasta que se restablecen los estilos de ventana. El código siguiente muestra una manera de asegurarse de que los elementos siempre se muestran.

DWORD styles = GetWindowLong(hwnd, GWL_STYLE);
TreeView_DeleteAllItems(hwnd);
SetWindowLong(hwnd, GWL_STYLE, styles);

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