IUICommandHandler::UpdateProperty 方法 (uiribbon.h)
回應 Windows 功能區架構的屬性更新要求。
語法
HRESULT UpdateProperty(
[in] UINT32 commandId,
[in] REFPROPERTYKEY key,
[in, optional] const PROPVARIANT *currentValue,
[out] PROPVARIANT *newValue
);
參數
[in] commandId
類型: UINT32
命令的識別碼,在標記資源檔中指定。
[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 |