IDirectManipulationViewport2::AddBehavior メソッド (directmanipulation.h)
ビューポートに動作を追加し、呼び出し元に Cookie を返します。
構文
HRESULT AddBehavior(
[in] IUnknown *behavior,
[out, retval] DWORD *cookie
);
パラメーター
[in] behavior
CreateBehavior メソッドを使用して作成された動作。
[out, retval] cookie
呼び出し元が後でこの動作を削除できるように、Cookie が返されます。 これにより、呼び出し元は動作に関する参照を解放し、 直接操作 でイベント ハンドラーと同様に適切な有効期間を維持できます。
戻り値
メソッドが成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。 このビューポートまたは別のビューポートに既にアタッチされている動作をアタッチすると、エラーが発生します。
注釈
動作は、 AddBehavior が呼び出された直後に有効になります。 これは、アクティブな操作または慣性フェーズ中に動作を追加する場合に考慮する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | directmanipulation.h |