Visual Classe
Définition
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.
Objet visuel de base dans la hiérarchie visuelle.
[WebHostHidden]
public ref class Visual : CompositionObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class Visual : CompositionObject[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class Visual : CompositionObjectPublic Class Visual
Inherits CompositionObject- Héritage
- Dérivé
- Attributs
Remarques
Les objets visuels composent et affichent du 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 à ces dernières. Des fonctionnalités supplémentaires telles que des couleurs unie, des images et du contenu avec des effets sont fournies via des sous-classes telles que SpriteVisual ou ContainerVisual, et en définissant la propriété Brush du visuel sur compositionBrush sous-classes telles que CompositionColorBrush, CompositionEffectBrush ou CompositionSurfaceBrush.
Les objets visuels sont agiles de thread 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.
- Taille
- Décalage
- Opacité
- Orientation
- CenterPoint
- RotationAngle
- RotationAngleInDegrees
- Axe de Rotation
- Matrix de transformation
Rotation
Visual prend en charge deux formes de rotation :
axe-angle
La rotation d’angle de l’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 pour le faire pivoter.
orientation
La rotation par orientation utilise la propriété Orientation pour spécifier un quaternion décrivant une orientation et une rotation dans l’espace 3D.
Propriétés
| Nom | Description |
|---|---|
| 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 pendant une transformation 3D. |
| BorderMode |
Spécifie comment composer les bords des bitmaps et des clips associés à un visuel, ou avec tous les visuels de la sous-arborescence enracinée dans 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 à chaque visuel enfant. |
| CenterPoint |
Point sur lequel la rotation ou la mise à l’échelle se produit. Animatable |
| Clip |
Spécifie la région de découpage du visuel. Lorsqu’un visuel est rendu, seule la partie du visuel qui se trouve à l’intérieur de la zone de découpage s’affiche, tandis que tout contenu qui s’étend en dehors de la région de découpage est clippé (autrement dit, non affiché). |
| Comment |
Chaîne à associer au CompositionObject. (Hérité de CompositionObject) |
| CompositeMode |
Spécifie comment la bitmap d’un visuel est fusionnée avec l’écran. |
| Compositor |
Compositor utilisé pour créer ce CompositionObject. (Hérité de CompositionObject) |
| DispatcherQueue |
Obtient le DispatcherQueue pour CompositionObject. (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 dans ce visuel participe aux tests 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 des visuels enfants sont visibles. |
| Offset |
Décalage du visuel par rapport à son parent ou pour un visuel racine, le décalage par rapport au coin supérieur gauche des fenêtres qui héberge le visuel. Animatable. |
| Opacity |
Opacité du visuel. Animatable. La propriété d’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 d’autres propriétés sur le visuel, l’opacité peut être animée à l’aide du Windows,interface utilisateur. Système d’animation de composition. |
| Orientation |
Quaternion décrivant une orientation et une rotation dans l’espace 3D qui sera appliqué au visuel. Animatable. |
| Parent |
Parent du 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
| Nom | Description |
|---|---|
| Close() |
Ferme les ressources système CompositionObject et libère. (Hérité de CompositionObject) |
| Dispose() |
Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation 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) |
Retourne un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée. (Hérité de CompositionObject) |