IHeaderCtrl：：InsertColumn 方法 (mmc.h)

项目
02/29/2024

将列添加到默认结果窗格。

语法

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

参数

[in] nCol

要插入的列的从零开始的索引。

[in] title

一个值，该值指定表示要插入的列标题的字符串。此字符串的最大长度可以为 MAX_PATH 个字符。

[in] nFormat

一个值，该值指定文本在列中的位置。对于第 0 列，必须LVCFMT_LEFTnFormat。此值必须为下列值之一：

LVCFMT_LEFT

文本左对齐。

LVCFMT_CENTER

文本居中对齐。

LVCFMT_RIGHT

文本右对齐。

注意若要使用 LVCFMT_* 常量，请在源文件中包含 CommCtrl.h。

[in] nWidth

一个值，该值指定列的宽度（以像素为单位）。此值必须为下列值之一：

MMCLV_AUTO

MMC 根据标题字符串自动确定列的宽度。

HIDE_COLUMN

在 MMC 1.2 中引入。该列已插入，但已隐藏。请注意，用户可以在自定义列表视图时使列可见。

对于使用 MMC 1.2 SDK 生成的但加载在旧版 MMC 中的管理单元， HIDE_COLUMN 解释为零宽度。用户可以通过用鼠标拖动列来扩大列。

返回值

此方法可以返回其中一个值。

注解

由于 IHeaderCtrl：：InsertColumn 的操作，MMC 不会保留在内存中对列集所做的任何更改，因此在将列插入列集后，管理单元必须更新持久化列配置数据。有关详细信息，请参阅 IHeaderCtrl2 和 Column Persistence 。

给调用方的说明

如果已将任何项插入到结果视图中，则调用 InsertColumn 将失败。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	mmc.h
DLL	Mmcndmgr.dll

另请参阅

IHeaderCtrl

IHeaderCtrl2 和列持久性

通过