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

Структура 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.допустимый элемент cx Min cxMin.
LVCF_DEFAULTWIDTH

версии 6.00 и Windows Vista.допустимый элемент cxDefa ult .
LVCF_IDEALWIDTH

версии 6.00 и Windows Vista.допустимый элемент cxIde al .

fmt

Тип: int

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

Ценность Значение
LVCFMT_LEFT
 Текст выровнен по левому краю.
LVCFMT_RIGHT
 Текст выровнен по правому краю.
LVCFMT_CENTER
 Текст по центру.
LVCFMT_JUSTIFYMASK
 Битовая маска, используемая для выбора этих битов fmt обоснование поля управления. Чтобы проверить формат столбца, используйте логический "and" для объединения 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

Справочник