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


Структура 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. Указывает, какие биты элемента dwStat e содержат допустимые сведения. Этот элемент игнорируется в сообщении TCM_INSERTITEM.

pszText

Тип: LPTSTR

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

cchTextMax

Тип: int

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

iImage

Тип: int

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

lParam

Тип: LPARAM

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

Замечания

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

Заметка

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

Требования

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