IUICommandHandler::UpdateProperty-Methode (uiribbon.h)

  • Artikel

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

Weitere Informationen

IUICommandHandler

Windows-Menübandframeworkbeispiele