ホーム › Graphics.DirectManipulation › IDirectManipulationViewportEventHandler

IDirectManipulationViewportEventHandler

COM

IID952121da-d69f-45f9-b0f9-f23944321a6d継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ビューポートのステータスイベントおよび更新イベントを処理するためのメソッドを定義します。

解説(Remarks)

クライアントアプリは、ビューポートのステータスイベントおよび更新イベントを受け取るために、このハンドラーを実装します。ビューポートにハンドラーを設定するには、AddEventHandler を使用します。各ビューポートは複数のハンドラーを持つことができます。

メソッド 3

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT OnViewportStatusChanged(IDirectManipulationViewport* viewport, DIRECTMANIPULATION_STATUS current, DIRECTMANIPULATION_STATUS previous)

ビューポートのステータスが変化したときに呼び出されます。

viewport	IDirectManipulationViewport*	in	ステータスが変化したビューポート。
current	DIRECTMANIPULATION_STATUS	in	ビューポートの新しいステータス。
previous	DIRECTMANIPULATION_STATUS	in	ビューポートの以前のステータス。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このハンドラー内から GetStatus を呼び出した場合、返されるステータスが呼び出し時点のものと同じである保証はありません。これは通知が非同期であるためです。

vtbl 4 HRESULT OnViewportUpdated(IDirectManipulationViewport* viewport)

ビューポート内のすべてのコンテンツが更新された後に呼び出されます。

viewport

IDirectManipulationViewport*

更新されたビューポート。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

ビューポートの更新につき一度だけ実行する必要がある処理がある場合は、OnViewportUpdated を実装します。OnContentUpdated は、ビューポート内のコンテンツが変化するたびに呼び出されます。そのため、OnContentUpdated が複数回呼び出されることがあります。

vtbl 5 HRESULT OnContentUpdated(IDirectManipulationViewport* viewport, IDirectManipulationContent* content)

ビューポート内のコンテンツが更新されたときに呼び出されます。

viewport	IDirectManipulationViewport*	in	更新されたビューポート。
content	IDirectManipulationContent*	in	変化したビューポート内のコンテンツ。

戻り値

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

このメソッドは、ビューポート内のコンテンツが変化するたびに一度呼び出されます。そのため、OnContentUpdated が複数回呼び出されることがあります。たとえば、コンテンツの位置が変更された場合は、IDirectManipualtionContent::GetContentTransform を使用して新しい値を取得できます。

ビューポートの更新につき一度だけ実行する必要がある処理がある場合は、OnViewportUpdated を実装します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IDirectManipulationViewportEventHandler "{952121DA-D69F-45F9-B0F9-F23944321A6D}"
#usecom global IDirectManipulationViewportEventHandler IID_IDirectManipulationViewportEventHandler "{}"
#comfunc global IDirectManipulationViewportEventHandler_OnViewportStatusChanged  3 sptr,int,int
#comfunc global IDirectManipulationViewportEventHandler_OnViewportUpdated        4 sptr
#comfunc global IDirectManipulationViewportEventHandler_OnContentUpdated         5 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。