Estructura TVINSERTSTRUCTA (commctrl.h)

  • Artículo

Contiene información utilizada para agregar un nuevo elemento a un control de vista de árbol. Esta estructura se usa con el mensaje TVM_INSERTITEM . La estructura es idéntica a la estructura de TV_INSERTSTRUCT , pero se ha cambiado el nombre para seguir las convenciones de nomenclatura actuales.

Sintaxis

typedef struct tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

Miembros

hParent

Tipo: HTREEITEM

Identificador del elemento primario. Si este miembro es el valor TVI_ROOT o NULL, el elemento se inserta en la raíz del control de vista de árbol.

hInsertAfter

Tipo: HTREEITEM

Controle al elemento después del cual se va a insertar el nuevo elemento o uno de los siguientes valores:

Valor Significado
TVI_FIRST
 Inserta el elemento al principio de la lista.
TVI_LAST
 Inserta el elemento al final de la lista.
TVI_ROOT
 Agregue el elemento como elemento raíz.
TVI_SORT
 Inserta el elemento en la lista en orden alfabético.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

Tipo: TVITEMEX

Versión 4.71. Estructura TVITEMEX que contiene información sobre el elemento que se va a agregar.

DUMMYUNIONNAME.item

Tipo: TVITEM

Estructura TVITEM que contiene información sobre el elemento que se va a agregar.

Comentarios

Las uniones de esta estructura se han actualizado para trabajar con compiladores que no admiten uniones sin nombre. Si el compilador no admite uniones sin nombre, defina el token NONAMELESSUNION antes de incluir el archivo de encabezado commctrl.h.

Importante El uso de TVI_LAST para insertar un elemento en un nodo de vista de árbol que ya contiene un gran número de elementos puede tardar mucho tiempo, lo que hace que la aplicación deje de responder hasta que se complete la operación de inserción.
 

Nota

El encabezado commctrl.h define TVINSERTSTRUCT como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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