Método IDirectManipulationCompositor2::AddContentWithCrossProcessChaining (directmanipulation.h)
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.
HRESULT AddContentWithCrossProcessChaining(
[in] IDirectManipulationPrimaryContent *content,
[in] IUnknown *device,
[in] IUnknown *parentVisual,
[in] IUnknown *childVisual
);
[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.
[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.
Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
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.
- 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.
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | directmanipulation.h |