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

  • Статья

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

Синтаксис

typedef struct tagTCITEMA {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPSTR  pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMA, *LPTCITEMA;

Члены

mask

Тип: UINT

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

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

Версия 4.70. Член dwState является допустимым .
TCIF_TEXT
 Допустимый элемент pszText .

dwState

Тип: DWORD

Версия 4.70. Указывает текущее состояние элемента, если извлекается информация. Если задана информация об элементе, этот элемент содержит значение состояния, которое будет задано для элемента. Список допустимых состояний элементов элемента управления вкладкой см. в разделе Состояния элементов элемента управления вкладкой. Этот элемент игнорируется в сообщении TCM_INSERTITEM .

dwStateMask

Тип: DWORD

Версия 4.70. Указывает, какие биты элемента dwState содержат допустимые сведения. Этот элемент игнорируется в сообщении TCM_INSERTITEM .

pszText

Тип: LPTSTR

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

cchTextMax

Тип: int

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

iImage

Тип: int

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

lParam

Тип: LPARAM

Определяемые приложением данные, связанные с элементом управления вкладкой. Если на одну вкладку существует более 4 байт данных, определяемых приложением, приложение должно определить структуру и использовать ее вместо структуры TCITEM . Первым элементом определяемой приложением структуры должна быть структура TCITEMHEADER .

Комментарии

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

Примечание

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

Требования

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