Microsoft.UI.Composition Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des API pour la composition de l’interface utilisateur.
Classes
| Nom | Description |
|---|---|
| AmbientLight |
Lumière qui illumine tous les visuels ciblés de façon égale. |
| AnimationController |
Fournit des contrôles de lecture pour un KeyFrameAnimation. |
| AnimationPropertyInfo |
Représente des informations sur une propriété qui peut être animée. |
| BackEasingFunction |
Représente une fonction d’accélération qui rétracte légèrement le mouvement d’une animation avant qu’elle ne commence à s’animer dans le chemin indiqué. |
| BooleanKeyFrameAnimation |
Animation basée sur le temps qui cible une propriété booléenne avec une ou plusieurs images clés. |
| BounceEasingFunction |
Représente une fonction d’accélération qui crée un effet de rebond animé. |
| BounceScalarNaturalMotionAnimation |
Animation basée sur la physique de rebond qui cible n’importe quelle propriété scalaire. |
| BounceVector2NaturalMotionAnimation |
Animation basée sur la physique de rebond qui cible n’importe quelle propriété basée sur Vector2. |
| BounceVector3NaturalMotionAnimation |
Animation basée sur la physique de rebond qui cible n’importe quelle propriété basée sur Vector3. |
| CircleEasingFunction |
Représente une fonction d’accélération qui crée une animation qui accélère et/ou décélére à l’aide d’une fonction circulaire. |
| ColorKeyFrameAnimation |
Animation basée sur le temps qui cible la propriété Color avec une ou plusieurs images clés de couleur. La classe ColorKeyFrameAnimation est l’un des types pris en charge de KeyFrameAnimations qui est utilisé pour animer la propriété Color hors de la propriété Brush sur un SpriteVisual. Lorsque vous utilisez ColorKeyFrameAnimation, utilisez Windows. UI. Objets de couleur pour les valeurs des images clés. Utilisez la propriété InterpolationColorSpace pour définir l’espace de couleur que le système interpole pour l’animation. |
| CompositionAnimation |
Représente la classe d’animation de base. |
| CompositionAnimationGroup |
Définit un groupe d’animations. CompositionAnimationGroup fournit un moyen de regrouper les CompositionAnimations dans une liste qui sera démarrée en même temps lorsque StartAnimationGroup est appelé sur CompositionObject. Toute CompositionAnimation dans CompositionAnimationGroup doit affecter une valeur à la propriété Target dans l’animation elle-même. CompositionAnimationGroup peut également être associé à ImplicitAnimationCollection en tant qu’animation qui est exécutée à la suite d’un déclencheur. |
| CompositionApiInformation |
Représente des informations sur les API de composition. |
| CompositionBackdropBrush |
Pinceau qui applique un effet (ou une chaîne d’effets) à la région derrière un SpriteVisual. |
| CompositionBatchCompletedEventArgs |
Arguments pour les événements CompositionCommitBatch.Completed ou CompositionScopedBatch.Completed . |
| CompositionBrush |
Classe de base pour les pinceaux utilisés pour peindre un SpriteVisual. |
| CompositionCapabilities |
Permet de vérifier les fonctionnalités matérielles système afin que les effets de couche visuelle puissent être mis à l’échelle en conséquence. Cela vous permet de vous assurer que l’utilisation d’opérations gourmandes en rendu de votre application est adaptée aux fonctionnalités de l’appareil, offrant des performances optimales et des résultats visuels agréables. |
| CompositionClip |
Classe de base pour les objets de découpage tels que InsetClip. |
| CompositionColorBrush |
Peint un SpriteVisual avec une couleur unie. |
| CompositionColorGradientStop |
Décrit l’emplacement et la couleur d’un point de transition dans un dégradé. |
| CompositionColorGradientStopCollection |
Représente une collection d’objets CompositionColorGradientStop accessibles individuellement par index. |
| CompositionCommitBatch |
Groupe d’animations ou d’effets actifs. |
| CompositionContainerShape |
Représente un conteneur pour CompositionShapes, utilisé pour regrouper les éléments qui partagent des transformations 2D. |
| CompositionDrawingSurface |
Surface de dessin pour l’interopérabilité avec Direct2D ou Direct3D. |
| CompositionEasingFunction |
Classe de base pour les fonctions d’interpolateur à utiliser avec KeyFrameAnimations. La classe CompositionEasingFunction est la classe de base pour les fonctions d’accélération utilisées avec keyFrameAnimation s. Les fonctions d’accélération sont utilisées pour décrire comment le système interpole entre deux images clés différentes. Actuellement, il existe trois fonctions d’accélération prises en charge : Linéaire, Bezier cube et Étape. |
| CompositionEffectBrush |
Peint un SpriteVisual avec la sortie d’un effet de filtre. La description de l’effet de filtre est définie à l’aide de la classe CompositionEffectFactory . |
| CompositionEffectFactory |
Crée un objet de composition qui contient un format de description d’effet Win2D dans le Microsoft. Espace de noms Graphics.Canvas.Effects (SDK d'application Windows (WinUI 3) / UWP (WinUI 2)). Note Les effets qui ne sont pas pris en charge sont marqués comme [NoComposition] dans la référence de l’API Win2D pour l’espace de noms d’effets. |
| CompositionEffectSourceParameter |
Utilisé pour déclarer un nom arbitraire (une chaîne) à associer à un Objet CompositionBrush (la « source d’effet »). L’association du nom donné et de la source d’effet se produit lorsque la méthode SetSourceParameter d’un CompositionEffectBrush est appelée. |
| CompositionEllipseGeometry |
Représente un ellipse avec le centre et le rayon spécifiés. |
| CompositionEngine |
Fournit des méthodes statiques pour sélectionner et récupérer des moteurs de composition. Il s’agit d’une fonctionnalité d’accès limité instable (LAF) qui permet aux applications d’opter pour l’utilisation du système d’exploitation comme moteur pour les API composition, plutôt que le moteur in-process par défaut. |
| CompositionGeometricClip |
Représente une forme qui extrait une partie d’un visuel. La partie visible du visuel est une forme définie par une CompositionGeometry. La partie du visuel en dehors de la géométrie est clippée. |
| CompositionGeometry |
Représente la classe de base pour les géométries de composition. |
| CompositionGradientBrush |
Représente un pinceau qui décrit un dégradé composé d’arrêts de dégradé. CompositionGradientBrush est pris en charge uniquement avec Rgb et RgbLinear CompositionColorSpace. |
| CompositionGraphicsDevice |
Permet de créer toutes les ressources liées au matériel pour un appareil DirectX donné sur une session de compositeur. CompositionGraphicsDevice contient un appareil DirectX utilisé pour effectuer les opérations GPU. Les développeurs peuvent obtenir un appareil Graphics à partir de l’objet de niveau supérieur du compositeur. |
| CompositionLight |
Classe de base pour une source lumineuse qui peut cibler une scène d’interface utilisateur. La propriété CompositionLight.Targets détermine les visuels qui sont allumés. |
| CompositionLinearGradientBrush |
Représente un pinceau qui peint une zone avec un dégradé linéaire. |
| CompositionLineGeometry |
Représente une ligne droite entre deux points. |
| CompositionMaskBrush |
Peint un SpriteVisual avec un CompositionBrush avec un masque d’opacité appliqué à celui-ci. La source du masque d’opacité peut être n’importe quel CompositionBrush de type CompositionColorBrush, CompositionLinearGradientBrush, CompositionSurfaceBrush, CompositionEffectBrush ou CompositionNineGridBrush. Le masque d’opacité doit être spécifié en tant que CompositionSurfaceBrush. |
| CompositionMipmapSurface |
Représente une surface de dessin pour les textures mipmap. |
| CompositionNineGridBrush |
Peint un spriteVisual avec un objet CompositionBrush après avoir appliqué Nine-Grid stretching au contenu du pinceau source. La source de l’étirement de neuf grilles peut par n’importe quel compositionBrush de type CompositionColorBrush, CompositionSurfaceBrush ou compositionEffectBrush. |
| CompositionNotificationDeferral |
Représente un report qui peut être utilisé par une application pour répondre de manière asynchrone à une notification de composition. |
| CompositionObject |
Classe de base de l’API de composition représentant un nœud dans la structure de l’arborescence visuelle. Les objets de composition sont la structure d’arborescence visuelle sur laquelle toutes les autres fonctionnalités de l’API de composition utilisent et s’appuient. L’API permet aux développeurs de définir et de créer un ou plusieurs objets visuels représentant chacun un nœud unique dans une arborescence de visuels. |
| CompositionPath |
Représente une série de lignes et de courbes connectées. |
| CompositionPathGeometry |
Représente une série de lignes et de courbes connectées. |
| CompositionProjectedShadow |
Représente une ombre basée sur une scène calculée à l’aide de la relation entre la lumière, le visuel qui caste l’ombre et le visuel qui reçoit l’ombre, de sorte que l’ombre est dessinée différemment sur chaque récepteur. |
| CompositionProjectedShadowCaster |
Représente un objet qui caste une ombre projetée. |
| CompositionProjectedShadowCasterCollection |
Représente une collection d’objets CompositionProjectedShadowCaster. |
| CompositionProjectedShadowReceiver |
Représente un objet qui peut avoir un cliché instantané projeté sur celui-ci. |
| CompositionProjectedShadowReceiverUnorderedCollection |
Représente une collection non ordonnée d’objets CompositionProjectedShadowReceiver. |
| CompositionPropertySet |
Stocke les valeurs en tant que paires clé-valeur. |
| CompositionRadialGradientBrush |
Représente un pinceau qui peint une zone avec un dégradé radial. |
| CompositionRectangleGeometry |
Représente une forme de rectangle de la taille spécifiée. |
| CompositionRoundedRectangleGeometry |
Représente une forme de rectangle de la taille spécifiée avec des angles arrondis. |
| CompositionScopedBatch |
Groupe explicitement créé d’animations ou d’effets actifs. |
| CompositionShadow |
Classe de base pour les ombres qui peuvent être appliquées à un SpriteVisual. |
| CompositionShape |
Représente la classe de forme de base. |
| CompositionShapeCollection |
Représente une collection d’objets CompositionShape accessibles individuellement par index. |
| CompositionSpriteShape |
CompositionShape qui dessine Stroked et Filled CompositionGeometry. |
| CompositionStrokeDashArray |
Représente une collection de valeurs qui indique le modèle de tirets et d’écarts utilisés pour décrire les formes. |
| CompositionSurfaceBrush |
Peint un SpriteVisual avec des pixels d’une ICompositionSurface. |
| CompositionTransform |
Fournit une prise en charge généralisée des transformations pour les objets de composition. |
| CompositionViewBox |
Représente un conteneur qui mappe les coordonnées de l’arborescence visuelle de forme sur le visuel. |
| CompositionVirtualDrawingSurface |
Représente des bitmaps partiellement allouées qui peuvent être associées à des visuels pour la composition dans une arborescence visuelle. |
| CompositionVisualSurface |
Représente une arborescence visuelle sous forme d’ICompositionSurface qui peut être utilisée pour peindre un visuel à l’aide d’un objet CompositionBrush. |
| Compositor |
Gère la session entre une application et le processus de compositeur système. La classe Compositor crée une instance du compositor pour l’application qui peut être utilisée comme fabrique pour divers types dans le Microsoft. UI. Espace de noms de composition couvrant la couche visuelle, le système d’effets et le système d’animation. La classe Compositor gère également le cycle de vie des objets créés par l'usine. |
| ContainerVisual |
Nœud dans l’arborescence visuelle qui peut avoir des enfants. |
| CubicBezierEasingFunction |
Représente une fonction cube-bezier permettant d’interpoler entre des images clés d’animation. La fonction cube-bezier est l’une des fonctions d’accélération les plus courantes utilisées avec keyFrameAnimations et sont fréquemment utilisées pour décrire les courbes lisses qui peuvent être mises à l’échelle. Les fonctions cube-bezier sont définies par deux « points de contrôle » de type Vector2 qui définissent la forme de la courbe. Lorsqu’elle est utilisée, la propriété d’animation change entre deux images clés en fonction de la courbe définie. |
| DistantLight |
Source de lumière infiniment distante qui émet la lumière dans une direction unique. Par exemple, une lumière distante peut être utilisée pour représenter la lumière du soleil. |
| DropShadow |
Ombre portée par un SpriteVisual ou LayerVisual. |
| ElasticEasingFunction |
Représente une fonction d’accélération qui crée une animation qui ressemble à un printemps oscillant de retour et d’avant jusqu’au repos. |
| ExponentialEasingFunction |
Représente une fonction d’accélération qui crée une animation qui accélère et/ou décélérée à l’aide d’une formule exponentielle. |
| ExpressionAnimation |
Animation de composition qui utilise une équation mathématique pour calculer la valeur d’une propriété d’animation chaque image. |
| ImplicitAnimationCollection |
Collection d’animations déclenchée lorsqu’une condition est remplie. |
| InitialValueExpressionCollection |
Collection de valeurs qui spécifient l’emplacement de démarrage d’une animation. |
| InsetClip |
Représente un rectangle qui extrait une partie d’un visuel. La partie du visuel à l’intérieur du rectangle est visible ; la partie du visuel en dehors du rectangle est clippée. |
| KeyFrameAnimation |
Animation basée sur le temps avec une ou plusieurs images clés. Ces images sont des marqueurs, ce qui permet aux développeurs de spécifier des valeurs à des moments spécifiques pour la propriété d’animation. Les animations d’images clés peuvent être personnalisées en spécifiant la façon dont l’animation interpole entre les images clés. |
| LayerVisual |
ConteneurVisual dont les enfants sont aplati en une seule couche. |
| LinearEasingFunction |
Représente une fonction linéaire pour l’interpolation entre les images clés d’animation. |
| NaturalMotionAnimation |
Représente une animation basée sur la physique qui utilise des forces pour déplacer dynamiquement le contenu. |
| PathKeyFrameAnimation |
Représente une animation basée sur le temps avec une ou plusieurs images clés où chaque valeur d’image clé est représentée par un Objet CompositionPath. L’accélération spécifie l’interopole entre les chemins. |
| PointLight |
Source de lumière qui émane de la lumière dans toutes les directions. |
| PowerEasingFunction |
Représente une fonction d’accélération qui crée une animation qui accélère et/ou décélére à l’aide de la formule f(t) = tp où p est égal à la |
| QuaternionKeyFrameAnimation |
Animation basée sur le temps qui cible la propriété Orientation avec une ou plusieurs images clés. La classe QuaternionKeyFrameAnimation est l’un des types pris en charge de KeyFrameAnimations qui est utilisé pour animer la propriété Orientation sur un visuel. Les quaternions sont un moyen utile et parfois plus simple de réfléchir à des rotations : les quaternions prennent le chemin le plus court entre les angles et évitent les problèmes tels que Gimbal Lock que les matrices de rotation et d’angle de rotation s’exécutent. Un Quaternion est constitué de deux composants : une partie scalaire et vectorielle. |
| RectangleClip |
Représente un rectangle avec des angles arrondis facultatifs qui clipsent une partie d’un visuel. La partie du visuel à l’intérieur du rectangle est visible ; la partie du visuel en dehors du rectangle est clippée. |
| RedirectVisual |
Représente un visuel qui obtient son contenu d’un autre visuel. |
| RenderingDeviceReplacedEventArgs |
Arguments de l’événement RenderingDeviceReplaced . |
| ScalarKeyFrameAnimation |
Animation basée sur le temps qui cible n’importe quelle propriété scalaire avec une ou plusieurs images clés. |
| ScalarNaturalMotionAnimation |
Base Scalar NaturalMotionAnimation utilisée pour cibler une propriété Scalar. |
| ShapeVisual |
Représente un nœud d’arborescence visuel qui est la racine d’une CompositionShape. |
| SineEasingFunction |
Représente une fonction d’accélération qui crée une animation qui accélère et/ou décélérée à l’aide d’une formule sinusoïque. |
| SpotLight |
Source de lumière qui caste les cônes internes et externes de la lumière. Par exemple, une lampe de poche. |
| SpringScalarNaturalMotionAnimation |
Animation basée sur la physique du printemps qui cible n’importe quelle propriété scalaire. |
| SpringVector2NaturalMotionAnimation |
Animation basée sur la physique du printemps qui cible n’importe quelle propriété basée sur Vector2. |
| SpringVector3NaturalMotionAnimation |
Animation basée sur la physique du printemps qui cible n’importe quelle propriété basée sur Vector3. |
| SpriteVisual |
Héberge le contenu boxed 2D de type CompositionBrush. Toute partie du visuel non couvert par des pixels du pinceau est restituée sous forme de pixels transparents. CompositionBrush peut être compositionBackdropBrush, CompositionColorBrush, compositionSurfaceBrush ou compositionEffectBrush. |
| StepEasingFunction |
Fonction d’étape permettant d’interpoler entre des images clés d’animation. Avance les animations par incréments, comme les étapes qui peuvent être définies. Les comportements pour les étapes initiales et finales peuvent être personnalisés. |
| Vector2KeyFrameAnimation |
Animation basée sur le temps qui cible n’importe quelle propriété basée sur Vector2 avec une ou plusieurs images clés. |
| Vector2NaturalMotionAnimation |
Vector2 NaturalMotionAnimation de base utilisé pour cibler une propriété Vector2. |
| Vector3KeyFrameAnimation |
Animation basée sur le temps qui cible n’importe quelle propriété basée sur Vector3 avec un ou plusieurs images clés. |
| Vector3NaturalMotionAnimation |
Vector3 NaturalMotionAnimation de base utilisé pour cibler une propriété Vector3. |
| Vector4KeyFrameAnimation |
Animation basée sur le temps qui cible n’importe quelle propriété basée sur Vector4 avec un ou plusieurs images clés. |
| Visual |
Objet visuel de base dans la hiérarchie visuelle. |
| VisualCollection |
Représente une collection d’instances visuelles. |
| VisualUnorderedCollection |
Collection non ordonnée de visuels. |
Interfaces
| Nom | Description |
|---|---|
| IAnimationObject |
Représente un objet qui a des propriétés qui peuvent être référencées par une animation. |
| ICompositionAnimationBase |
Classe de base pour les animations de composition. |
| ICompositionSupportsSystemBackdrop |
Fournit une propriété permettant d’utiliser un CompositionBrush en tant que toile de fond système. Un SpriteVisual avec la compositionBrush donnée sera placé à l’arrière de la sous-arborescence de l’objet d’implémentation. |
| ICompositionSurface |
Représente le contenu d’une surface qui peut être utilisée pour peindre les limites d’un |
| ICompositionSurfaceFacade |
Représente un espace réservé pour une surface de composition qui peut être utilisée comme une surface de composition réelle. |
| IVisualElement |
Marque un objet pour indiquer au système qu’il peut résoudre en visuel de composition |
| IVisualElement2 |
Fournit une méthode qui récupère le visuel sous-jacent d’un objet. |
Énumérations
| Nom | Description |
|---|---|
| AnimationControllerProgressBehavior |
Définit des constantes qui spécifient la façon dont la valeur AnimationController.Progress est déterminée. |
| AnimationDelayBehavior |
Spécifie le comportement du délai d’animation. |
| AnimationDirection |
Spécifie la direction de lecture d’une animation. |
| AnimationIterationBehavior |
Spécifie si l’animation doit effectuer une boucle. |
| AnimationPropertyAccessMode |
Définit des constantes qui spécifient la façon dont une propriété animée est accessible. |
| AnimationStopBehavior |
Spécifie le comportement d’une animation lorsqu’elle s’arrête. |
| CompositionBackfaceVisibility |
Spécifie si la face arrière d’un visuel est visible pendant une transformation 3D. |
| CompositionBatchTypes |
Types batch pour CompositionCommitBatch et CompositionScopedBatch. |
| CompositionBitmapInterpolationMode |
Spécifie l’algorithme utilisé pour interpoler des pixels à partir d’ICompositionSurface lorsqu’ils ne forment pas de mappage un-à-un sur des pixels à l’écran. |
| CompositionBorderMode |
Contrôle le comportement d’alias sur les bords des bordures visuelles. |
| CompositionColorSpace |
Spécifie l’espace de couleur pour interpoler les valeurs de couleur dans ColorKeyFrameAnimation. |
| CompositionCompositeMode |
Détermine comment le contenu d’un visuel non opaque est fusionné avec le contenu en arrière-plan derrière le visuel. |
| CompositionDropShadowSourcePolicy |
Spécifie la stratégie de masquage d’une ombre. |
| CompositionEasingFunctionMode |
Définit des constantes qui spécifient la façon dont l’animation associée à une fonction d’accélération interpole. |
| CompositionEffectFactoryLoadStatus |
État de la compilation asynchrone d’un nuanceur pour une description d’effet. |
| CompositionEngineType |
Définit le type de moteur de composition à utiliser pour les API Composition. |
| CompositionGetValueStatus |
Indique le résultat d’une tentative de récupération de la valeur d’une paire clé-valeur. |
| CompositionGradientExtendMode |
Définit des constantes qui spécifient comment dessiner le dégradé en dehors du vecteur ou de l’espace de dégradé du pinceau. |
| CompositionMappingMode |
Définit des constantes qui spécifient si les coordonnées de positionnement du pinceau dégradé (StartPoint, EndPoint) sont absolues ou relatives à la zone de sortie. |
| CompositionProjectedShadowDrawOrder |
Fournit des API pour la composition de l’interface utilisateur. |
| CompositionStretch |
Spécifie la façon dont le contenu est mis à l’échelle lorsqu’il est mappé de sa source à un espace de destination. |
| CompositionStrokeCap |
Définit des constantes qui spécifient la forme à la fin d’une ligne ou d’un segment. |
| CompositionStrokeLineJoin |
Définit des constantes qui spécifient la forme utilisée pour joindre deux lignes ou segments. |
Remarques
Windows. Interface utilisateur. Vue d’ensemble de la composition, exemples et problèmes connus
| Élément | Description |
|---|---|
| Windows. UI. Vue d’ensemble de la composition | Vue d’ensemble et architecture de l’API |
| Windows. UI. Exemples de composition | Exemples d’API dans github officiel |
| Problèmes connus et informations les plus récentes | Dernières mises à jour sur l’API dans les forums MSDN |