IDCompositionVisual ::SetContent, méthode (dcomp.h)
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 :
- Objet qui implémente l’interface IDCompositionSurface .
- Objet qui implémente l’interface IDXGISwapChain1 .
- Objet wrapper retourné par la méthode CreateSurfaceFromHandle ou CreateSurfaceFromHwnd .
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
IDXGIFactory2 ::CreateSwapChain1