IUIFramework::SetUICommandProperty-Methode (uiribbon.h)
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 |