IHeaderCtrl::InsertColumn メソッド (mmc.h)
既定の結果ウィンドウに列を追加します。
構文
HRESULT InsertColumn(
[in] int nCol,
[in] LPCWSTR title,
[in] int nFormat,
[in] int nWidth
);
パラメーター
[in] nCol
挿入される列の 0 から始まるインデックス。
[in] title
挿入する列のタイトルを表す文字列を示す 値です。 この文字列の最大長は 、MAX_PATH 文字にすることができます。
[in] nFormat
列内のテキストの位置を示す 値です。 列 0 の場合は、 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 は幅 0 と解釈されます。 ユーザーは、マウスで列をドラッグすることで、列を拡大できます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
注釈
MMC は 、IHeaderCtrl::InsertColumn のアクションのために列セットに加えられた変更をメモリに保持しないため、スナップインでは、列セットに列を挿入した後、永続化された列構成データを更新する必要があります。 詳細については、「 IHeaderCtrl2」と「列の永続化」 を参照してください。
呼び出し元へのメモ
結果ビューに項目が既に挿入されている場合、 InsertColumn の呼び出しは失敗します。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |
| [DLL] | Mmcndmgr.dll |