Método IDirectManipulationCompositor2::AddContentWithCrossProcessChaining (directmanipulation.h)

Artigo
03/13/2024

Associa o conteúdo (de propriedade do host do componente) ao compositor, atribui um dispositivo de composição ao conteúdo e especifica a posição do conteúdo na árvore de composição em relação a outros visuais de composição. Representa um objeto compositor que associa o conteúdo manipulado a superfícies de desenho em vários processos.

Sintaxe

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] IUnknown                          *device,
  [in] IUnknown                          *parentVisual,
  [in] IUnknown                          *childVisual
);

Parâmetros

[in] content

O conteúdo a ser adicionado à árvore de composição.

o conteúdo é colocado entre parentVisual e childVisual na árvore de composição.

Somente o conteúdo primário, criado ao mesmo tempo que o visor, é válido.

[in] device

O dispositivo usado para compor o conteúdo.

Observeque o dispositivo é criado pelo aplicativo.

[in] parentVisual

Os visuais pai na árvore de composição do conteúdo que está sendo adicionado.

parentVisual também deve ser um pai de childVisual na árvore de composição.

[in] childVisual

Os visuais filho na árvore de composição do conteúdo que está sendo adicionado.

parentVisual também deve ser um pai de childVisual na árvore de composição.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método insere uma pequena árvore visual (de propriedade do dispositivo de Manipulação Direta ) entre o parentVisual e o childVisual. As transformações podem ser aplicadas ao conteúdo inserido.

Todo o conteúdo, independentemente do tipo, deve ser adicionado ao compositor.

Se o aplicativo usar um IDirectManipulationCompositor fornecido pelo sistema:

device deve ser um objeto IDCompositionDevice e os visuais pai e filho devem ser objetos IDCompositionVisual .
device, parentVisual e childVisual não podem ser NULL.
os objetos device, parentVisual e childVisual são criados e pertencem ao aplicativo.
Quando o conteúdo é adicionado à árvore de composição usando esse método, os novos visuais de composição são inseridos entre parentVisual e childVisual. Os novos visuais não devem ser destruídos até que sejam desassociados do compositor com RemoveContent.

Se o aplicativo usar uma implementação personalizada de IDirectManipulationCompositor:

device, parentVisual e childVisual devem ser um tipo válido para o compositor. Eles não precisam ser objetos IDCompositionDevice ou IDCompositionVisual .
device, parentVisual e childVisual podem ser NULL, dependendo do compositor.