IResultData::Metode InsertItem (mmc.h)

Metode IResultData::InsertItem memungkinkan snap-in untuk menambahkan satu item baru ke tampilan panel hasil.

Sintaks

HRESULT InsertItem(
  [in, out] LPRESULTDATAITEM item
);

Parameter

[in, out] item

Penunjuk ke struktur RESULTDATAITEM yang berisi informasi tentang item yang akan ditambahkan.

Setelah item disisipkan, pengidentifikasi unik (ID item) ditetapkan ke item tersebut oleh MMC dan dikembalikan melalui anggota itemID struktur yang ditunjukkan oleh parameter item. Ketahuilah bahwa nilai itemID adalah handel HRESULTITEM dari item yang disisipkan. Snap-in harus menyimpan nilai ini untuk kemudian memanipulasi item yang disisipkan dengan memanggil metode seperti IResultData::GetItem.

Jika pengidentifikasi ini tidak disimpan, pengidentifikasi dapat dicari menggunakan IResultData::FindItemByLParam.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Keterangan

Masker dan semua bidang terkait yang sesuai dalam struktur RESULTDATAITEM harus diisi. Subitem tidak dapat disisipkan tetapi dapat diatur. Oleh karena itu, anggota nCol dari struktur item harus nol.

Anggota str RESULTDATAITEM harus diatur ke MMC_CALLBACK.

Setelah item disisipkan, pengidentifikasi unik (ID item) ditetapkan ke item tersebut oleh MMC dan dikembalikan melalui anggota itemID struktur yang ditunjukkan oleh parameter item. Ketahuilah bahwa nilai itemID adalah handel HRESULTITEM dari item yang disisipkan. Snap-in harus menyimpan nilai ini untuk kemudian memanipulasi item yang disisipkan dengan memanggil metode seperti IResultData::GetItem.

Jika pengidentifikasi ini tidak disimpan, pengidentifikasi dapat diidentifikasi menggunakan IResultData::FindItemByLParam.

Metode ini tidak mendukung daftar virtual.

Persyaratan

Lihat juga

IResultData

IResultData2