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) |