Метод 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 являются допустимыми.

Если для перемещения задано значение DIRECTMANIPULATION_MOTION_ZOOM, допустимы только DIRECTMANIPULATION_COORDINATE_ORIGINDIRECTMANIPULATION_SNAPPOINT_COORDINATE (источник должен иметь значение 0,0f).

[in] origin

Начальная или начальная точка привязки. Все точки привязки относятся к этой. Используется только при установке DIRECTMANIPULATION_COORDINATE_ORIGIN .

Если для перемещения задано значение DIRECTMANIPULATION_MOTION_ZOOM, то для источника необходимо задать значение 0,0f.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Источник определяется относительно границ содержимого. Если граница не задана (SetContentRect никогда не вызывается), границы по умолчанию — (-FLT_MAX, FLT_MAX).

Требования

См. также раздел

IDirectManipulationPrimaryContent

SetSnapInterval

SetSnapPoints