Visual Visual Visual Visual Class

Definizione

Offre il supporto per il rendering in WPF, che include hit testing, trasformazione delle coordinate e calcoli relativi al rettangolo di selezione.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
Ereditarietà
Derivato

Commenti

La Visual classe è l'astrazione di base da FrameworkElement cui derivano tutti gli oggetti.The Visual class is the basic abstraction from which every FrameworkElement object derives. Funge anche da punto di ingresso per la scrittura di nuovi controlli WPFWPFin e, in molti casi, può essere considerato come un equivalente di un handle di finestra (HWND) Win32Win32 nel modello di applicazione.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' Visual oggetto è un oggetto WPFWPF di base, il cui ruolo primario è fornire supporto per il rendering.The Visual object is a core WPFWPF object, whose primary role is to provide rendering support. I controlli dell'interfaccia utente, Button ad TextBoxesempio e Visual , derivano dalla classe e utilizzano Visual le proprietà definite per rendere permanente i dati di rendering.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' Visual oggetto fornisce supporto per gli elementi seguenti:The Visual object provides support for the following:

  • Visualizzazione dell'output: eseguire il rendering del contenuto del disegno serializzato e salvato in modo permanente di un oggetto visivo.Output display: Rendering the persisted, serialized drawing content of a visual.

  • Trasformazioni: eseguire trasformazioni su un oggetto visivo.Transformations: Performing transformations on a visual.

  • Ritaglio: offrire supporto dell'area di ritaglio per un oggetto visivo.Clipping: Providing clipping region support for a visual.

  • Hit testing: Determinare se una coordinata (punto) o una geometria specificata è contenuta all'interno dei limiti di un oggetto visivo.Hit testing: Determining whether a specified coordinate (point) or geometry is contained within the bounds of a visual.

  • Calcoli relativi al rettangolo di selezione: determinare il rettangolo delimitatore di un oggetto visivo.Bounding box calculations: Determining the bounding rectangle of a visual.

Nell'architettura, l' Visual oggetto non include il supporto per altri requisiti o WPFWPF funzionalità di sviluppo di applicazioni che non sono immediatamente correlati al rendering, ad esempio: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:

  • Gestione di eventiEvent handling

  • LayoutLayout

  • StiliStyles

  • Associazione datiData binding

  • GlobalizzazioneGlobalization

Visualviene fornito come classe astratta pubblica da cui è possibile derivare altre classi.Visual is provided as a public abstract class from which further classes can be derived. Nella figura seguente viene illustrata la gerarchia degli oggetti visivi esistenti definiti nell' WPFWPF architettura di.The following illustration shows the hierarchy of the existing visual objects that are defined in the WPFWPF architecture.

![Diagramma delle classi derivate dall'oggetto visivo] (~/add/media/visualclass01.png "Diagramma delle classi derivate dall'oggetto visivo")Diagram of classes derived from the Visual object
Gerarchia delle classi visiveVisual class hierarchy

In alcuni casi, i membri definiti come protetti in Visual vengono esposti come membri più facilmente accessibili con nomi simili nella classe derivata. UIElementIn 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.

Per altre informazioni, vedere Cenni preliminari sul rendering della grafica WPF.For more information, see WPF Graphics Rendering Overview.

Un Visual oggetto ha un numero limitato di livelli.A Visual has a limited number of levels. Nelle versioni precedenti del .NET Framework, questa profondità massima è 255.In previous versions of the .NET Framework, this maximum depth was 255. Questo limite non è adeguato per alcuni layout con molti livelli nella struttura ad albero visuale.This limit is inadequate for some layouts that have many levels in the visual tree.

In .NET Framework 4.NET Framework 4la profondità massima di a Visual è 2047, che consente alberi visivi molto più profondi.In .NET Framework 4.NET Framework 4, the maximum depth of a Visual is 2047, which enables much deeper visual trees. Nella maggior parte delle applicazioni, lo spazio dello stack non è sufficiente per attraversare un numero così elevato di livelli e StackOverflowException il risultato è un oggetto durante il layout.In most applications, there is not enough stack space to traverse so many levels, and the result is a StackOverflowException during layout. Per le dimensioni predefinite dello stack, questa eccezione viene in genere generata quando la profondità dell'albero è approssimativamente 800, che corrisponde a TreeViewItem circa 190 oggetti annidati.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.

Se questa eccezione viene generata dall'applicazione ed è necessario disporre di una struttura ad albero visuale più profonda, è possibile aumentare le dimensioni dello stack dell'applicazione.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. È possibile aumentare le dimensioni dello stack utilizzando l'opzione/STACK in fase di compilazione oppure tramite l'utilità EDITBIN).You can increase the size of the stack by using the /STACK option at compile time or by using the EDITBIN utility. L'aumento delle dimensioni dello stack può influire sulle prestazioni dell'applicazione.Increasing the stack size may affect your application's performance. Per altre informazioni, vedere allocazioni dello stack e Opzioni di EDITBIN).For more information, see Stack Allocations and EDITBIN Options.

Costruttori

Visual() Visual() Visual() Visual()

Fornisce l'inizializzazione di base per oggetti derivati dalla classe Visual.Provides the base initialization for objects derived from the Visual class.

Proprietà

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Ottiene la classe DependencyObjectType che include il tipo CLRCLR di questa istanza.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Ottiene l'oggetto Dispatcher associato a DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
IsSealed IsSealed IsSealed IsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect

Ottiene o imposta il valore di BitmapEffect per Visual.Gets or sets the BitmapEffect value for the Visual.

VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput

