Visual Classe

Définition

Objet visuel de base dans la hiérarchie visuelle.

public ref class Visual : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Visual : CompositionObject
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Visual : CompositionObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Visual : CompositionObject
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class Visual : CompositionObject
Public Class Visual
Inherits CompositionObject
Héritage
Object Platform::Object IInspectable CompositionObject Visual
Dérivé
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Les objets visuels composent et restituent le contenu de dessin sérialisé et constituent la base d’un système visuel en mode conservé. La classe Visual prend en charge la position et le découpage de base, et peut avoir des transformations 2D et 3D appliquées. Des fonctionnalités supplémentaires telles que des couleurs unie, des images et du contenu avec des effets sont fournies par le biais de sous-classes telles que SpriteVisual ou ContainerVisual, et en définissant la propriété Brush du visuel sur des sous-classes CompositionBrush telles que CompositionColorBrush, CompositionEffectBrush ou CompositionSurfaceBrush.

Les objets visuels sont agiles dans les threads et ne sont pas liés au thread d’interface utilisateur.

Propriétés animatables

Les propriétés suivantes peuvent être animées. Appelez CompositionObject.StartAnimation pour associer la propriété à une CompositionAnimation.

Rotation

Visual prend en charge deux formes de rotation :

  • axe-angle

    La rotation d’angle d’axe utilise les propriétés RotationAngle, RotationAxis et CenterPoint pour spécifier la rotation en degrés, l’axe de rotation autour duquel faire pivoter et le point central du visuel à faire pivoter.

  • orientation

    Rotation par orientation utilise la propriété Orientation pour spécifier un quaternion décrivant une orientation et une rotation dans l’espace 3D.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1703 15063 ParentForTransform
1703 15063 RelativeOffsetAdjustment
1703 15063 RelativeSizeAdjustment

Propriétés

AnchorPoint

Point sur le visuel à positionner au décalage du visuel. La valeur est normalisée par rapport à la taille du visuel. Animatable.

BackfaceVisibility

Spécifie si la face arrière du visuel doit être visible lors d’une transformation 3D.

BorderMode

Spécifie comment composer les bords des bitmaps et des clips associés à un visuel, ou à tous les visuels de la sous-arborescence enracinée sur ce visuel. La définition de BorderMode sur un visuel parent affecte tous les visuels enfants de la sous-arborescence et peut être désactivée de manière sélective sur chaque visuel enfant.

CenterPoint

Point sur lequel la rotation ou la mise à l’échelle se produit. Animatable

Clip

Spécifie la zone de découpage du visuel. Lorsqu’un visuel est affiché, seule la partie du visuel qui se trouve à l’intérieur de la zone de découpage est affichée, tandis que tout contenu qui s’étend en dehors de la zone de découpage est coupé (autrement dit, non affiché).

Comment

Chaîne à associer à l’objet CompositionObject.

(Hérité de CompositionObject)
CompositeMode

Spécifie la façon dont la bitmap d’un visuel est fusionnée avec l’écran.

Compositor

Compositeur utilisé pour créer cet Objet CompositionObject.

(Hérité de CompositionObject)
Dispatcher

Répartiteur de l’objet CompositionObject.

(Hérité de CompositionObject)
DispatcherQueue

Obtient dispatcherQueue pour compostionObject.

(Hérité de CompositionObject)
ImplicitAnimations

Collection d’animations implicites attachées à cet objet.

(Hérité de CompositionObject)
IsHitTestVisible

Obtient ou définit une valeur qui indique si la sous-arborescence visuelle enracinée sur ce visuel participe au test de positionnement.

IsPixelSnappingEnabled

Obtient ou définit une valeur qui indique si le moteur de composition aligne le visuel rendu avec une limite de pixels.

IsVisible

Indique si le visuel et sa sous-arborescence entière de visuels enfants sont visibles.

Offset

Décalage du visuel par rapport à son parent ou, pour un visuel racine, décalage par rapport au coin supérieur gauche des fenêtres qui hébergent le visuel. Animatable.

Opacity

Opacité du visuel. Animatable.

La propriété opacité détermine la transparence, le cas échéant, du visuel et est une valeur comprise entre 0 et 1. 0 est entièrement transparent et 1 est entièrement opaque. Un visuel avec une propriété Opacity de 0 est toujours présent dans l’arborescence. Comme les autres propriétés du visuel, opacité peut être animée à l’aide de l’interface utilisateur Windows. Système d’animation de composition.

Orientation

Quaternion décrivant une orientation et une rotation dans l’espace 3D qui seront appliquées au visuel. Animatable.

Parent

Parent de l’objet visuel.

ParentForTransform

Visuel spécifiant le système de coordonnées dans lequel ce visuel est composé.

Properties

Collection de propriétés associées à CompositionObject.

(Hérité de CompositionObject)
RelativeOffsetAdjustment

Spécifie le décalage du visuel par rapport à la taille de son visuel parent.

RelativeSizeAdjustment

Obtient ou définit la taille du visuel par rapport à la taille de son visuel parent.

RotationAngle

Angle de rotation en radians du visuel. Animatable.

RotationAngleInDegrees

Angle de rotation du visuel en degrés. Animatable.

RotationAxis

Axe autour duquel faire pivoter le visuel. Animatable.

Scale

Échelle à appliquer au visuel.

Size

Largeur et hauteur du visuel. Animatable.

TransformMatrix

Matrice de transformation à appliquer au visuel. Animatable.

Méthodes

Close()

Ferme l’objet CompositionObject et libère les ressources système.

(Hérité de CompositionObject)
ConnectAnimation(String, CompositionAnimation)

Se connecte et animation.

(Hérité de CompositionObject)
DisconnectAnimation(String)

Déconnecte une animation.

(Hérité de CompositionObject)
Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

(Hérité de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Définit une propriété qui peut être animée.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

(Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Démarre un groupe d’animations.

La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe sont démarrées en même temps sur l’objet .

(Hérité de CompositionObject)
StopAnimation(String)

Déconnecte une animation de la propriété spécifiée et arrête l’animation.

(Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Arrête un groupe d’animations.

(Hérité de CompositionObject)
TryGetAnimationController(String)

Renvoie un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée.

(Hérité de CompositionObject)

S’applique à

Voir aussi