Visual Visual Visual Visual Class

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
    interface DUCE.IResource
Public MustInherit Class Visual
Inherits DependencyObject
Héritage
Dérivé

Remarques

Le Visual classe est l’abstraction de base à partir de laquelle chaque FrameworkElement dérive de l’objet.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 WPFWPFet à bien des égards peut être considérée comme un équivalent d’un handle de fenêtre (HWND) dans le Win32Win32 modèle d’application.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.

Le Visual objet est un cœur WPFWPF objet, dont le rôle principal consiste à fournir la prise en charge du rendu.The Visual object is a core WPFWPF object, whose primary role is to provide rendering support. Contrôles d’interface utilisateur, tel que Button et TextBox, dérivent le Visual classe et utiliser le Visual défini les propriétés de la persistance de 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. Le Visual objet prend en charge pour 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.

  • Le test de positionnement : Déterminer si une coordonnée spécifiée (point) ou une géométrie est contenue dans les limites d’un objet 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.

Point de vue architectural, le Visual objet n’inclut pas de prise en charge d’autres exigences du développement d’application / WPFWPF les fonctionnalités qui ne sont pas immédiatement liées à son rendu, tels que les éléments suivants :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

  • Mise en pageLayout

  • StylesStyles

  • Liaison de donnéesData binding

  • GlobalisationGlobalization

Visual est fourni comme une classe abstraite publique à partir de laquelle 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éfinies dans le WPFWPF architecture.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 qui sont définies comme protégé dans Visual sont exposées en tant que membres plus facilement accessibles avec des noms similaires dans dérivé UIElement classe.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 255.In previous versions of the .NET Framework, this maximum depth was 255. Cette limite est insuffisant pour certaines dispositions qui ont de nombreux niveaux dans l’arborescence visuelle.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 2047, ce qui permet des arborescences d’éléments visuels 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’est pas suffisamment d’espace pile pour parcourir de nombreux 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 imbriqués TreeViewItem objets.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 vous devez disposer d’une arborescence visuelle plus approfondie, 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. Augmentation de la taille de 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() Visual() Visual() 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 DependencyObjectType DependencyObjectType DependencyObjectType

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

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

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

(Inherited from DispatcherObject)
IsSealed IsSealed IsSealed 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).

(Inherited from DependencyObject)
VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect

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

VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput

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

VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode

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

VisualCacheMode VisualCacheMode VisualCacheMode VisualCacheMode

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

VisualChildrenCount VisualChildrenCount VisualChildrenCount VisualChildrenCount

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

VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint 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 VisualClip VisualClip 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 VisualEdgeMode VisualEdgeMode 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 VisualEffect VisualEffect VisualEffect

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

VisualOffset VisualOffset VisualOffset 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 VisualOpacity VisualOpacity VisualOpacity

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

VisualOpacityMask VisualOpacityMask VisualOpacityMask 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 VisualParent VisualParent VisualParent

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

VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip 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 VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode

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

VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode

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

VisualTransform VisualTransform VisualTransform VisualTransform

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

VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines

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

VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines

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

Méthodes

AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual) AddVisualChild(Visual)

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

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

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

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) 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.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) 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.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) 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.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) 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.

(Inherited from DependencyObject)
FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject)

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() 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.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) 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.

(Inherited from DependencyObject)
GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32) GetVisualChild(Int32)

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

HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) 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) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) 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) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

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

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(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) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) 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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) 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) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) 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 été modifiée est signalée dans les données d'événement.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, 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) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

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

PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point) 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) PointToScreen(Point) PointToScreen(Point) 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) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) 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.

(Inherited from DependencyObject)
RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual) RemoveVisualChild(Visual)

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

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) 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.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) 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.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) 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.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) 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.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) 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) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) 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) TransformToDescendant(Visual) TransformToDescendant(Visual) 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) TransformToVisual(Visual) TransformToVisual(Visual) 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() VerifyAccess() VerifyAccess() VerifyAccess()

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

(Inherited from DispatcherObject)

S’applique à

Voir aussi