Metodo IShellBrowser::InsertMenusSB (shobjidl_core.h)

Articolo
03/02/2024

Consente al contenitore di inserire i gruppi di menu nel menu composito visualizzato quando viene visualizzato uno spazio dei nomi esteso o usato.

Sintassi

HRESULT InsertMenusSB(
  HMENU                hmenuShared,
  LPOLEMENUGROUPWIDTHS lpMenuWidths
);

Parametri

hmenuShared

Tipo: HMENU

Handle a un menu vuoto.

lpMenuWidths

Tipo: LPOLEMENUGROUPWIDTHS

Indirizzo di una matrice OLEMENUGROUPWIDTHS di sei valori LONG . Il contenitore riempie gli elementi 0, 2 e 4 per riflettere il numero di elementi di menu forniti nei gruppi di menu File, Visualizzazione e Finestra.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore definito da COM in caso contrario.

Commenti

Questo metodo è simile al metodo IOleInPlaceFrame::InsertMenus . Esplora risorse inserisce i menu a discesa File e Modifica nel gruppo di menu File, Visualizza e strumenti nel gruppo di menu Contenitore e un menu Guida nel gruppo di menu Finestra. Ogni menu a discesa avrà un identificatore univoco, FCIDM_MENU_FILE/EDIT/VIEW/TOOLS/HELP. La visualizzazione è consentita per inserire le voci di menu in tali sottomenus in base ai relativi identificatori, che è diverso dal meccanismo di attivazione sul posto di OLE. Gli identificatori di comando per i menu inseriti nella sottomenu di Esplora risorse di Windows o nei relativi sottomenus devono essere compresi tra FCIDM_SHVIEWFIRST e FCIDM_SHVIEWLAST.

Note per la chiamata di applicazioni

Questo metodo viene chiamato dalle estensioni dello spazio dei nomi quando vengono attivate per la prima volta in modo che possano inserire i menu nell'interfaccia utente a livello di frame.

L'applicazione oggetto chiede al contenitore di aggiungere i relativi menu al menu specificato nel parametro hmenuShared e di impostare i conteggi dei gruppi nella matrice OLEMENUGROUPWIDTHS a cui punta il parametro lpMenuWidths . L'applicazione oggetto aggiunge quindi i propri menu e conteggi. Gli oggetti possono chiamare il metodo IOleInPlaceFrame::InsertMenus quante volte necessario per compilare i menu compositi. Il contenitore deve usare l'handle di menu iniziale associato al menu composito per tutte le voci nei menu a discesa.

Note per gli implementatori

Per le implementazioni di IShellBrowser , gli identificatori di menu devono trovarsi nell'intervallo di FCIDM_BROWSERFIRST da FCIDM_BROWSERLAST.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite