Visual Klasse

Definition

Namespace:
System.Windows.Media
Assembly:
PresentationCore.dll

Bietet Renderingunterstützung in WPF, einschließlich Treffertests, Koordinatentransformation und Begrenzungsfeldberechnungen.

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
Vererbung
Object
DispatcherObject
DependencyObject
Visual
Abgeleitet

Hinweise

Die Visual Klasse ist die grundlegende Abstraktion, von der jedes FrameworkElement Objekt abgeleitet wird. Es dient auch als Einstiegspunkt zum Schreiben neuer Steuerelemente in WPF und kann auf viele Arten als Äquivalent eines Fensterhandles (HWND) im Win32-Anwendungsmodell betrachtet werden.

Das Visual-Objekt ist ein kernes WPF-Objekt, dessen primäre Rolle die Bereitstellung von Renderingunterstützung ist. Benutzeroberflächensteuerelemente, z Button . B. und TextBoxabgeleitet von der Visual Klasse, und verwenden Sie die Visual definierten Eigenschaften, um ihre Renderingdaten beizubehalten. Das Visual Objekt bietet Unterstützung für Folgendes:

  • Ausgabeanzeige: Rendern des permanenten, serialisierten Zeichnungsinhalts eines visuellen Elements.

  • Transformationen: Transformationen an einem visuellen Element vornehmen.

  • Clipping: Bereitstellen der Unterstützung des Clippingbereichs für ein visuelles Element.

  • Treffertests: Bestimmen, ob eine angegebene Koordinate (Punkt) oder Geometrie innerhalb der Grenzen eines visuellen Elements enthalten ist.

  • Begrenzungsfeldberechnungen: Bestimmen des umgebenden Rechtecks eines visuellen Elements.

In der Architektur enthält das Visual Objekt keine Unterstützung für andere Anwendungsentwicklungsanforderungen / WPF-Features, die nicht unmittelbar mit dem Rendering zusammenhängen, z. B. die folgenden:

  • Ereignisbehandlung

  • Layout

  • Stilarten

  • Datenbindung

  • Globalisierung

Visual wird als öffentliche abstrakte Klasse bereitgestellt, aus der weitere Klassen abgeleitet werden können. Die folgende Abbildung zeigt die Hierarchie der vorhandenen visuellen Objekte, die in der WPF-Architektur definiert sind.

Diagramm von Klassen, die vom visuellen Objektdiagramm abgeleitet Visuelle Klassenhierarchie

In einigen Fällen werden Elemente, die als geschützt Visual definiert sind, als leichter zugängliche Member mit ähnlichen Namen in der abgeleiteten UIElement Klasse verfügbar gemacht.

Weitere Informationen finden Sie unter WPF Graphics Rendering Overview.

A Visual hat eine begrenzte Anzahl von Ebenen. In früheren Versionen von .NET Framework betrug diese maximale Tiefe 255. Dieser Grenzwert ist für einige Layouts mit vielen Ebenen in der visuellen Struktur unzureichend.

In .NET Framework 4 beträgt die maximale Tiefe eines Elements Visual 2047, was viel tiefere visuelle Strukturen ermöglicht. In den meisten Anwendungen gibt es nicht genügend Stapelplatz, um so viele Ebenen zu durchlaufen, und das Ergebnis ist ein StackOverflowException Layout. Bei der Standardstapelgröße wird diese Ausnahme in der Regel ausgelöst, wenn die Strukturtiefe ungefähr 800 beträgt, was etwa 190 geschachtelten TreeViewItem Objekten entspricht.

Wenn diese Ausnahme von Ihrer Anwendung ausgelöst wird und Sie eine tiefere visuelle Struktur benötigen, können Sie die Stapelgröße der Anwendung erhöhen. Sie können die Größe des Stapels erhöhen, indem Sie die Option "/STACK" zur Kompilierungszeit oder mithilfe des EDITBIN-Hilfsprogramms verwenden. Das Erhöhen der Stapelgröße kann sich auf die Leistung Ihrer Anwendung auswirken. Weitere Informationen finden Sie unter Stack Allocations und EDITBIN-Optionen.

Konstruktoren

Name Beschreibung
Visual()

Stellt die Basisinitialisierung für Objekte bereit, die von der Visual Klasse abgeleitet wurden.

Eigenschaften

Name Beschreibung
DependencyObjectType

Ruft den DependencyObjectType CLR-Typ dieser Instanz ab.

(Geerbt von DependencyObject)
Dispatcher

Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt).

(Geerbt von DependencyObject)
VisualBitmapEffect
Veraltet.
Veraltet.

Dient zum Abrufen oder Festlegen des BitmapEffect Werts für die Visual.
VisualBitmapEffectInput
Veraltet.
Veraltet.

Dient zum Abrufen oder Festlegen des BitmapEffectInput Werts für die Visual.
VisualBitmapScalingMode

