Метод IHeaderCtrl::InsertColumn (mmc.h)

Статья
08/24/2023

Добавляет столбец в область результатов по умолчанию.

Синтаксис

HRESULT InsertColumn(
  [in] int     nCol,
  [in] LPCWSTR title,
  [in] int     nFormat,
  [in] int     nWidth
);

Параметры

[in] nCol

Отсчитываемый от нуля индекс вставляемого столбца.

[in] title

Значение типа , указывающее строку, представляющую заголовок вставляемого столбца. Эта строка может иметь максимальную длину MAX_PATH символов.

[in] nFormat

Значение типа , указывающее положение текста в столбце. Для нулевого столбца значение nFormat должно быть LVCFMT_LEFT. Это значение должно иметь одно из следующих значений:

LVCFMT_LEFT

Текст выравнивается по левому краю.

LVCFMT_CENTER

Текст выравнивается по центру.

LVCFMT_RIGHT

Текст выравнивается по правому краю.

Примечание Чтобы использовать константы LVCFMT_* , включите CommCtrl.h в исходный файл.

[in] nWidth

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

MMCLV_AUTO

MMC автоматически определяет ширину столбца на основе строки заголовка.

HIDE_COLUMN

Представлено в MMC 1.2. Столбец вставлен, но скрыт. Имейте в виду, что пользователь может сделать столбец видимым при настройке представления списка.

Для оснастки, встроенные с помощью пакета SDK MMC 1.2, но загруженные в более старой версии MMC, HIDE_COLUMN интерпретируется как нулевой ширины. Пользователь может расширить столбец, перетаскивая его с помощью мыши.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

MMC не сохраняет в памяти изменения, внесенные в набор столбцов из-за действия IHeaderCtrl::InsertColumn, поэтому оснастки должны обновлять сохраненные данные конфигурации столбцов после вставки столбцов в набор столбцов. Дополнительные сведения см. в разделах IHeaderCtrl2 и Column Persistence .

Примечания к вызывающим абонентам

Вызовы InsertColumn завершаются ошибкой , если какие-либо элементы уже были вставлены в представление результатов.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	mmc.h
DLL	Mmcndmgr.dll

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

IHeaderCtrl

IHeaderCtrl2 и сохраняемость столбцов

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