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);
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | directmanipulation.h |