IDirectManipulationCompositor::AddContent 메서드(directmanipulation.h)

호출자가 소유한 콘텐츠를 작성자와 연결하고, 컴퍼지션 디바이스를 콘텐츠에 할당하고, 다른 컴퍼지션 시각적 개체를 기준으로 컴퍼지션 트리의 콘텐츠 위치를 지정합니다.

구문

HRESULT AddContent(
  [in]           IDirectManipulationContent *content,
  [in, optional] IUnknown                   *device,
  [in]           IUnknown                   *parentVisual,
  [in]           IUnknown                   *childVisual
);

매개 변수

[in] content

컴퍼지션 트리에 추가할 콘텐츠입니다.

콘텐츠 는 컴퍼지션 트리의 parentVisual 과 childVisual 사이에 배치됩니다.

[in, optional] device

콘텐츠를 작성하는 데 사용되는 디바이스입니다.

[in] parentVisual

추가되는 콘텐츠의 컴퍼지션 트리에 있는 부모 시각적 개체입니다.

parentVisual 은 컴퍼지션 트리에서 자식Visual 의 부모여야 합니다.

[in] childVisual

추가되는 콘텐츠의 컴퍼지션 트리에 있는 자식 시각적 개체입니다.

parentVisual 은 컴퍼지션 트리에서 자식Visual 의 부모여야 합니다.

반환 값

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

설명

이 메서드는 부모Visual과 자식Visual 사이에 작은 시각적 트리(직접 조작 디바이스 소유)를 삽입합니다. 그런 다음 삽입된 콘텐츠에 변환을 적용할 수 있습니다.

형식에 관계없이 모든 콘텐츠를 작성자에 추가해야 합니다. GetPrimaryContent를 호출하여 뷰포트에서 가져온 기본 콘텐츠이거나 CreateContent를 호출하여 만든 이동 표시기 같은 보조 콘텐츠일 수 있습니다.

애플리케이션에서 시스템 제공 IDirectManipulationCompositor를 사용하는 경우:

• 디바이스 는 IDCompositionDevice 개체여야 하며 부모 및 자식 시각적 개체는 IDCompositionVisual 개체여야 합니다.
• device, parentVisual 및 childVisual 은 NULL일 수 없습니다.
• device, parentVisual 및 childVisual 개체는 애플리케이션에서 만들고 소유합니다.
• 이 메서드를 사용하여 콘텐츠가 컴퍼지션 트리에 추가되면 parentVisual 과 childVisual 사이에 새 컴퍼지션 시각적 개체가 삽입됩니다. 새 시각적 개체는 RemoveContent를 사용하여 작성기에서 분리될 때까지 제거하면 안 됩니다.

• device, parentVisual 및 childVisual 은 작성자에 유효한 형식이어야 합니다. IDCompositionDevice 또는 IDCompositionVisual 개체일 필요는 없습니다.
• device, parentVisual 및 childVisual 은 작성자에 따라 NULL일 수 있습니다.

요구 사항

추가 정보

IDirectManipulationCompositor