IDirectManipulationViewport::SetContact 메서드(directmanipulation.h)

연락처와 뷰포트 간의 연결을 지정합니다.

구문

HRESULT SetContact(
  [in] UINT32 pointerId
);

매개 변수

[in] pointerId

포인터의 ID입니다.

반환 값

메서드가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

WM_POINTERDOWN 메시지가 수신되면 이 메서드를 호출합니다. WM_POINTERDOWN 받으면 애플리케이션은 입력의 좌표를 사용하여 적중 테스트를 수행하고 연락처가 연결된 뷰포트를 확인할 수 있습니다.

SetContact 전에 DeferContact를 호출해야 합니다.

초기화 후 직접 조작 은 뷰포트 z 순서 또는 뷰포트 간의 부모-자식 관계를 인식하지 않습니다. SetContact 호출 순서는 뷰포트 트리를 정의합니다. 올바른 뷰포트 계층 구조를 설정하려면 자식 뷰포트에서 SetContact 를 먼저 호출하고 부모, 상위 뷰포트 등을 호출해야 합니다.

GET_POINTERID_WPARAM 사용하여 포인터 메시지에서 포인터 식별자를 가져옵니다. WM_POINTERUP 받으면 연락처가 자동으로 제거됩니다.

연락처가 SetContact 메서드를 사용하여 하나 이상의 뷰포트와 연결된 경우 직접 조작은 해당 연락처의 추가 입력을 검사하고 연결된 뷰포트의 구성에 따라 적절한 조작을 식별하려고 시도합니다. 조작이 인식되면 애플리케이션은 이 연락처에 대한 WM_POINTERCAPTURECHANGED 메시지를 받습니다. 이 컨텍스트에서 WM_POINTERCAPTURECHANGED 메시지는 직접 조작이 연락처를 캡처했으며 애플리케이션이 이 조작에 사용되는 이 연락처의 입력을 받지 못했음을 나타냅니다.

요구 사항

추가 정보

IDirectManipulationViewport

사용자 입력 메시지 및 알림