IUICommandHandler::UpdateProperty メソッド (uiribbon.h)

Windows リボン フレームワークからのプロパティ更新要求に応答します。

構文

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

パラメーター

[in] commandId

種類: UINT32

[マークアップ] リソース ファイルで指定される Command の ID。

[in] key

型: REFPROPERTYKEY

更新する プロパティ キー 。

[in, optional] currentValue

型: const PROPVARIANT*

キーの現在の値へのポインター。 このパラメーターは、NULL でもかまいません。

[out] newValue

型: PROPVARIANT*

このメソッドが戻るとき、 には 、キーの新しい値へのポインターが含まれます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドは、リボン フレームワークへの後続の呼び出しが行われる前に、 を返すようにする必要があります。

UI_PKEY_EnabledやUI_PKEY_Labelなどの Command プロパティの値は、SetUICommandProperty または InvalidateUICommand の呼び出しによって設定されます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiribbon.h
[DLL]	Mshtml.dll

こちらもご覧ください

IUICommandHandler

Windows リボン フレームワークのサンプル