Ottiene o imposta il valore di BitmapEffectInput per Visual.Gets or sets the BitmapEffectInput value for the Visual.

VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode

Ottiene o imposta l'oggetto BitmapScalingMode per Visual.Gets or sets the BitmapScalingMode for the Visual.

VisualCacheMode VisualCacheMode VisualCacheMode VisualCacheMode

Ottiene o imposta una rappresentazione nascosta dell'oggetto Visual.Gets or sets a cached representation of the Visual.

VisualChildrenCount VisualChildrenCount VisualChildrenCount VisualChildrenCount

Ottiene il numero di elementi figlio per l’oggetto Visual.Gets the number of child elements for the Visual.

VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint

Ottiene o imposta l'oggetto ClearTypeHint che determina come viene reso ClearType nell'oggetto Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

VisualClip VisualClip VisualClip VisualClip

Ottiene o imposta l'area di ridimensionamento dell'oggetto Visual specificato sotto forma di valore Geometry.Gets or sets the clip region of the Visual as a Geometry value.

VisualEdgeMode VisualEdgeMode VisualEdgeMode VisualEdgeMode

Ottiene o imposta la modalità di bordo dell’oggetto Visual sotto forma di valore EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

VisualEffect VisualEffect VisualEffect VisualEffect

Ottiene o imposta l'effetto bitmap da applicare all'oggetto Visual.Gets or sets the bitmap effect to apply to the Visual.

VisualOffset VisualOffset VisualOffset VisualOffset

Ottiene o imposta il valore di offset dell’oggetto visivo.Gets or sets the offset value of the visual object.

VisualOpacity VisualOpacity VisualOpacity VisualOpacity

Ottiene o imposta l'opacità di Visual.Gets or sets the opacity of the Visual.

VisualOpacityMask VisualOpacityMask VisualOpacityMask VisualOpacityMask

Ottiene o imposta il valore Brush che rappresenta la maschera di opacità dell’oggetto Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

VisualParent VisualParent VisualParent VisualParent

Ottiene la struttura ad albero padre dell’oggetto visivo.Gets the visual tree parent of the visual object.

VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip

Ottiene o imposta un'area scorrevole ritagliata per l'oggetto Visual.Gets or sets a clipped scrollable area for the Visual.

VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode

Ottiene o imposta l'oggetto TextHintingMode di Visual.Gets or sets the TextHintingMode of the Visual.

VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode

Ottiene o imposta l'oggetto TextRenderingMode di Visual.Gets or sets the TextRenderingMode of the Visual.

VisualTransform VisualTransform VisualTransform VisualTransform

Ottiene o imposta il valore di Transform per Visual.Gets or sets the Transform value for the Visual.

VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines

Ottiene o imposta l’insieme di linee guida della coordinata x (verticale).Gets or sets the x-coordinate (vertical) guideline collection.

VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines

Ottiene o imposta l’insieme di linee guida della coordinata y (orizzontale).Gets or sets the y-coordinate (horizontal) guideline collection.

Metodi

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

Definisce la relazione padre-figlio tra due elementi visivi.Defines the parent-child relationship between two visuals.

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

Determina se il thread chiamante ha accesso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata.Coerces the value of the specified dependency property. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.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)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

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

Restituisce il predecessore comune di due oggetti visivi.Returns the common ancestor of two visual objects.

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

Ottiene un codice hash per DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di 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)

Restituisce l’oggetto Visual specificato nell’oggetto VisualCollection padre.Returns the specified Visual in the parent VisualCollection.

HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters)

Determina se il valore di una geometria si trova all'interno dei limiti dell’oggetto visivo.Determines whether a geometry value is within the bounds of the visual object.

HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters) HitTestCore(PointHitTestParameters)

Determina se il valore di coordinata di un punto è all'interno dei limiti dell’oggetto visivo.Determines whether a point coordinate value is within the bounds of the visual object.

InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject)

Determina se l'oggetto visivo è un predecessore dell'oggetto visivo discendente.Determines whether the visual object is an ancestor of the descendant visual object.

IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

Determina se l'oggetto visivo è un discendente dell'oggetto visivo predecessore.Determines whether the visual object is a descendant of the ancestor visual object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale) OnDpiChanged(DpiScale, DpiScale)

Chiamato in caso di variazione del valore DPI usato per il rendering della vista.Called when the DPI at which this View is rendered changes.

OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La specifica proprietà di dipendenza modificata viene indicata nei dati dell'evento.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)

Viene chiamato quando l'oggetto VisualCollection dell’oggetto visivo viene modificato.Called when the VisualCollection of the visual object is modified.

OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

Chiamato quando l’elemento padre dell’oggetto visivo viene modificato.Called when the parent of the visual object is changed.

PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point)

Converte un oggetto Point sotto forma di coordinate dello schermo in un oggetto Point che rappresenta il sistema di coordinate corrente dell’oggetto 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)

Converte un oggetto Point che rappresenta il sistema di coordinate corrente dell’oggetto Visual in un oggetto Point sotto forma di coordinate dello schermo.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)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.Returns the local value of a dependency property, if it exists.

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

Rimuove la relazione padre-figlio tra due elementi visivi.Removes the parent-child relationship between two visuals.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.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)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.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)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.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)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al predecessore Visual specificato dell’oggetto visivo.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)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al predecessore Visual3D specificato dell’oggetto visivo.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)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual al discendente specificato dell’oggetto visivo.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)

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual all’oggetto visivo specificato.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Impone che il thread chiamante abbia accesso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Si applica a

Vedi anche