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

  • Статья

Задает или получает атрибуты вкладки. Он используется с TCM_INSERTITEM, TCM_GETITEM и TCM_SETITEM сообщениями. Эта структура заменяет структуру TC_ITEMHEADER .

Синтаксис

typedef struct tagTCITEMHEADERA {
  UINT  mask;
  UINT  lpReserved1;
  UINT  lpReserved2;
  LPSTR pszText;
  int   cchTextMax;
  int   iImage;
} TCITEMHEADERA, *LPTCITEMHEADERA;

Члены

mask

Тип: UINT

Значение , указывающее, какие элементы следует извлечь или задать. Этот элемент может быть сочетанием следующих значений:

Значение Значение
TCIF_IMAGE
 Допустимый элемент iImage .
TCIF_RTLREADING
 Строка, на которую указывает pszText , будет отображаться в направлении, противоположном тексту в родительском окне.
TCIF_TEXT
 Допустимый элемент pszText .

lpReserved1

Тип: UINT

Зарезервированный элемент. Не используйте.

lpReserved2

Тип: UINT

Зарезервированный элемент. Не используйте.

pszText

Тип: LPTSTR

Адрес строки, заканчивающейся значением NULL, которая содержит текст табуляции, если задана информация об элементе. При извлечении сведений об элементе этот элемент указывает адрес буфера, который получает текст табуляции.

cchTextMax

Тип: int

Размер буфера, на который указывает элемент pszText. Если структура не получает информацию, этот элемент игнорируется.

iImage

Тип: int

Индекс в списке изображений элемента управления вкладкой или значение -1, если для вкладки нет изображения.

Комментарии

Как правило, в окнах отображается текст слева направо (LTR). Windows можно зеркально отображать на таких языках, как иврит или арабский язык, которые читают справа налево (RTL). Как правило, pszText будет отображаться в том же направлении, что и текст в родительском окне. Если задано TCIF_RTLREADING, pszText будет считывать в направлении, противоположном тексту в родительском окне.

Примечание

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

Требования

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