IConsole2::Perluas metode (mmc.h)

Metode IConsole2::Expand memungkinkan snap-in untuk memperluas atau menciutkan item di panel cakupan.

Sintaks

HRESULT Expand(
  [in] HSCOPEITEM hItem,
  [in] BOOL       bExpand
);

Parameter

[in] hItem

Handel ke item untuk diperluas.

[in] bExpand

Nilai yang menentukan apakah akan memperluas atau menciutkan item. TRUE memperluas item. FALSE menciutkan item.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Keterangan

Metode IConsole2::Expand setara dengan terprogram pengguna yang mengklik tanda plus atau dikurangi untuk memperluas atau menciutkan item di panel cakupan. Artinya, metode ini menyebabkan ekspansi yang terlihat atau ciutkan item di panel cakupan. Ketahuilah bahwa metode ini tidak mengubah pilihan di panel cakupan dan tidak memengaruhi panel hasil.

Ketika metode ini dipanggil, MMC memperluas atau menciutkan item yang ditentukan oleh hItem berdasarkan nilai yang ditetapkan untuk bExpand. MMC kemudian mengirimkan pemberitahuan perluasan ke snap-in dari setiap item anak. MMC melakukannya dengan memanggil setiap metode IComponentData::Notify snap-in anak dengan peristiwa diatur ke MMCN_EXPAND, lpDataObject diatur sebagai penunjuk ke objek data untuk hItem, arg ditetapkan sebagai TRUE atau FALSE berdasarkan bExpand, dan param ditetapkan sebagai hItem. Ketahuilah bahwa hItem adalah handel HSCOPEITEM yang Anda tentukan dalam panggilan Anda ke IConsole2::Expand.

Metode IConsole2::Expand hanya berlaku untuk tampilan tertentu. Ini berarti bahwa ini hanya berlaku untuk instans objek IComponent snap-in yang sesuai dengan item snap-in yang muncul di jendela antarmuka multi-dokumen (MDI) tertentu di dalam konsol. Ketahuilah bahwa setiap jendela MDI dalam konsol mewakili tampilan yang berbeda dan bahwa instans snap-in dalam jendela MDI sesuai dengan objek IComponent untuk snap-in tersebut.

Oleh karena itu, snap-in hanya boleh memanggil metode ini pada penunjuk antarmuka IConsole2 yang terkait dengan objek IComponent , yaitu, penunjuk antarmuka IConsole2 yang diambil dengan memanggil QueryInterface pada penunjuk antarmuka IConsole yang dikembalikan oleh IComponent::Initialize.

Untuk menghitung item anak item di namespace tanpa memperluas item dengan jelas, snap-in harus menggunakan metode IConsoleNameSpace2::Expand .

Persyaratan

Lihat juga

IConsole2

IConsoleNameSpace2::Expand