Поделиться через

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

  • Статья

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

Синтаксис

typedef struct tagTVINSERTSTRUCTW {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXW itemex;
    TV_ITEMW  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTW, *LPTVINSERTSTRUCTW;

Члены

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