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

  • Статья

Содержит сведения об элементе в элементе управления заголовком. Эта структура заменяет структуру HD_ITEM .

Синтаксис

typedef struct _HD_ITEMA {
  UINT    mask;
  int     cxy;
  LPSTR   pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMA, *LPHDITEMA;

Члены

mask

Тип: UINT

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

Значение Значение
HDI_BITMAP
 Член hbm является допустимым .
HDI_DI_SETITEM
 При обработке HDM_GETITEM сообщения элемент управления заголовком может содержать не все значения, необходимые для выполнения запроса. В этом случае элемент управления должен вызвать приложение для получения значений через уведомление HDN_GETDISPINFO . Если HDI_DI_SETITEM передано в HDM_GETITEM сообщении, элемент управления будет кэшировать все значения, возвращаемые из HDN_GETDISPINFO (в противном случае значения останутся ненастроенными).
HDI_FORMAT
 Элемент fmt является допустимым.
HDI_FILTER
 Допустимы члены type и pvFilter . Используется для фильтрации значений, указанных в элементе типа .
HDI_HEIGHT
 То же, что и HDI_WIDTH.
HDI_IMAGE
 Элемент iImage является допустимым и указывает изображение, отображаемое вместе с элементом.
HDI_LPARAM
 Допустимый элемент lParam .
HDI_ORDER
 Элемент iOrder является допустимым и указывает значение порядка элемента.
HDI_STATE

Версия 6.00 и более поздняя. Член состояния является допустимым.
HDI_TEXT
 Допустимы члены pszText и cchTextMax .
HDI_WIDTH
 Элемент cxy является допустимым и указывает ширину элемента.

cxy

Тип: int

Ширина или высота элемента.

pszText

Тип: LPTSTR

Указатель на строку элемента. Если текст извлекается из элемента управления, этот элемент должен быть инициализирован, чтобы указать на буфер символов. Если для этого элемента задано значение LPSTR_TEXTCALLBACK, элемент управления запрашивает текстовые сведения для этого элемента, отправляя HDN_GETDISPINFO код уведомления. Обратите внимание, что хотя элемент управления "Заголовок" позволяет хранить строку любой длины в виде текста элемента, отображаются только первые 260 TCHAR.

hbm

Тип: HBITMAP

Дескриптор растрового изображения элемента.

cchTextMax

Тип: int

Длина строки элемента в значениях TCHAR. Если текст извлекается из элемента управления, этот элемент должен содержать количество TCHARпо адресу , указанному в pszText.

fmt

Тип: int

Флаги, указывающие формат элемента.

Значение Значение
Текстовое обоснование:
 Установите один из следующих флагов, чтобы указать текстовое обоснование:
HDF_CENTER
 Содержимое элемента по центру.
HDF_LEFT
 Содержимое элемента выравнивается по левому краю.
HDF_RIGHT
 Содержимое элемента выравнивается по правому краю.
Отобразить:
 Установите один из следующих флагов для управления отображением:
HDF_BITMAP
 Элемент отображает растровое изображение.
HDF_BITMAP_ON_RIGHT
 Растровое изображение отображается справа от текста.
HDF_OWNERDRAW
 Владелец элемента управления заголовком рисует элемент .
HDF_STRING
 Элемент отображает строку.
Объединение флагов:
 Предыдущее значение можно объединить с:
HDF_IMAGE
 Отображение изображения из списка изображений. Укажите список изображений, отправив HDM_SETIMAGELIST сообщение. Укажите индекс изображения в элементе iImage этой структуры.
HDF_JUSTIFYMASK
 Изолируйте биты, соответствующие трем флагам обоснования, перечисленным в предыдущей таблице.
HDF_RTLREADING
 Как правило, в окнах отображается текст слева направо (LTR). Windows можно зеркально отображать на таких языках, как иврит или арабский язык, которые читают справа налево (RTL). Обычно текст заголовка считывается в том же направлении, что и текст в родительском окне. Если задано HDF_RTLREADING, текст заголовка будет считываться в направлении, противоположном тексту в родительском окне.
HDF_SORTDOWN

Версия 6.00 и более поздняя. Рисует на этом элементе стрелку вниз. Обычно используется, чтобы указать, что сведения в текущем окне сортируются по этому столбцу в порядке убывания. Этот флаг нельзя сочетать с HDF_IMAGE или HDF_BITMAP.
HDF_SORTUP

Версия 6.00 и более поздняя. Рисует на этом элементе стрелку вверх. Обычно используется, чтобы указать, что сведения в текущем окне сортируются по этому столбцу в порядке возрастания. Этот флаг нельзя сочетать с HDF_IMAGE или HDF_BITMAP.
HDF_CHECKBOX

Версия 6.00 и более поздняя. Элемент отображает флажок. Флаг действителен, только если стиль HDS_CHECKBOXES впервые задан в элементе управления "Заголовок".
HDF_CHECKED

Версия 6.00 и более поздняя. Для элемента отображается флажок. Флаг действителен, только если также задан HDF_CHECKBOX.
HDF_FIXEDWIDTH

Версия 6.00 и более поздняя. Ширина элемента не может быть изменена действием пользователя, чтобы изменить его размер.
HDF_SPLITBUTTON

Версия 6.00 и более поздняя. Элемент отображает кнопку разделения. Уведомление HDN_DROPDOWN отправляется при нажатии кнопки разделения.

lParam

Тип: LPARAM

Данные элементов, определяемых приложением.

iImage

Тип: int

Отсчитываемый от нуля индекс изображения в списке изображений. Указанное изображение будет отображаться в элементе заголовка в дополнение к любому изображению, указанному в поле hbm . Если для iImage задано значение I_IMAGECALLBACK, элемент управления запрашивает текстовые сведения для этого элемента с помощью HDN_GETDISPINFO кода уведомления. Чтобы очистить изображение, присвойте этому значению значение I_IMAGENONE.

iOrder

Тип: int

Порядок, в котором элемент отображается в элементе управления заголовком слева направо. То есть значение для крайнего левого элемента равно 0. Значение для следующего элемента справа равно 1 и т. д.

type

Тип: UINT

Тип фильтра, заданный параметром pvFilter. Возможные типы:

Значение Значение
HDFT_ISSTRING
 Строковые данные.
HDFT_ISNUMBER
 Числовые данные.
HDFT_HASNOVALUE
 Пропустить pvFilter.
HDFT_ISDATE

Версия 6.00 и более поздняя. Данные даты. Элемент pvFilter является указателем на структуру SYSTEMTIME .

pvFilter

Тип: void*

Адрес элемента данных, определяемого приложением. Тип фильтра данных определяется путем установки значения флага элемента. Используйте флаг HDFT_ISSTRING для указания строки и HDFT_ISNUMBER для указания целого числа. При использовании флага HDFT_ISSTRING pvFilter является указателем на структуру HDTEXTFILTER .

state

Тип: UINT

Состояние. Единственное допустимое поддерживаемое значение для этого элемента:

Значение Значение
HDIS_FOCUSED
 Элемент имеет фокус клавиатуры.

Комментарии

Обратите внимание Comctl32.dll версия 6 не является распространяемой, но включена в Windows. Чтобы использовать Comctl32.dll версии 6, укажите его в манифесте. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.
 

Примечание

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

Требования

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