IUIFramework::SetModes-Methode (uiribbon.h)

Gibt die zu aktivierenden Anwendungsmodi an.

Syntax

HRESULT SetModes(
  INT32 iModes
);

Parameter

iModes

Typ: INT32

Eine Bitmaske, die die Modi identifiziert.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein Modus gibt an, welche Funktionalität erforderlich ist und welche Elemente abhängig vom Zustand oder Kontext einer Anwendung zur Laufzeit angezeigt (oder ausgeblendet) werden sollen. Beispielsweise kann sich die Netzwerkkonnektivität direkt auf die Funktionalität einer Anwendung auswirken und einen Netzwerkmodus von netzwerkbezogenen Befehlen erfordern, wenn eine Verbindung erkannt wird.

Modi werden für Elemente im Menübandmarkup angegeben und zur Laufzeit an einzelne Steuerelemente gebunden.

Modi können auf eine Registerkarte des Menübands und eine Gruppe angewendet werden.

Hinweis Modi können auf Button-, SplitButton- und DropDownButton-Steuerelemente angewendet werden, wenn sie in der linken Spalte des Anwendungsmenüs gehostet werden.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiribbon.h
DLL Mshtml.dll

Weitere Informationen

IUIFramework

Markupelemente

Neukonfiguration des Menübands mit Anwendungsmodi

Windows-Menübandframeworkbeispiele