IShellBrowser::InsertMenusSB method (shobjidl_core.h)

Memungkinkan kontainer memasukkan grup menunya ke dalam menu komposit yang ditampilkan saat namespace yang diperluas sedang dilihat atau digunakan.

Sintaks

HRESULT InsertMenusSB(
  HMENU                hmenuShared,
  LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parameter

hmenuShared

Jenis: HMENU

Handel ke menu kosong.

lpMenuWidths

Jenis: LPOLEMENUGROUPWIDTHS

Alamat array OLEMENUGROUPWIDTHS dari enam nilai LONG . Kontainer mengisi elemen 0, 2, dan 4 untuk mencerminkan jumlah elemen menu yang disediakan dalam grup menu File, Tampilan, dan Jendela.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan yang ditentukan COM jika tidak.

Keterangan

Metode ini mirip dengan metode IOleInPlaceFrame::InsertMenus . Windows Explorer meletakkan menu drop-down File dan Edit di grup menu File, menu Tampilan dan Alat di grup menu Kontainer, dan menu Bantuan di grup menu Jendela. Setiap menu drop-down akan memiliki pengidentifikasi unik, FCIDM_MENU_FILE/EDIT/VIEW/TOOLS/HELP. Tampilan diizinkan untuk menyisipkan item menu ke dalam submenus tersebut oleh pengidentifikasi mereka, yang berbeda dari mekanisme aktivasi di tempat OLE. Pengidentifikasi perintah untuk menu yang disisipkan tampilan ke submenus Windows Explorer atau submenusnya sendiri harus antara FCIDM_SHVIEWFIRST dan FCIDM_SHVIEWLAST.

Catatan untuk Memanggil Aplikasi

Metode ini dipanggil oleh ekstensi namespace ketika pertama kali diaktifkan sehingga mereka dapat memasukkan menu mereka ke antarmuka pengguna tingkat bingkai.

Aplikasi objek meminta kontainer untuk menambahkan menunya ke menu yang ditentukan dalam parameter hmenuShared dan untuk mengatur jumlah grup dalam array OLEMENUGROUPWIDTHS yang diarahkan oleh parameter lpMenuWidths . Aplikasi objek kemudian menambahkan menu dan hitungannya sendiri. Objek dapat memanggil metode IOleInPlaceFrame::InsertMenus sebanyak yang diperlukan untuk membangun menu komposit. Kontainer harus menggunakan handel menu awal yang terkait dengan menu komposit untuk semua item di menu drop-down.

Catatan untuk Pelaksana

Untuk implementasi IShellBrowser , pengidentifikasi menu harus dalam rentang FCIDM_BROWSERFIRST hingga FCIDM_BROWSERLAST.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)