IDirectManipulationPrimaryContent::SetSnapInterval メソッド (directmanipulation.h)

慣性終了位置のスナップ点を一定間隔で指定します。

構文

HRESULT SetSnapInterval(
  [in] DIRECTMANIPULATION_MOTION_TYPES motion,
  [in] float                           interval,
  [in] float                           offset
);

パラメーター

[in] motion

DIRECTMANIPULATION_MOTION_TYPES列挙値の 1 つ。

[in] interval

各スナップ ポイント間の間隔。

[in] offset

SetSnapCoordinate で指定された座標からのオフセット。

戻り値

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

注釈

スナップ ポイントの位置はコンテンツ座標単位です。

SetSnapPoints または SetSnapInterval を使用してスナップポイントを指定します。

スナップ ポイントが無効な場合 (たとえば、コンテンツ境界の外側) は無視され、コンテンツは常にコンテンツ境界内にあります。

既定では、スナップ ポイントは境界にありません。 コンテンツを境界で停止する場合は、境界にスナップ ポイントを設定する必要があります。

SetSnapInterval によって設定されたスナップ ポイントは、間隔が 0.0f の SetSnapInterval を呼び出すことでクリアできます。

例

次の例は、X 変換スナップ ポイントの座標系を原点に設定する方法を示しています。 スナップ ポイントは、X 軸に沿った原点から 45 ピクセルごとに設定されます。

HRESULT hr = SetSnapCoordinate(testWindow, 0, DIRECTMANIPULATION_MOTION_TRANSLATEX, DIRECTMANIPULATION_COORDINATE_ORIGIN, 0.0f);
hr = pContent->SetSnapInterval(DIRECTMANIPULATION_MOTION_TRANSLATEX, 45.0f, 0.0f);

要件

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

こちらもご覧ください

IDirectManipulationPrimaryContent

SetSnapCoordinate

SetSnapPoints