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

慣性静止位置のスナップ ポイントを指定します。

構文

HRESULT SetSnapPoints(
  [in] DIRECTMANIPULATION_MOTION_TYPES motion,
  [in] const float                     *points,
  [in] DWORD                           pointCount
);

パラメーター

[in] motion

1 つ以上の DIRECTMANIPULATION_MOTION_TYPES 列挙値。 DIRECTMANIPULATION_MOTION_TRANSLATE_X、DIRECTMANIPULATION_MOTION_TRANSLATE_Y、またはDIRECTMANIPULATION_MOTION_ZOOMのみが許可されます。

[in] points

スナップするコンテンツの境界内のスナップ ポイントの配列。 SetSnapCoordinate で設定された原点に対して、昇順で指定する必要があります。

[in] pointCount

スナップ ポイントの配列のサイズ。 0 より大きい値にする必要があります。

戻り値

メソッドが成功すると、 S_OKが返されます。 スナップポイントに変更がない場合、このメソッドは S_FALSEを返すことができます。 そうでない場合は、HRESULT エラー コードを返します。 無効なスナップ ポイントを指定すると、既存のスナップ ポイントが影響を受ける可能性があります。

注釈

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

要件

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

こちらもご覧ください

IDirectManipulationPrimaryContent

SetSnapCoordinate

SetSnapInterval