IUIFramework::InvalidateUICommand 方法 (uiribbon.h)
使 Windows 功能区框架命令属性、值或状态失效。
语法
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
参数
[in] commandId
类型: UINT32
命令的 ID,该 ID 在标记资源文件中指定。
[in] flags
类型: UI_INVALIDATIONS
标识要失效的命令的 哪个方面 。
注意 传递 UI_INVALIDATIONS_ALLPROPERTIES 使绑定到命令的所有属性(包括值和状态)失效。
[in] key
类型: const PROPERTYKEY*
命令属性或状态的属性键。 此参数可以为 NULL。
返回值
类型: HRESULT
如果成功,则返回S_OK;否则,以下列表中的错误值。
Value | 说明 |
---|---|
E_INVALIDARG | 提供了 密钥 的无效值。 |
E_FAIL | 此操作失败。 所有命令都无法失效,或者不支持指定的属性。 |
注解
功能区框架标记中定义的资源存储在将标记文件编译为二进制格式时创建的资源表中。 资源失效后,无法从标记资源表恢复。
失效后,框架会查询主机应用程序以获取资源详细信息。
当命令值无效 (标志包含 UI_INVALIDATIONS_VALUE) 键 值为 NULL 时。
如果 多次调用 IUIFramework::InvalidateUICommand ,并且每个调用中传递 的UI_INVALIDATIONS 值指定了重叠的属性,例如 UI_INVALIDATIONS_STATE 和 UI_INVALIDATIONS_ALLPROPERTIES,则只会创建一个对主机应用程序的回调。
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | uiribbon.h |
DLL | Mshtml.dll |