Ruft ab oder legt den BitmapScalingMode für die Visual.
VisualCacheMode

Dient zum Abrufen oder Festlegen einer zwischengespeicherten Darstellung der Visual.
VisualChildrenCount

Ruft die Anzahl der untergeordneten Elemente für die Visual.
VisualClearTypeHint

Dient zum Abrufen oder Festlegen der ClearTypeHint Bestimmt, wie ClearType in der Visual.
VisualClip

Dient zum Abrufen oder Festlegen des Clipbereichs des Visual Als Geometry Werts.
VisualEdgeMode

Dient zum Abrufen oder Festlegen des Randmodus des Visual Als EdgeMode Werts.
VisualEffect

Dient zum Abrufen oder Festlegen des Bitmapeffekts, der auf die Visual.
VisualOffset

Dient zum Abrufen oder Festlegen des Offsetwerts des visuellen Objekts.
VisualOpacity

Dient zum Abrufen oder Festlegen der Deckkraft des Visual.
VisualOpacityMask

Dient zum Abrufen oder Festlegen des Brush Werts, der die Deckkraftmaske der Visual.
VisualParent

Ruft das übergeordnete Element der visuellen Struktur des visuellen Objekts ab.
VisualScrollableAreaClip

Dient zum Abrufen oder Festlegen eines beschnittenen Bildlaufbereichs für den Visual.
VisualTextHintingMode

Ruft den TextHintingMode von Visual ab oder legt ihn fest.
VisualTextRenderingMode

Ruft den TextRenderingMode von Visual ab oder legt ihn fest.
VisualTransform

Dient zum Abrufen oder Festlegen des Transform Werts für die Visual.
VisualXSnappingGuidelines

Dient zum Abrufen oder Festlegen der X-Koordinate (vertikale) Richtlinienauflistung.
VisualYSnappingGuidelines

Dient zum Abrufen oder Festlegen der y-Koordinate (horizontale) Richtlinienauflistung.

Methoden

Name Beschreibung
AddVisualChild(Visual)

Definiert die Beziehung zwischen zwei visuellen Elementen.
CheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht.

(Geerbt von DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Gibt den gemeinsamen Vorgänger zweier visueller Objekte zurück.
GetHashCode()

Ruft einen Hashcode für diese DependencyObjectab.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben.

(Geerbt von DependencyObject)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject

(Geerbt von DependencyObject)
GetVisualChild(Int32)

Gibt das angegebene Element im übergeordneten VisualObjekt VisualCollection zurück.
HitTestCore(GeometryHitTestParameters)

Bestimmt, ob sich ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.
HitTestCore(PointHitTestParameters)

Bestimmt, ob sich ein Punktkoordinatenwert innerhalb der Grenzen des visuellen Objekts befindet.
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.

(Geerbt von DependencyObject)
IsAncestorOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Vorgänger des untergeordneten visuellen Objekts ist.
IsDescendantOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein untergeordnetes Objekt des visuellen Vorgängerobjekts ist.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
OnDpiChanged(DpiScale, DpiScale)

Wird aufgerufen, wenn sich der DPI-Wert, an dem diese Ansicht gerendert wird, ändert.
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject Eigenschaft aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet.

(Geerbt von DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Wird aufgerufen, wenn das VisualCollection visuelle Objekt geändert wird.
OnVisualParentChanged(DependencyObject)

Wird aufgerufen, wenn das übergeordnete Element des visuellen Objekts geändert wird.
PointFromScreen(Point)

Konvertiert eine Point in Bildschirmkoordinaten in ein Point Koordinatensystem, das das aktuelle Koordinatensystem des Visual.
PointToScreen(Point)

Wandelt ein Point , das das aktuelle Koordinatensystem der Visual In-Bildschirmkoordinaten Point darstellt.
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden.

(Geerbt von DependencyObject)
RemoveVisualChild(Visual)

Entfernt die Beziehung zwischen zwei visuellen Elementen.
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird.

(Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TransformToAncestor(Visual)

Gibt eine Transformation zurück, die zum Transformieren von Koordinaten vom Visual angegebenen Visual Vorgänger des visuellen Objekts verwendet werden kann.
TransformToAncestor(Visual3D)

Gibt eine Transformation zurück, die zum Transformieren von Koordinaten vom Visual angegebenen Visual3D Vorgänger des visuellen Objekts verwendet werden kann.
TransformToDescendant(Visual)

Gibt eine Transformation zurück, die verwendet werden kann, um Koordinaten von der Visual angegebenen visuellen Objekt-absteigend zu transformieren.
TransformToVisual(Visual)

Gibt eine Transformation zurück, die zum Transformieren von Koordinaten vom Visual angegebenen visuellen Objekt verwendet werden kann.
VerifyAccess()

Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat.

(Geerbt von DispatcherObject)

Gilt für:

Weitere Informationen