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

Структура 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка commctrl.h