IUICommandHandler::UpdateProperty-Methode (uiribbon.h)
Antwortet auf Eigenschaftenupdateanforderungen aus dem Windows-Menübandframework.
Syntax
HRESULT UpdateProperty(
[in] UINT32 commandId,
[in] REFPROPERTYKEY key,
[in, optional] const PROPVARIANT *currentValue,
[out] PROPVARIANT *newValue
);
Parameter
[in] commandId
Typ: UINT32
Die ID für den Befehl, der in der Markupressourcendatei angegeben wird.
[in] key
Typ: REFPROPERTYKEY
Der zu aktualisierende Eigenschaftenschlüssel .
[in, optional] currentValue
Typ: const PROPVARIANT*
Ein Zeiger auf den aktuellen Wert für schlüssel. Dieser Parameter kann NULL sein.
[out] newValue
Typ: PROPVARIANT*
Wenn diese Methode zurückgibt, enthält einen Zeiger auf den neuen Wert für schlüssel.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Methode sollte zurückgegeben werden, bevor nachfolgende Aufrufe des Menübandframeworks ausgeführt werden.
Die Werte von Command-Eigenschaften, z. B. UI_PKEY_Enabled oder UI_PKEY_Label, werden durch Aufrufe von SetUICommandProperty oder InvalidateUICommand festgelegt.
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 |