Compartir a través de

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

  • Artículo

Asocia el contenido (propiedad del autor de la llamada) al compositor, asigna un dispositivo de composición al contenido y especifica la posición del contenido en el árbol de composición en relación con otros objetos visuales de composición.

Sintaxis

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

Parámetros

[in] content

Contenido que se va a agregar al árbol de composición.

el contenido se coloca entre parentVisual y childVisual en el árbol de composición.

[in, optional] device

Dispositivo que se usa para componer el contenido.

Nota el dispositivo lo crea la aplicación.
 

[in] parentVisual

Los objetos visuales primarios del árbol de composición del contenido que se va a agregar.

parentVisual también debe ser un elemento primario de childVisual en el árbol de composición.

[in] childVisual

Objetos visuales secundarios en el árbol de composición del contenido que se va a agregar.

parentVisual también debe ser un elemento primario de childVisual en el árbol de composición.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método inserta un árbol visual pequeño (propiedad del dispositivo de manipulación directa ) entre parentVisual y childVisual. Después, las transformaciones se pueden aplicar al contenido insertado.

Todo el contenido, independientemente del tipo, debe agregarse al compositor. Puede ser contenido principal, obtenido de la ventanilla llamando a GetPrimaryContent o contenido secundario, como un indicador de movimiento panorámico, creado mediante una llamada a CreateContent.

Si la aplicación usa un IDirectManipulationCompositor proporcionado por el sistema:

  • device debe ser un objeto IDCompositionDevice y los objetos visuales primarios y secundarios deben ser objetos IDCompositionVisual .
  • device, parentVisual y childVisual no pueden ser NULL.
  • Los objetos device, parentVisual y childVisual se crean y son propiedad de la aplicación.
  • Cuando se agrega contenido al árbol de composición mediante este método, los nuevos objetos visuales de composición se insertan entre parentVisual y childVisual. Los nuevos objetos visuales no deben destruirse hasta que se desasocien del compositor con RemoveContent.
Si la aplicación usa una implementación personalizada de IDirectManipulationCompositor:
  • device, parentVisual y childVisual deben ser un tipo válido para el compositor. No tienen que ser objetos IDCompositionDevice o IDCompositionVisual .
  • device, parentVisual y childVisual pueden ser NULL, dependiendo del compositor.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado directmanipulation.h

Consulte también

IDirectManipulationCompositor