Visual Classe

Référence

Définition

Espace de noms:: System.Windows.Media

Assembly:: PresentationCore.dll

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 la prise en charge du rendu dans WPF, qui inclut les tests de positionnement, les transformations de coordonnées et les calculs de zones englobantes.

public ref class Visual abstract : System::Windows::DependencyObject

public abstract class Visual : System.Windows.DependencyObject

type Visual = class
    inherit DependencyObject
    interface DUCE.IResource

type Visual = class
    inherit DependencyObject

Public MustInherit Class Visual
Inherits DependencyObject

Héritage: Object

DispatcherObject

DependencyObject
Visual

Dérivé: System.Windows.Media.ContainerVisual

System.Windows.Media.Media3D.Viewport3DVisual

System.Windows.UIElement

Remarques

La Visual classe est l’abstraction de base dont chaque FrameworkElement objet dérive. Il sert également de point d’entrée pour l’écriture de nouveaux contrôles dans WPF, et peut être considéré à bien des égards 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 principal est de fournir la prise en charge du rendu. Les contrôles d’interface utilisateur, tels que Button et TextBox, dérivent de la Visual classe et utilisent les Visual propriétés définies pour conserver leurs données de rendu. L’objet Visual prend en charge les éléments suivants :

Affichage de sortie : rendu du contenu de dessin sérialisé persistant d’un objet visuel.
Transformations : exécution de transformations sur un objet visuel.
Détourage : prise en charge de la zone de détourage d’un objet visuel.
Test de positionnement : déterminer si une coordonnée (point) ou une géométrie spécifiée est contenue dans les limites d’un visuel.
Calculs de rectangle englobant : détermination du rectangle englobant d’un objet visuel.

D’un point de vue architectural, l’objet Visual n’inclut pas la prise en charge d’autres exigences de développement d’applications ou de fonctionnalités WPF qui ne sont pas immédiatement liées à son rendu, telles que les suivantes :

Gestion des événements
Layout
Styles
Liaison de 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 qui sont définis dans l’architecture WPF.

Diagramme des classes dérivées de l’objet Visual
Hiérarchie de classe d’objet visuel

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

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

A Visual un nombre limité de niveaux. Dans les versions précédentes du .NET Framework, cette profondeur maximale était de 255. Cette limite est insuffisante pour certaines dispositions qui ont de nombreux niveaux dans l’arborescence visuelle.

Dans .NET Framework 4, la profondeur maximale d’un Visual est 2047, ce qui permet d’obtenir des arborescences visuelles beaucoup plus profondes. Dans la plupart des applications, il n’y a pas suffisamment d’espace de pile pour parcourir autant de niveaux, et le résultat est une StackOverflowException disposition pendant. Pour la taille de pile par défaut, cette exception est généralement levée lorsque la profondeur de l’arborescence est d’environ 800, ce qui correspond à environ 190 objets imbriqués TreeViewItem .

Si cette exception est levée par votre application et que vous devez disposer d’une arborescence visuelle plus profonde, vous pouvez augmenter la taille de la pile de l’application. Vous pouvez augmenter la taille de la pile à l’aide de l’option /STACK au moment de la compilation ou à l’aide de 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 pile et Options EDITBIN.

Constructeurs

Visual()

Assure l'initialisation de base des objets dérivés de la classe Visual.

Propriétés

DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
VisualBitmapEffect	Obsolète. Obsolète. Obtient ou définit la valeur BitmapEffect du Visual.
VisualBitmapEffectInput	Obsolète. Obsolète. Obtient ou définit la valeur BitmapEffectInput du Visual.
VisualBitmapScalingMode	Obtient ou définit BitmapScalingMode pour Visual.
VisualCacheMode	Obtient ou définit la représentation mise en cache de Visual.
VisualChildrenCount	Obtient le nombre d'éléments enfants du Visual.
VisualClearTypeHint	Obtient ou définit le ClearTypeHint qui détermine la façon dont ClearType est rendu dans Visual.
VisualClip	Obtient ou définit la zone de découpage du Visual en tant que valeur Geometry.
VisualEdgeMode	Obtient ou définit le mode de bord du Visual en tant que valeur EdgeMode.
VisualEffect	Obtient ou définit l'effet bitmap à appliquer à Visual.
VisualOffset	Obtient ou définit la valeur de décalage de l'objet visuel.
VisualOpacity	Obtient ou définit l'opacité du Visual.
VisualOpacityMask	Obtient ou définit la valeur Brush qui représente le masque d'opacité du Visual.
VisualParent	Obtient le parent d'arborescence d'éléments visuels de l'objet visuel.
VisualScrollableAreaClip	Obtient ou définit une zone à défilement découpée pour Visual.
VisualTextHintingMode	Obtient ou définit le TextHintingMode de Visual.
VisualTextRenderingMode	Obtient ou définit le TextRenderingMode de Visual.
VisualTransform	Obtient ou définit la valeur Transform du Visual.
VisualXSnappingGuidelines	Obtient ou définit la collection d’indications de coordonnée X (verticale).
VisualYSnappingGuidelines	Obtient ou définit la collection d’indications de coordonnée y (horizontale).

Méthodes

AddVisualChild(Visual)	Définit la relation parent-enfant entre deux objets visuels.
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Retourne l'ancêtre commun de deux objets visuels.
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Cré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)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
GetVisualChild(Int32)	Retourne le Visual spécifié dans le VisualCollection parent.
HitTestCore(GeometryHitTestParameters)	Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel.
HitTestCore(PointHitTestParameters)	Détermine si la valeur de coordonnée d'un point s'inscrit dans les limites de l'objet visuel.
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
IsAncestorOf(DependencyObject)	Détermine si l'objet visuel est un ancêtre de l'objet visuel descendant.
IsDescendantOf(DependencyObject)	Détermine si l'objet visuel est un descendant de l'objet visuel ancêtre.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDpiChanged(DpiScale, DpiScale)	Appelé en cas de modification des ppp d’affichage de cette Vue.
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Méthode appelée 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 changé est signalée dans les données d’événement. (Hérité de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Appelé lorsque le VisualCollection de l'objet visuel est modifié.
OnVisualParentChanged(DependencyObject)	Appelé lorsque le parent de l'objet visuel est modifié.
PointFromScreen(Point)	Convertit un Point en coordonnées d'écran en Point qui représente le système de coordonnées actuel du Visual.
PointToScreen(Point)	Convertit un Point qui représente le système de coordonnées actuel du Visual en Point en coordonnées d'écran.
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
RemoveVisualChild(Visual)	Supprime la relation parent-enfant entre deux objets visuels.
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale 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)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TransformToAncestor(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.
TransformToAncestor(Visual3D)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'ancêtre Visual3D spécifié de l'objet visuel.
TransformToDescendant(Visual)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans le descendant spécifié de l'objet visuel.
TransformToVisual(Visual)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié.
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

S’applique à

Partager via