Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

Visual, classe

Assure la prise en charge du rendu dans WPF, notamment les tests de positionnement, les transformations de coordonnées et les calculs de zones englobantes.

Espace de noms :  System.Windows.Media
Assembly :  PresentationCore (dans PresentationCore.dll)

public abstract class Visual : DependencyObject

Le type Visual expose les membres suivants.

  NomDescription
Méthode protégéeVisualAssure l'initialisation de base des objets dérivés de la classe Visual.
Début

  NomDescription
Propriété publiqueDependencyObjectTypeObtient le DependencyObjectType qui encapsule le type CLR de cette instance.  (Hérité de DependencyObject.)
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueIsSealedRécupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
Propriété protégéeVisualBitmapEffect Obsolète. Obtient ou définit la valeur BitmapEffect du Visual.
Propriété protégéeVisualBitmapEffectInput Obsolète. Obtient ou définit la valeur BitmapEffectInput du Visual.
Propriété protégéeVisualBitmapScalingModeObtient ou définit le BitmapScalingMode de Visual.
Propriété protégéeVisualCacheModeObtient ou définit une représentation mise en cache de Visual.
Propriété protégéeVisualChildrenCountObtient le nombre d'éléments enfants du Visual.
Propriété protégéeVisualClearTypeHintObtient ou définit le ClearTypeHint qui détermine la façon dont ClearType est rendu dans Visual.
Propriété protégéeVisualClipObtient ou définit la zone de découpage du Visual en tant que valeur Geometry.
Propriété protégéeVisualEdgeModeObtient ou définit le mode de bord du Visual en tant que valeur EdgeMode.
Propriété protégéeVisualEffectObtient ou définit l'effet bitmap à appliquer à Visual.
Propriété protégéeVisualOffsetObtient ou définit la valeur de décalage de l'objet visuel.
Propriété protégéeVisualOpacityObtient ou définit l'opacité du Visual.
Propriété protégéeVisualOpacityMaskObtient ou définit la valeur Brush qui représente le masque d'opacité du Visual.
Propriété protégéeVisualParentObtient le parent d'arborescence d'éléments visuels de l'objet visuel.
Propriété protégéeVisualScrollableAreaClipObtient ou définit une zone à défilement découpée pour Visual.
Propriété protégéeVisualTextHintingModeObtient ou définit le TextHintingMode de Visual.
Propriété protégéeVisualTextRenderingModeObtient ou définit le TextRenderingMode de Visual.
Propriété protégéeVisualTransformObtient ou définit la valeur Transform du Visual.
Propriété protégéeVisualXSnappingGuidelinesObtient ou définit la collection d'indications de la coordonnée x (vertical).
Propriété protégéeVisualYSnappingGuidelinesObtient ou définit la collection d'indications de la coordonnée y (horizontal).
Début

  NomDescription
