Структура TVINSERTSTRUCTA (commctrl.h)

  • Статья

Содержит сведения, используемые для добавления нового элемента в элемент управления в виде дерева. Эта структура используется с сообщением TVM_INSERTITEM . Структура идентична структуре TV_INSERTSTRUCT , но она была переименована в соответствии с текущими соглашениями об именовании.

Синтаксис

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

Члены

hParent

Тип: HTREEITEM

Дескриптор родительского элемента. Если этот элемент является TVI_ROOT значением или значением NULL, элемент вставляется в корне элемента управления представлением в виде дерева.

hInsertAfter

Тип: HTREEITEM

Дескриптор элемента, после которого необходимо вставить новый элемент, или одно из следующих значений:

Значение Значение
TVI_FIRST
 Вставляет элемент в начало списка.
TVI_LAST
 Вставляет элемент в конец списка.
TVI_ROOT
 Добавьте элемент в качестве корневого элемента.
TVI_SORT
 Вставляет элемент в список в алфавитном порядке.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

Тип: TVITEMEX

Версия 4.71. Структура TVITEMEX, содержащая сведения о добавляемом элементе.

DUMMYUNIONNAME.item

Тип: TVITEM

Структура TVITEM, содержащая сведения о добавляемом элементе.

Комментарии

Профсоюзы в этой структуре были обновлены для работы с компиляторами, которые не поддерживают безымяные объединения. Если компилятор не поддерживает безымяные объединения, определите токен NONAMELESSUNION перед включением файла заголовка commctrl.h.

Важно Использование TVI_LAST для вставки элемента в узел представления в виде дерева, который уже содержит большое количество элементов, может занять много времени, в результате чего приложение перестанет отвечать на запросы до завершения операции вставки.
 

Примечание

Заголовок commctrl.h определяет TVINSERTSTRUCT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h