Metode IHeaderCtrl::InsertColumn (mmc.h)

Menambahkan kolom ke panel hasil default.

Sintaks

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

Parameter

[in] nCol

Indeks kolom berbasis nol yang sedang disisipkan.

[in] title

Nilai yang menentukan string yang mewakili judul kolom yang sedang disisipkan. String ini dapat memiliki panjang maksimum MAX_PATH karakter.

[in] nFormat

Nilai yang menentukan posisi teks dalam kolom. Untuk kolom nol, nFormat harus LVCFMT_LEFT. Nilai ini harus salah satu dari yang berikut ini:

LVCFMT_LEFT

Teks rata kiri.

LVCFMT_CENTER

Teks rata tengah.

LVCFMT_RIGHT

Teks rata kanan.

Catatan Untuk menggunakan konstanta LVCFMT_* , sertakan CommCtrl.h dalam file sumber Anda.

 

[in] nWidth

Nilai yang menentukan lebar kolom dalam piksel. Nilai ini harus salah satu dari yang berikut ini:

MMCLV_AUTO

MMC secara otomatis menentukan lebar kolom berdasarkan string judulnya.

HIDE_COLUMN

Diperkenalkan di MMC 1.2. Kolom disisipkan, tetapi disembunyikan. Ketahuilah bahwa pengguna dapat membuat kolom terlihat saat menyesuaikan tampilan daftar.

Untuk snap-in yang dibangun dengan MMC 1.2 SDK, tetapi yang dimuat dalam versi MMC yang lebih lama, HIDE_COLUMN ditafsirkan sebagai lebar nol. Pengguna dapat memperlebar kolom dengan menyeretnya dengan mouse.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Keterangan

MMC tidak bertahan dalam memori setiap perubahan yang dilakukan pada kumpulan kolom karena tindakan IHeaderCtrl::InsertColumn, sehingga snap-in harus memperbarui data konfigurasi kolom yang bertahan setelah menyisipkan kolom ke dalam kumpulan kolom. Lihat IHeaderCtrl2 dan Persistensi Kolom untuk informasi selengkapnya.

Catatan untuk Penelepon

Panggilan ke InsertColumn gagal jika ada item yang telah dimasukkan ke dalam tampilan hasil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	mmc.h
DLL	Mmcndmgr.dll

Lihat juga

IHeaderCtrl

IHeaderCtrl2 dan Persistensi Kolom