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

뷰포트에 대한 상호 작용 구성을 추가합니다.

구문

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

[in] configuration

뷰포트에 대한 상호 작용 구성을 지정하는 DIRECTMANIPULATION_CONFIGURATION 값 중 하나입니다.

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

조작 구성은 조작 엔진이 입력에 응답하는 방법과 지원되는 조작을 지정합니다. 입력을 처리하기 전에 AddConfiguration 을 사용하여 가능한 구성을 뷰포트에 추가할 수 있습니다.

구성은 ActivateConfiguration을 사용하여 런타임에 애플리케이션에서 전환할 수 있습니다.

구성이 더 이상 필요하지 않고 현재 활성화되지 않은 경우 RemoveConfiguration을 사용하여 제거할 수 있습니다.

AddConfiguration을 사용하여 구성을 추가하지 않은 경우 ActivateConfiguration을 호출하여 자동으로 추가한 다음 활성화할 수 있습니다.

참고 입력 처리가 발생하면 이 호출이 실패합니다.

끌어서 놓기 동작이 지정된 경우 이 메서드가 실패합니다.

이 메서드를 성공적으로 호출한 후에는 끌어서 놓 기 동작 개체를 연결할 수 없습니다.

기존 항목이 이미 추가된 후에는 다른 끌어서 놓 기 동작을 추가할 수 없습니다.

이 메서드는 조작이 발생하는 동안 구성을 변경할 수 없으므로 애플리케이션이 미리 추가된 구성을 전환할 수 있도록 설계되었습니다. 대부분의 경우 ActivateConfiguration을 사용하여 구성을 업데이트하는 것이 좋습니다.