Compartilhar via


Método IDirectManipulationCompositor::AddContent (directmanipulation.h)

Associa o conteúdo (de propriedade do chamador) 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.

Sintaxe

HRESULT AddContent(
  [in]           IDirectManipulationContent *content,
  [in, optional] 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.

[in, optional] device

O dispositivo usado para compor o conteúdo.

Observe que 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 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 pai de childVisual na árvore de composição.

Valor retornado

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 (pertencente ao 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. Isso pode ser conteúdo primário, obtido do visor chamando GetPrimaryContent ou conteúdo secundário, como um indicador de movimento panorâmico, criado chamando CreateContent.

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 pertencentes 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.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho directmanipulation.h

Confira também

IDirectManipulationCompositor