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

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

  • Статья

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

Синтаксис

typedef struct tagTCITEMW {
  UINT   mask;
  DWORD  dwState;
  DWORD  dwStateMask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEMW, *LPTCITEMW;

Члены

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