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