IUIFramework::InvalidateUICommand-Methode (uiribbon.h)
Ungültig macht ein Windows-Menübandframework Command-Eigenschaft, -Wert oder -Zustand.
Syntax
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
Parameter
[in] commandId
Typ: UINT32
Die ID für den Befehl, der in der Markupressourcendatei angegeben wird.
[in] flags
Typ: UI_INVALIDATIONS
Gibt an, welcher Aspekt eines Befehls ungültig werden soll.
[in] key
Typ: const PROPERTYKEY*
Der Eigenschaftsschlüssel der Befehlseigenschaft oder des Befehlszustands. Dieser Parameter kann NULL sein.
Rückgabewert
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein Fehlerwert aus der folgenden Liste.
| Wert | Beschreibung |
|---|---|
| E_INVALIDARG | Ein ungültiger Wert für den Schlüssel wurde angegeben. |
| E_FAIL | Fehler beim Vorgang. Alle Befehle konnten nicht ungültig werden, oder keine der angegebenen Eigenschaften wird unterstützt. |
Hinweise
Die im Menübandframework-Markup definierten Ressourcen werden in einer Ressourcentabelle gespeichert, die erstellt wird, wenn die Markupdatei in das Binärformat kompiliert wird. Eine Ressource kann nicht aus der Markupressourcentabelle wiederhergestellt werden, nachdem sie ungültig wurde.
Nach der Ungültigheit fragt das Framework die Hostanwendung nach den Ressourcendetails ab.
Wenn ein Command-Wert ungültig ist (Flags enthalten UI_INVALIDATIONS_VALUE), ist der Wert des SchlüsselsNULL.
Wenn IUIFramework::InvalidateUICommand mehrmals aufgerufen wird und der in jedem Aufruf übergebene UI_INVALIDATIONS Wert überlappende Eigenschaften angibt, z. B. UI_INVALIDATIONS_STATE und UI_INVALIDATIONS_ALLPROPERTIES, wird nur ein Rückruf für die Hostanwendung erstellt.
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 |