IDirectManipulationPrimaryContent：：SetSnapCoordinate 方法 (directmanipulation.h)

指定对齐点或对齐间隔的坐标系。

语法

HRESULT SetSnapCoordinate(
  [in] DIRECTMANIPULATION_MOTION_TYPES         motion,
  [in] DIRECTMANIPULATION_SNAPPOINT_COORDINATE coordinate,
  [in] float                                   origin
);

参数

[in] motion

DIRECTMANIPULATION_MOTION_TYPES中的值之一。

[in] coordinate

DIRECTMANIPULATION_SNAPPOINT_COORDINATE中的值之 一。

如果将 motion 设置为平移 (DIRECTMANIPULATION_MOTION_TRANSLATEX或DIRECTMANIPULATION_MOTION_TRANSLATEY) ，则DIRECTMANIPULATION_SNAPPOINT_COORDINATE的所有值都有效。

如果 motion 设置为 DIRECTMANIPULATION_MOTION_ZOOM，则只有DIRECTMANIPULATION_SNAPPOINT_COORDINATE DIRECTMANIPULATION_COORDINATE_ORIGIN有效， (源必须设置为 0.0f) 。

[in] origin

初始或起始对齐点。 所有对齐点都相对于此对齐点。 仅在设置 DIRECTMANIPULATION_COORDINATE_ORIGIN 时使用。

如果 motion 设置为 DIRECTMANIPULATION_MOTION_ZOOM，则必须将 原点 设置为 0.0f。

返回值

如果方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

源相对于内容边界。 如果未设置边界 (则从不调用 SetContentRect) 默认边界 ( FLT_MAX，FLT_MAX) 。

要求

另请参阅

IDirectManipulationPrimaryContent

SetSnapInterval

SetSnapPoints