Visual Classe

Définition

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.Provides rendering support in WPF, which includes hit testing, coordinate transformation, and bounding box calculations.

public ref class Visual abstract : System::Windows::DependencyObject
public abstract class Visual : System.Windows.DependencyObject
type Visual = class
    inherit DependencyObject
type Visual = class
    inherit DependencyObject
    interface DUCE.IResource
Public MustInherit Class Visual
Inherits DependencyObject
Héritage
Dérivé

Remarques

La classe Visual est l’abstraction de base à partir de laquelle dérive chaque objet FrameworkElement.The Visual class is the basic abstraction from which every FrameworkElement object derives. Il sert également de point d’entrée pour l’écriture de nouveaux contrôles dans WPFWPF, et à de nombreux égards, il peut être considéré comme équivalent d’un handle de fenêtre (HWND) dans le modèle d’application Win32Win32.It also serves as the entry point for writing new controls in WPFWPF, and in many ways can be thought of as an equivalent of a window handle (HWND) in the Win32Win32 application model.

L’objet Visual est un objet WPFWPF principal, dont le rôle principal est de fournir la prise en charge du rendu.The Visual object is a core WPFWPF object, whose primary role is to provide rendering support. 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 par l' Visual pour rendre persistantes leurs données de rendu.User interface controls, such as Button and TextBox, derive from the Visual class, and use the Visual defined properties for persisting their rendering data. L’objet Visual prend en charge les éléments suivants :The Visual object provides support for the following:

  • Affichage de sortie : rendu du contenu de dessin sérialisé persistant d’un objet visuel.Output display: Rendering the persisted, serialized drawing content of a visual.

  • Transformations : exécution de transformations sur un objet visuel.Transformations: Performing transformations on a visual.

  • Détourage : prise en charge de la zone de détourage d’un objet visuel.Clipping: Providing clipping region support for a visual.

  • Test de positionnement : déterminer si une géométrie (point) ou une géométrie spécifiée est contenue dans les limites d’un visuel.Hit testing: Determining whether a specified coordinate (point) or geometry is contained within the bounds of a visual.

  • Calculs de rectangle englobant : détermination du rectangle englobant d’un objet visuel.Bounding box calculations: Determining the bounding rectangle of a visual.

D’un point de vue architectural, l’objet Visual n’inclut pas la prise en charge d’autres spécifications de développement d’applications/WPFWPF des fonctionnalités qui ne sont pas immédiatement liées à son rendu, telles que les suivantes :Architecturally, the Visual object does not include support for other application development requirements / WPFWPF features that are not immediately related to its rendering, such as the following:

  • Gestion des événementsEvent handling

  • DispositionLayout

  • celluleStyles

  • Liaison de donnéesData binding

  • GlobalisationGlobalization

Visual est fourni en tant que classe abstraite publique à partir de laquelle d’autres classes peuvent être dérivées.Visual is provided as a public abstract class from which further classes can be derived. L’illustration suivante montre la hiérarchie des objets visuels existants qui sont définis dans l’architecture WPFWPF.The following illustration shows the hierarchy of the existing visual objects that are defined in the WPFWPF architecture.

Diagramme des classes dérivées de l’objet visuelDiagram of classes derived from the Visual object
Hiérarchie de classe d’objet visuelVisual class hierarchy

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 UIElement dérivée.In some cases, members that are defined as protected in Visual are exposed as more readily accessible members with similar names in the derived UIElement class.

Pour plus d’informations, consultez Vue d’ensemble du rendu graphique WPF.For more information, see WPF Graphics Rendering Overview.

Un Visual a un nombre limité de niveaux.A Visual has a limited number of levels. Dans les versions précédentes du .NET Framework, cette profondeur maximale était de 255.In previous versions of the .NET Framework, this maximum depth was 255. Cette limite est inadaptée pour certaines dispositions qui ont de nombreux niveaux dans l’arborescence d’éléments visuels.This limit is inadequate for some layouts that have many levels in the visual tree.

Dans .NET Framework 4.NET Framework 4, la profondeur maximale d’un Visual est de 2047, ce qui permet d’obtenir des arborescences d’éléments visuels plus profondes.In .NET Framework 4.NET Framework 4, the maximum depth of a Visual is 2047, which enables much deeper visual trees. Dans la plupart des applications, il n’y a pas assez d’espace de pile pour parcourir un grand nombre de niveaux et le résultat est un StackOverflowException pendant la disposition.In most applications, there is not enough stack space to traverse so many levels, and the result is a StackOverflowException during layout. 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 à environ 190 objets TreeViewItem imbriqués.For the default stack size, this exception is usually thrown when the tree depth is approximately 800, which corresponds to about 190 nested TreeViewItem objects.

Si cette exception est levée par votre application et que vous devez avoir une arborescence d’éléments visuels plus poussée, vous pouvez augmenter la taille de la pile de l’application.If this exception is thrown by your application and you need to have a deeper visual tree, you can increase the application's stack size. 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.You can increase the size of the stack by using the /STACK option at compile time or by using the EDITBIN utility. L’amélioration de la taille de la pile peut affecter les performances de votre application.Increasing the stack size may affect your application's performance. Pour plus d’informations, consultez allocations de la pile et Options EDITBIN.For more information, see Stack Allocations and EDITBIN Options.