Méthode protégéeAddVisualChildDéfinit la relation parent-enfant entre deux objets visuels.
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(DependencyProperty)Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
Méthode publiqueClearValue(DependencyPropertyKey)Efface la valeur de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject.)
Méthode publiqueCoerceValueForce la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant. (Hérité de DependencyObject.)
Méthode publiqueEqualsDétermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
Méthode protégéeFinalizeAutorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindCommonVisualAncestorRetourne l'ancêtre commun de deux objets visuels.
Méthode publiqueGetHashCodeObtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueGetLocalValueEnumeratorCrée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode protégéeGetVisualChildRetourne le Visual spécifié dans le VisualCollection parent.
Méthode protégéeHitTestCore(GeometryHitTestParameters)Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel.
Méthode protégéeHitTestCore(PointHitTestParameters)Détermine si la valeur de coordonnée d'un point s'inscrit dans les limites de l'objet visuel.
Méthode publiqueInvalidatePropertyRéévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
Méthode publiqueIsAncestorOfDétermine si l'objet visuel est un ancêtre de l'objet visuel descendant.
Méthode publiqueIsDescendantOfDétermine si l'objet visuel est un descendant de l'objet visuel ancêtre.
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeOnPropertyChangedAppelé à chaque fois que la valeur effective d'une propriété de dépendance sur ce DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a été modifiée est signalée dans les données d'événement. (Hérité de DependencyObject.)
Méthode protégéeOnVisualChildrenChangedAppelé lorsque le VisualCollection de l'objet visuel est modifié.
Méthode protégéeOnVisualParentChangedAppelé lorsque le parent de l'objet visuel est modifié.
Méthode publiquePointFromScreenConvertit un Point en coordonnées d'écran en Point qui représente le système de coordonnées actuel du Visual.
Méthode publiquePointToScreenConvertit un Point qui représente le système de coordonnées actuel du Visual en Point en coordonnées d'écran.
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode protégéeRemoveVisualChildSupprime la relation parent-enfant entre deux objets visuels.
Méthode publiqueSetCurrentValueDéfinit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
Méthode publiqueSetValue(DependencyProperty, Object)Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
Méthode publiqueSetValue(DependencyPropertyKey, Object)Définit la valeur de proximité d'une propriété de dépendance en lecture seule, spécifiée par l'identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject.)
Méthode protégéeShouldSerializePropertyRetourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie. (Hérité de DependencyObject.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publiqueTransformToAncestor(Visual)Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'ancêtre Visual spécifié de l'objet visuel.
Méthode publiqueTransformToAncestor(Visual3D)Retourne une transformation qui peut être utilisée pour transformer les coordonnées de Visual en l'ancêtre Visual3D spécifié de l'objet visuel.
Méthode publiqueTransformToDescendantRetourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans le descendant spécifié de l'objet visuel.
Méthode publiqueTransformToVisualRetourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié.
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début

La classe Visual est l'abstraction de base de laquelle dérive chaque objet FrameworkElement. Elle sert également de point d'entrée pour l'écriture de nouveaux contrôles dans WPF et peut être à bien des égards considérée comme un équivalent d'un handle de fenêtre (HWND) dans le modèle d'application Win32.

L'objet Visual est un objet WPF principal; dont le rôle est de fournir une prise en charge du rendu. Les contrôles d'interface utilisateur, tels que Button et TextBox, dérivent de la classe Visual et utilisent les propriétés définies Visual pour rendre leurs données de rendu persistantes. L'objet Visual assure la prise en charge des éléments suivants :

  • L'affichage de sortie : rendu du contenu de dessin sérialisé persistant d'un visuel.

  • Transformations : exécution de transformations sur un objet visuel

  • Le découpage : fourniture d'une prise en charge d'une zone de découpage d'un visuel.

  • Tests d'atteinte : déterminer si une géométrie ou une coordonnée spécifiée (point) s'inscrit dans les limites d'un objet visuel

  • Les calculs du cadre englobant : déterminer le rectangle englobant d'un visuel.

Du point de vue de l'architecture, l'objet Visual n'assure pas la prise en charge d'autres exigences en matière de développement d'applications/fonctionnalités WPF qui ne sont pas immédiatement liées à son rendu, notamment les éléments suivants :

  • Gestion des événements

  • Disposition

  • Styles

  • Liaison des données

  • Globalisation

Visual est fourni en tant que classe abstraite publique à partir de laquelle d'autres classes peuvent être dérivées. L'illustration suivante montre la hiérarchie des objets visuels existants définis dans l'architecture WPF.

Hiérarchie de classe visuelle

Diagramme des classes dérivées de l'objet Visual

Dans certains cas, les membres définis comme étant protégés dans Visual sont exposés en tant que membres plus facilement accessibles avec des noms similaires dans la classe UIElement dérivée.

Pour plus d'informations, consultez Vue d'ensemble du rendu graphique de WPF.

Un Visual comporte un nombre limité de niveaux. Dans les versions précédentes du .NET Framework, cette profondeur maximale était de 255. Cette limite n'est pas adaptée pour certaines dispositions qui ont de nombreux niveaux dans l'arborescence d'éléments visuels.

Dans le .NET Framework 4, la profondeur maximale d'un Visual est 2 047, ce qui permet d'utiliser des arborescences d'éléments visuels beaucoup plus profondes. Dans la plupart des applications, vous ne disposez pas de suffisamment d'espace de pile pour parcourir autant de niveaux, ce qui engendre une exception StackOverflowException lors de la disposition. Pour la taille de pile par défaut, cette exception est généralement levée lorsque la profondeur d'arborescence est d'environ 800, ce qui correspond à approximativement 190 objets TreeViewItem imbriqués.

Si cette exception est levée par votre application et que vous avez besoin d'une arborescence d'éléments visuels plus profonde, vous pouvez augmenter la taille de la pile de l'application. Vous pouvez augmenter la taille de la pile en utilisant l'option /STACK au moment de la compilation ou en utilisant l'utilitaire EDITBIN. L'augmentation de la taille de la pile peut affecter les performances de votre application. Pour plus d'informations, consultez Allocations de la pile et Options EDITBIN.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Afficher: