IDirectManipulationViewport::ActivateConfiguration 메서드(directmanipulation.h)
입력 상호 작용에 대한 구성을 설정합니다.
구문
HRESULT ActivateConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
매개 변수
[in] configuration
뷰포트에 대한 상호 작용 구성을 지정하는 DIRECTMANIPULATION_CONFIGURATION 하나 이상의 값입니다.
반환 값
메서드가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
조작 구성은 조작 엔진이 입력에 응답하는 방법과 지원되는 조작을 지정합니다. 입력을 처리하기 전에 AddConfiguration 을 사용하여 가능한 구성을 뷰포트에 추가할 수 있습니다.
구성은 ActivateConfiguration을 사용하여 런타임에 애플리케이션에서 전환할 수 있습니다.
구성이 더 이상 필요하지 않고 현재 활성화되지 않은 경우 RemoveConfiguration을 사용하여 제거할 수 있습니다.
AddConfiguration을 사용하여 구성을 추가하지 않은 경우 ActivateConfiguration을 호출하여 자동으로 추가한 다음 활성화할 수 있습니다.
참고 입력 처리가 발생하면 이 호출이 실패합니다.
이 메서드를 성공적으로 호출한 후에는 끌어서 놓 기 동작 개체를 연결할 수 없습니다.
예제
다음 예제에서는 가로 이동에 대한 뷰포트를 구성하는 방법을 보여줍니다.
HRESULT hr = pViewport>ActivateConfiguration(
DIRECTMANIPULATION_CONFIGURATION_INTERACTION |
DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | directmanipulation.h |