Constructeurs

Visual()

Assure l'initialisation de base des objets dérivés de la classe Visual.Provides the base initialization for objects derived from the Visual class.

Propriétés

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Hérité de DispatcherObject)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Hérité de DependencyObject)
VisualBitmapEffect

Obtient ou définit la valeur BitmapEffect du Visual.Gets or sets the BitmapEffect value for the Visual.

VisualBitmapEffectInput

Obtient ou définit la valeur BitmapEffectInput du Visual.Gets or sets the BitmapEffectInput value for the Visual.

VisualBitmapScalingMode

Obtient ou définit BitmapScalingMode pour Visual.Gets or sets the BitmapScalingMode for the Visual.

VisualCacheMode

Obtient ou définit la représentation mise en cache de Visual.Gets or sets a cached representation of the Visual.

VisualChildrenCount

Obtient le nombre d'éléments enfants du Visual.Gets the number of child elements for the Visual.

VisualClearTypeHint

Obtient ou définit le ClearTypeHint qui détermine la façon dont ClearType est rendu dans Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

VisualClip

Obtient ou définit la zone de découpage du Visual en tant que valeur Geometry.Gets or sets the clip region of the Visual as a Geometry value.

VisualEdgeMode

Obtient ou définit le mode de bord du Visual en tant que valeur EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

VisualEffect

Obtient ou définit l'effet bitmap à appliquer à Visual.Gets or sets the bitmap effect to apply to the Visual.

VisualOffset

Obtient ou définit la valeur de décalage de l'objet visuel.Gets or sets the offset value of the visual object.

VisualOpacity

Obtient ou définit l'opacité du Visual.Gets or sets the opacity of the Visual.

VisualOpacityMask

Obtient ou définit la valeur Brush qui représente le masque d'opacité du Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

VisualParent

Obtient le parent d'arborescence d'éléments visuels de l'objet visuel.Gets the visual tree parent of the visual object.

VisualScrollableAreaClip

Obtient ou définit une zone à défilement découpée pour Visual.Gets or sets a clipped scrollable area for the Visual.

VisualTextHintingMode

Obtient ou définit le TextHintingMode de Visual.Gets or sets the TextHintingMode of the Visual.

VisualTextRenderingMode

Obtient ou définit le TextRenderingMode de Visual.Gets or sets the TextRenderingMode of the Visual.

VisualTransform

Obtient ou définit la valeur Transform du Visual.Gets or sets the Transform value for the Visual.

VisualXSnappingGuidelines

Obtient ou définit la collection d’indications de coordonnée X (verticale).Gets or sets the x-coordinate (vertical) guideline collection.

VisualYSnappingGuidelines

Obtient ou définit la collection d’indications de coordonnée y (horizontale).Gets or sets the y-coordinate (horizontal) guideline collection.

Méthodes

AddVisualChild(Visual)

Définit la relation parent-enfant entre deux objets visuels.Defines the parent-child relationship between two visuals.

CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Hérité de DependencyObject)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Hérité de DependencyObject)
Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Hérité de DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Retourne l'ancêtre commun de deux objets visuels.Returns the common ancestor of two visual objects.

GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this 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.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Hérité de DependencyObject)
GetVisualChild(Int32)

Retourne le Visual spécifié dans le VisualCollection parent.Returns the specified Visual in the parent VisualCollection.

HitTestCore(GeometryHitTestParameters)

Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel.Determines whether a geometry value is within the bounds of the visual object.

HitTestCore(PointHitTestParameters)

Détermine si la valeur de coordonnée d'un point s'inscrit dans les limites de l'objet visuel.Determines whether a point coordinate value is within the bounds of the visual object.

InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.Re-evaluates the effective value for the specified dependency property.

(Hérité de DependencyObject)
IsAncestorOf(DependencyObject)

Détermine si l'objet visuel est un ancêtre de l'objet visuel descendant.Determines whether the visual object is an ancestor of the descendant visual object.

IsDescendantOf(DependencyObject)

Détermine si l'objet visuel est un descendant de l'objet visuel ancêtre.Determines whether the visual object is a descendant of the ancestor visual object.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnDpiChanged(DpiScale, DpiScale)

Appelé en cas de modification des ppp d’affichage de cette Vue.Called when the DPI at which this View is rendered changes.

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.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.The specific dependency property that changed is reported in the event data.

(Hérité de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Appelé lorsque le VisualCollection de l'objet visuel est modifié.Called when the VisualCollection of the visual object is modified.

OnVisualParentChanged(DependencyObject)

Appelé lorsque le parent de l'objet visuel est modifié.Called when the parent of the visual object is changed.

PointFromScreen(Point)

Convertit un Point en coordonnées d'écran en Point qui représente le système de coordonnées actuel du Visual.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the 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.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

(Hérité de DependencyObject)
RemoveVisualChild(Visual)

Supprime la relation parent-enfant entre deux objets visuels.Removes the parent-child relationship between two visuals.

SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.Sets the value of a dependency property without changing its value 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.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(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.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Hérité de DependencyObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(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.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

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.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

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.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

TransformToVisual(Visual)

Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)

S’applique à

Voir aussi