IHeaderCtrl::InsertColumn 方法 (mmc.h)
將數據行加入至預設結果窗格。
語法
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 中引進。 插入數據行,但隱藏。 請注意,用戶可以在 自定義清單檢視時顯示數據行。
針對使用 MMC 1.2 SDK 建置但以舊版 MMC 載入的嵌入式管理單元, HIDE_COLUMN 會解譯為零寬度。 用戶可以使用滑鼠拖曳數據行來擴大數據行。
傳回值
這個方法可以傳回其中一個值。
備註
MMC 不會保存在記憶體中,因為 IHeaderCtrl::InsertColumn 動作而對數據行集所做的任何變更,因此嵌入式管理單元必須在將數據行插入數據行集之後更新保存的數據行組態數據。 如需詳細資訊 ,請參閱 IHeaderCtrl2 和數據行持續性 。
來電者的附註
如果有任何項目已經插入結果檢視,則 InsertColumn 的呼叫會失敗。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | mmc.h |
Dll | Mmcndmgr.dll |