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

  • Статья

Содержит сведения о столбце в представлении отчета. Эта структура используется как для создания столбцов, так и для управления ими. Эта структура заменяет структуру LV_COLUMN.

Синтаксис

typedef struct tagLVCOLUMNA {
  UINT  mask;
  int   fmt;
  int   cx;
  LPSTR pszText;
  int   cchTextMax;
  int   iSubItem;
  int   iImage;
  int   iOrder;
  int   cxMin;
  int   cxDefault;
  int   cxIdeal;
} LVCOLUMNA, *LPLVCOLUMNA;

Члены

mask

Тип: UINT

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

Значение Значение
LVCF_FMT
 Член fmt является допустимым.
LVCF_WIDTH
 Член cx является допустимым.
LVCF_TEXT
 Член pszText является допустимым.
LVCF_SUBITEM
 Допустимый член iSubItem .
LVCF_IMAGE

Версия 4.70. Допустимый член iImage .
LVCF_ORDER

Версия 4.70. Допустимый член iOrder .
LVCF_MINWIDTH

Версия 6.00 и Windows Vista.Допустимый член cxMin .
LVCF_DEFAULTWIDTH

Версия 6.00 и Windows Vista.Допустимый член cxDefault .
LVCF_IDEALWIDTH

Версия 6.00 и Windows Vista.Допустимый член cxIdeal .

fmt

Тип: int

Выравнивание заголовка столбца и текста подэлемента в столбце. Выравнивание крайнего левого столбца всегда LVCFMT_LEFT; его нельзя изменить. Этот элемент может быть сочетанием следующих значений. Обратите внимание, что не все сочетания допустимы.

Значение Значение
LVCFMT_LEFT
 Текст выравнивается по левому краю.
LVCFMT_RIGHT
 Текст выравнивается по правому краю.
LVCFMT_CENTER
 Текст выравнивается по центру.
LVCFMT_JUSTIFYMASK
 Битовая маска, используемая для выбора битов fmt , которые управляют обоснованием поля. Чтобы проверка формат столбца, используйте логический "и" для объединения LCFMT_JUSTIFYMASK с fmt. Затем можно использовать оператор switch, чтобы определить, заданы ли биты LVCFMT_LEFT, LVCFMT_RIGHT или LVCFMT_CENTER.
LVCFMT_IMAGE

Версия 4.70. Элемент отображает изображение из списка изображений.
LVCFMT_BITMAP_ON_RIGHT

Версия 4.70. Растровое изображение отображается справа от текста. Это не влияет на изображение из списка изображений, назначенного элементу заголовка.
LVCFMT_COL_HAS_IMAGES

Версия 4.70. Элемент заголовка содержит изображение в списке изображений.
LVCFMT_FIXED_WIDTH

Версия 6.00 и Windows Vista. Не удается изменить размер столбца; то же, что и HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

Версия 6.00 и Windows Vista. Если значение не задано, CCM_DPISCALE будет управлять масштабированием фиксированной ширины.
LVCFMT_FIXED_RATIO

Версия 6.00 и Windows Vista. Ширина увеличивается вместе с высотой строки.
LVCFMT_SPLITBUTTON

Версия 6.00 и Windows Vista. Столбец — это кнопка разделения (то же, что и HDF_SPLITBUTTON). В заголовке столбца отображается кнопка разделения (то же, что и HDF_SPLITBUTTON).

cx

Тип: int

Ширина столбца в пикселях.

pszText

Тип: LPTSTR

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

cchTextMax

Тип: int

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

iSubItem

Тип: int

Индекс подэлемента, связанного со столбцом.

iImage

Тип: int

Версия 4.70. Отсчитываемый от нуля индекс изображения в списке образов. Указанное изображение будет отображаться в столбце .

iOrder

Тип: int

Версия 4.70. Смещение столбца от нуля. Смещение столбца находится в порядке слева направо. Например, нуль обозначает самый левый столбец.

cxMin

Тип: int

Windows Vista. Минимальная ширина столбца в пикселях.

cxDefault

Тип: int

Windows Vista. Определяемое приложением значение обычно используется для хранения ширины столбца по умолчанию. Этот элемент игнорируется элементом управления представлением списка.

cxIdeal

Тип: int

Windows Vista. Только для чтения. Идеальная ширина столбца в пикселях, так как в настоящее время столбец может быть автоматически изменен на меньшую ширину.

Комментарии

Если столбец добавляется в элемент управления представлением списка с индексом 0 (крайний левый столбец), он всегда LVCFMT_LEFT. Установка других флагов для столбца 0 не переопределяет это выравнивание. Поэтому при вставке столбцов с индексом 0 текст во всех столбцах выравнивается по левому краю. Если вы хотите, чтобы первый столбец был выровнен по правому краю или по центру, можно сделать фиктивный столбец, а затем вставить один или несколько столбцов с индексом 1 или выше и указать необходимое выравнивание. Наконец, удалите фиктивный столбец.

Примечание

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

Требования

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

См. также раздел

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Справочные материалы