Método IDirectManipulationCompositor2::AddContentWithCrossProcessChaining (directmanipulation.h)
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.
[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.
- 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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | directmanipulation.h |