IUICommandHandler：：UpdateProperty 方法 (uiribbon.h)

  • 项目

响应来自 Windows 功能区框架的属性更新请求。

语法

HRESULT UpdateProperty(
  [in]           UINT32            commandId,
  [in]           REFPROPERTYKEY    key,
  [in, optional] const PROPVARIANT *currentValue,
  [out]          PROPVARIANT       *newValue
);

参数

[in] commandId

类型： UINT32

命令的 ID，在标记资源文件中指定。

[in] key

类型： REFPROPERTYKEY

要更新 的属性键 。

[in, optional] currentValue

类型： const PROPVARIANT*

指向 键的当前值的指针。 此参数可以为 NULL。

[out] newValue

类型： PROPVARIANT*

此方法返回时，包含指向 键的新值的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

在对功能区框架进行任何后续调用之前，应允许此方法返回 。

Command 属性的值（如 UI_PKEY_Enabled 或 UI_PKEY_Label）是通过调用 SetUICommandProperty 或 InvalidateUICommand 设置的。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 uiribbon.h
DLL Mshtml.dll

另请参阅

IUICommandHandler

Windows 功能区框架示例