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

Article
08/23/2023

Associe le contenu (appartenant à l’appelant) au compositeur, affecte un dispositif de composition au contenu et spécifie la position du contenu dans l’arborescence de composition par rapport à d’autres visuels de composition.

Syntaxe

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

[in, optional] device

Appareil utilisé pour composer le contenu.

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

[in] parentVisual

Visuels parents 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.

Notes

Cette méthode insère une petite arborescence visuelle (appartenant à l’appareil De manipulation directe ) 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. Il peut s’agir de contenu principal, obtenu à partir de la fenêtre d’affichage en appelant GetPrimaryContent, ou de contenu secondaire, tel qu’un indicateur de panoramique, créé en appelant CreateContent.

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 compositeur avec RemoveContent.

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

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

Spécifications


Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	directmanipulation.h

Voir aussi

IDirectManipulationCompositor

Partager via