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

Article
08/23/2023

Associe le contenu (appartenant à l’hôte du composant) au compositeur, affecte un périphérique de composition au contenu et spécifie la position du contenu dans l’arborescence de composition par rapport à d’autres visuels de composition. Représente un objet compositor qui associe du contenu manipulé à des surfaces de dessin sur plusieurs processus.

Syntaxe

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] IUnknown                          *device,
  [in] IUnknown                          *parentVisual,
  [in] IUnknown                          *childVisual
);

Paramètres

[in] content

Contenu à ajouter à l’arborescence de composition.

le contenu est placé entre parentVisual et childVisual dans l’arborescence de composition.

Seul le contenu principal, créé en même temps que la fenêtre d’affichage, est valide.

[in] device

Appareil utilisé pour composer le contenu.

Notez quel’appareil est créé par l’application.

[in] parentVisual

Visuels parent dans l’arborescence de composition du contenu ajouté.

parentVisual doit également être un parent de childVisual dans l’arborescence de composition.

[in] childVisual

Visuels enfants dans l’arborescence de composition du contenu ajouté.

parentVisual doit également être un parent de childVisual dans l’arborescence de composition.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode insère une petite arborescence visuelle (appartenant à l’appareil Direct Manipulation ) entre parentVisual et childVisual. Les transformations peuvent ensuite être appliquées au contenu inséré.

Tout le contenu, quel que soit son type, doit être ajouté au compositeur.

Si l’application utilise un IDirectManipulationCompositor fourni par le système :

l’appareil doit être un objet IDCompositionDevice , et les visuels parents et enfants doivent être des objets IDCompositionVisual .
device, parentVisual et childVisual ne peuvent pas être NULL.
les objets device, parentVisual et childVisual sont créés et détenus par l’application.
Lorsque du contenu est ajouté à l’arborescence de composition à l’aide de cette méthode, les nouveaux visuels de composition sont insérés entre parentVisual et childVisual. Les nouveaux visuels ne doivent pas être détruits tant qu’ils ne sont pas dissociés du compositor avec RemoveContent.

Si l’application utilise une implémentation personnalisée de IDirectManipulationCompositor :

device, parentVisual et childVisual doivent être un type valide pour le compositor. Ils ne doivent pas être des objets IDCompositionDevice ou IDCompositionVisual .
device, parentVisual et childVisual peuvent avoir la valeur NULL, en fonction du compositeur.

Les événements de pointeur inter-processus (WM_POINTERROUTEDAWAY, WM_POINTERROUTEDRELEASED et WM_POINTERROUTEDTO) doivent être gérés de manière appropriée.