ホーム › Graphics.DirectManipulation › IDirectManipulationDragDropBehavior

IDirectManipulationDragDropBehavior

COM

IID814b5af5-c2c8-4270-a9b7-a198ce8d02fa継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

クロススライドまたは長押しのジェスチャーによってトリガーされる、ドラッグアンドドロップ操作の動作を表します。

解説(Remarks)

ビューポートに対して AddConfiguration、RemoveConfiguration、ActivateConfiguration、または SetManualGesture の呼び出しが成功している場合、そのビューポートの残りの有効期間中は AddBehavior が失敗します。

動作がビューポートに追加されると、RemoveBehavior が呼び出されるまで、AddConfiguration、RemoveConfiguration、ActivateConfiguration、または SetManualGesture の呼び出しは失敗します。

メソッド 2

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

vtbl 3 HRESULT SetConfiguration(DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION configuration)

この動作がアタッチされているビューポートに対して、ドラッグアンドドロップ操作の構成を設定します。

configuration

DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION

DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION の値の組み合わせ。

構成が有効であるためには、configuration に次の3つの値のうち、いずれか1つだけが含まれている必要があります:

DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY または DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG を指定する場合は、DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL または DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL のいずれか一方が必要です。

DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG を指定する場合は、DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL と DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL の両方が必要です。

戻り値

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

解説(Remarks)

動作の構成は、ビューポートに追加される前でも後でも設定できます。操作の実行中に構成を変更した場合、新しい構成は次の操作から有効になります。

IDirectManipulationDragDropBehavior::SetConfiguration を呼び出す前に IDirectManipulationViewport::ActivateConfiguration を呼び出さないでください。予期しない動作を引き起こします。

vtbl 4 HRESULT GetStatus(DIRECTMANIPULATION_DRAG_DROP_STATUS* status)

この動作がアタッチされているビューポートに対する、ドラッグアンドドロップ操作の状態を取得します。

status

DIRECTMANIPULATION_DRAG_DROP_STATUS*

out

DIRECTMANIPULATION_DRAG_DROP_STATUS の値のいずれか。

戻り値

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

解説(Remarks)

このメソッドは、戻り値が読み取られた時点ではなく、呼び出された時点でのドラッグアンドドロップの状態を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDirectManipulationDragDropBehavior "{814B5AF5-C2C8-4270-A9B7-A198CE8D02FA}"
#usecom global IDirectManipulationDragDropBehavior IID_IDirectManipulationDragDropBehavior "{}"
#comfunc global IDirectManipulationDragDropBehavior_SetConfiguration  3 int
#comfunc global IDirectManipulationDragDropBehavior_GetStatus         4 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IDirectManipulationDragDropBehavior "{814B5AF5-C2C8-4270-A9B7-A198CE8D02FA}"
#usecom global IDirectManipulationDragDropBehavior IID_IDirectManipulationDragDropBehavior "{}"
#comfunc global IDirectManipulationDragDropBehavior_SetConfiguration  3 int
#comfunc global IDirectManipulationDragDropBehavior_GetStatus         4 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。