Структура 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
Значение, указывающее, какие элементы необходимо получить или задать. Этот элемент может быть сочетанием следующих значений:
Ценность | Значение |
---|---|
|
Допустимый элемент iImage. |
|
Допустимый элемент lParam. |
|
Строка, на которую указывает pszText, будет отображаться в направлении, противоположном тексту в родительском окне. |
|
версии 4.70. Допустимый элемент dwState |
|
Допустимый элемент pszText. |
dwState
Тип: DWORD
версии 4.70. Указывает текущее состояние элемента, если извлекается информация. Если заданы сведения об элементе, этот элемент содержит значение состояния, которое нужно задать для элемента. Список допустимых состояний элемента управления вкладками см. в разделе Состояния элементов управления вкладками. Этот элемент игнорируется в сообщении TCM_INSERTITEM.
dwStateMask
Тип: DWORD
версии 4.70. Указывает, какие биты элемента dwStat e
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 |