IDirectManipulationPrimaryContent：：SetSnapInterval 方法 (directmanipulation.h)

指定以统一间隔的惯性结束位置的对齐点。

语法

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

参数

[in] motion

DIRECTMANIPULATION_MOTION_TYPES枚举值之一。

[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);

要求

另请参阅

IDirectManipulationPrimaryContent

SetSnapCoordinate

SetSnapPoints