Share via

IDCompositionVisual ::SetContent, méthode (dcomp.h)

  • Article

Définit la propriété Content de ce visuel sur la bitmap ou le wrapper de fenêtre spécifié.

Syntaxe

HRESULT SetContent(
  [in, optional] IUnknown *content
);

Paramètres

[in, optional] content

Type : IUnknown*

Objet qui est le nouveau contenu de ce visuel. Ce paramètre peut être NULL.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Le paramètre content doit pointer vers l’un des éléments suivants :

Le nouveau contenu remplace tout contenu précédemment associé au visuel. Si le paramètre content a la valeur NULL, le visuel n’a aucun contenu associé.

Un visuel peut être associé à un objet bitmap ou à un wrapper de fenêtre. Une bitmap est une chaîne d’échange Microsoft DirectX ou une surface Microsoft DirectComposition.

Un wrapper de fenêtre est créé avec la méthode CreateSurfaceFromHwnd et est un support pour la rastérisation d’une autre fenêtre, qui doit être une fenêtre de niveau supérieur ou une fenêtre enfant superposée. Un wrapper de fenêtre est conceptuellement équivalent à une bitmap qui correspond à la taille de la fenêtre cible sur laquelle le contenu de la fenêtre est dessiné. Le contenu inclut les fenêtres enfants de la fenêtre cible (superposées ou non) et tout contenu DirectComposition dessiné dans les fenêtres enfants.

Un wrapper de surface DirectComposition est créé avec la méthode CreateSurfaceFromHandle et est une référence à une chaîne d’échange. Une application peut utiliser un wrapper de surface dans un scénario inter-processus où un processus crée la chaîne d’échange et un autre processus associe la bitmap à un visuel.

La bitmap est toujours dessinée à la position (0,0) par rapport au système de coordonnées du visuel, bien que le système de coordonnées soit directement affecté par les propriétés OffsetX, OffsetY et Transform, ainsi qu’indirectement par les transformations sur les visuels ancêtres. La bitmap d’un visuel est toujours dessinée derrière les enfants de ce visuel.

Configuration requise

Condition requise Valeur
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 dcomp.h
Bibliothèque Dcomp.lib
DLL Dcomp.dll

Voir aussi

IDCompositionVisual

IDXGIFactory2 ::CreateSwapChain1