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

Artículo
08/23/2023

Asocia contenido (propiedad del host de componente) 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. Representa un objeto compositor que asocia contenido manipulado con superficies de dibujo en varios procesos.

Sintaxis

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] 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.

Solo el contenido principal, creado al mismo tiempo que la ventanilla, es válido.

[in] 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.

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.