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

Статья
11/18/2024

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

Синтаксис

typedef struct _HD_ITEMW {
  UINT    mask;
  int     cxy;
  LPWSTR  pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMW, *LPHDITEMW;

Члены

mask

Тип: UINT

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

Ценность	Значение
HDI_BITMAP	Допустимый элемент hbm.
HDI_DI_SETITEM	При обработке сообщения HDM_GETITEMэлемент управления заголовком может не иметь всех значений, необходимых для выполнения запроса. В этом случае элемент управления должен вызвать приложение обратно для значений с помощью уведомления HDN_GETDISPINFO. Если HDI_DI_SETITEM переданы в сообщении HDM_GETITEM, элемент управления кэширует все значения, возвращаемые из HDN_GETDISPINFO (в противном случае значения остаются неустановленными.)
HDI_FORMAT	Допустимый элемент fmt.
HDI_FILTER	Допустимы тип и pvFilter элементов. Используется для фильтрации значений, указанных в элементе типа .
HDI_HEIGHT	То же, что и HDI_WIDTH.
HDI_IMAGE	Элемент iImage является допустимым и указывает изображение, отображаемое элементом.
HDI_LPARAM	Допустимый элемент lParam.
HDI_ORDER	Элемент iOrder действителен и задает значение порядка элемента.
HDI_STATE	версии 6.00 и более поздних версий. Допустимый элемент состояния .
HDI_TEXT	Допустимые элементы pszText и cchText Max.
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

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

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

Синтаксис

Члены

Замечания

Требования

Обратная связь

Дополнительные ресурсы