IShellBrowser::SetMenuSB-Methode (shobjidl_core.h)

  • Artikel

Installiert das zusammengesetzte Menü im Ansichtsfenster.

Syntax

HRESULT SetMenuSB(
  HMENU    hmenuShared,
  HOLEMENU holemenuRes,
  HWND     hwndActiveObject
);

Parameter

hmenuShared

Typ: HMENU

Ein Handle für das zusammengesetzte Menü, das durch Aufrufe von IShellBrowser::InsertMenusSB und der InsertMenu-Funktion erstellt wird.

holemenuRes

Typ: HOLEMENU

hwndActiveObject

Typ: HWND

Das Fensterhandle der Ansicht.

Rückgabewert

Typ: RESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-definierten Fehlerwert zurück.

Hinweise

Diese Methode ähnelt der IOleInPlaceFrame::SetMenu-Methode . Windows Explorer führt jedoch die Menüverteilung basierend auf dem Menüelementbezeichner aus.

Die Verfügbarkeit bestimmter Menüelemente hängt davon ab, ob die Ansicht den Fokus hat. Dementsprechend ist es notwendig, die IShellBrowser::OnViewWindowActive-Methode aufzurufen, wenn das Ansichtsfenster (oder eines seiner untergeordneten Fenster) den Fokus hat.

Hinweise zum Aufrufen von Anwendungen

Das Objekt ruft IShellBrowser_SetMenuSB auf, um den Container aufzufordern, die zusammengesetzte Menüstruktur zu installieren, die durch Aufrufe von IShellBrowser::InsertMenusSB eingerichtet wurde.

Hinweise für Implementierer

Die Implementierung dieser Methode in einem Container sollte die SetMenu-Funktion aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll (Version 4.0 oder höher)

Weitere Informationen

IShellBrowser