IUIFramework::SetUICommandProperty-Methode (uiribbon.h)

  • Artikel

Legt eine Befehlseigenschaft, einen Wert oder einen Zustand fest.

Syntax

HRESULT SetUICommandProperty(
  [in] UINT32         commandId,
  [in] REFPROPERTYKEY key,
  [in] REFPROPVARIANT value
);

Parameter

[in] commandId

Typ: UINT32

Die ID für den Befehl, der in der Markupressourcendatei angegeben ist.

[in] key

Typ: REFPROPERTYKEY

Der Eigenschaftsschlüssel der Befehlseigenschaft, des Werts oder des Zustands.

[in] value

Typ: PROPVARIANT

Die Eigenschaft, der Wert oder der Zustand.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls ein Fehlerwert aus der folgenden Liste.

Wert BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) Die Eigenschaft, der Wert oder der Zustand unterstützen IUIFramework::SetUICommandProperty nicht. Sie können das Festlegen nur durch Ungültigkeit unterstützen.
E_FAIL Fehler beim Vorgang.

Hinweise

Eine begrenzte Anzahl von Eigenschaftenschlüsseln kann mit IUIFramework::SetUICommandProperty festgelegt werden. Für die Eigenschaften, bei denen IUIFramework::SetUICommandPropertyHRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) zurückgibt, sollte stattdessen IUIFramework::InvalidateUICommand verwendet werden.

Weitere Informationen zum Festlegen eines Eigenschaftenschlüssels für ein bestimmtes Steuerelement finden Sie auf der Seite Windows Ribbon Framework-Steuerelementbibliothek für dieses Steuerelement.

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

Windows-Menübandframeworkbeispiele