Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Visual-Klasse

 

Veröffentlicht: Oktober 2016

Bietet Unterstützung für Rendering in WPF, einschließlich Treffertests, Koordinatentransformation und testen, koordinieren Transformation.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)


public abstract class Visual : DependencyObject

NameBeschreibung
System_CAPS_protmethodVisual()

Stellt die grundlegende Initialisierung für abgeleitete Objekte aus der Visual Klasse.

NameBeschreibung
System_CAPS_pubpropertyDependencyObjectType

Ruft die DependencyObjectType umschließt der CLR Typ dieser Instanz. (Geerbt von „DependencyObject“.)

System_CAPS_pubpropertyDispatcher

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.(Geerbt von „DispatcherObject“.)

System_CAPS_pubpropertyIsSealed

Ruft einen Wert, der angibt, ob diese Instanz derzeit versiegelt ist (schreibgeschützt).(Geerbt von „DependencyObject“.)

System_CAPS_protpropertyVisualBitmapEffect

Veraltet. Ruft ab oder legt den BitmapEffect -Wert für die Visual.

System_CAPS_protpropertyVisualBitmapEffectInput

Veraltet. Ruft ab oder legt den BitmapEffectInput -Wert für die Visual.

System_CAPS_protpropertyVisualBitmapScalingMode

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

System_CAPS_protpropertyVisualCacheMode

Ruft ab oder legt eine zwischengespeicherte Darstellung von der Visual.

System_CAPS_protpropertyVisualChildrenCount

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

System_CAPS_protpropertyVisualClearTypeHint

Ruft ab oder legt den ClearTypeHint der bestimmt, wie ClearType gerendert wird, in der Visual.

System_CAPS_protpropertyVisualClip

Ruft ab oder legt den Ausschneidebereich der Visual als ein Geometry Wert.

System_CAPS_protpropertyVisualEdgeMode

Ruft ab oder legt den edgemodus, der die Visual als ein EdgeMode Wert.

System_CAPS_protpropertyVisualEffect

Ruft ab oder legt den Bitmapeffekt Zuweisen der Visual.

System_CAPS_protpropertyVisualOffset

Ruft ab oder legt den Wert der visual-Objekt.

System_CAPS_protpropertyVisualOpacity

Ruft ab oder legt die Deckkraft der Visual.

System_CAPS_protpropertyVisualOpacityMask

Ruft ab oder legt den Brush Wert, der die Deckkraftmaske darstellt der Visual.

System_CAPS_protpropertyVisualParent

Ruft das übergeordnete visuelle Struktur des visuellen Objekts ab.

System_CAPS_protpropertyVisualScrollableAreaClip

Ruft ab oder legt einen abgeschnittenen bildlauffähigen Bereich für die Visual.

System_CAPS_protpropertyVisualTextHintingMode

Ruft den TextHintingMode von Visual ab oder legt ihn fest.

System_CAPS_protpropertyVisualTextRenderingMode

Ruft ab oder legt die TextRenderingMode von der Visual.

System_CAPS_protpropertyVisualTransform

Ruft ab oder legt den Transform -Wert für die Visual.

System_CAPS_protpropertyVisualXSnappingGuidelines

Ruft die (vertikale) x-Koordinatenführungslinien-Auflistung ab oder legt diese fest.

System_CAPS_protpropertyVisualYSnappingGuidelines

Ruft die (horizontale) y-Koordinatenführungslinien-Auflistung ab oder legt diese fest.

NameBeschreibung
System_CAPS_protmethodAddVisualChild(Visual)

Definiert die Parent-Child-Beziehung zwischen zwei visuellen Elementen.

System_CAPS_pubmethodCheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diese DispatcherObject.(Geerbt von „DispatcherObject“.)

System_CAPS_pubmethodClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodCoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob ein bereitgestelltes DependencyObject entspricht dem aktuellen DependencyObject.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFindCommonVisualAncestor(DependencyObject)

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

System_CAPS_pubmethodGetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodGetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator für die Bestimmung, welche Abhängigkeitseigenschaften lokal auf diesem festgelegte Werte haben DependencyObject.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodGetVisualChild(Int32)

Gibt das angegebene Visual in der übergeordneten VisualCollection.

System_CAPS_protmethodHitTestCore(GeometryHitTestParameters)

Bestimmt, ob ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.

System_CAPS_protmethodHitTestCore(PointHitTestParameters)

Bestimmt, ob ein Punkt-Koordinatenwert innerhalb der Grenzen des visuellen Objekts.

System_CAPS_pubmethodInvalidateProperty(DependencyProperty)

Den tatsächliche Wert für die angegebene Abhängigkeitseigenschaft erneut bewertet werden soll(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodIsAncestorOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Vorgänger des untergeordneten visual-Objekt ist.

System_CAPS_pubmethodIsDescendantOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Nachfolger des übergeordneten visual-Objekt ist.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodOnDpiChanged(DpiScale, DpiScale)

Wird aufgerufen, wenn sich der DPI-Wert ändert, mit dem diese Ansicht gerendert wird.

System_CAPS_protmethodOnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodOnVisualChildrenChanged(DependencyObject, DependencyObject)

Wird aufgerufen, wenn die VisualCollection des visuellen Objekts geändert wird.

System_CAPS_protmethodOnVisualParentChanged(DependencyObject)

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

System_CAPS_pubmethodPointFromScreen(Point)

Konvertiert ein Point in Bildschirmkoordinaten in einem Point der das aktuelle Koordinatensystem darstellt der Visual.

System_CAPS_pubmethodPointToScreen(Point)

Konvertiert einen Point der das aktuelle Koordinatensystem darstellt der Visual in einem Point in Bildschirmkoordinaten.

System_CAPS_pubmethodReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodRemoveVisualChild(Visual)

Entfernt die Parent-Child-Beziehung zwischen zwei visuellen Elementen.

System_CAPS_pubmethodSetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodSetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodSetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.(Geerbt von „DependencyObject“.)

System_CAPS_protmethodShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.(Geerbt von „DependencyObject“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodTransformToAncestor(Visual)

Gibt eine Transformation, die verwendet werden kann, mit der Koordinaten der Visual in den angegebenen Visual Vorgänger des visuellen Objekts.

System_CAPS_pubmethodTransformToAncestor(Visual3D)

Gibt eine Transformation, die verwendet werden kann, mit der Koordinaten der Visual in den angegebenen Visual3D Vorgänger des visuellen Objekts.

System_CAPS_pubmethodTransformToDescendant(Visual)

Gibt eine Transformation, die verwendet werden kann, mit der Koordinaten der Visual auf die Nachfolger des angegebenen visuellen Objekts.

System_CAPS_pubmethodTransformToVisual(Visual)

Gibt eine Transformation, die verwendet werden kann, mit der Koordinaten der Visual für das angegebene visual-Objekt.

System_CAPS_pubmethodVerifyAccess()

Erzwingt, dass der aufrufende Thread den Zugriff auf diese kann DispatcherObject.(Geerbt von „DispatcherObject“.)

Die Visual -Klasse ist die grundlegende Abstraktion, von der alle FrameworkElement Objekt abgeleitet wurde. Es dient auch als Einstiegspunkt zum Schreiben neuer Steuerelemente WPF, und in vielerlei Hinsicht können betrachtet werden als Entsprechung eines Fensterhandles (HWND) in der Win32 Anwendungsmodell.

Das Visual -Objekt ist ein zentrales WPF Objekt, dessen primäre Rolle Unterstützung des Rendering ist. Steuerelemente der Benutzeroberfläche, z. B. Button und TextBox, leiten Sie von der Visual Klasse, und verwenden Sie die Visual definierten Eigenschaften beibehalten ihrer Renderingdaten. Das Visual Objekt bietet Unterstützung für Folgendes:

  • Ausgabeanzeige: Rendern des beibehaltenen, serialisierten Zeichnungsinhalts eines visuellen Objekts.

  • Transformationen: Ausführen von Transformationen auf ein visuelles Element.

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

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

  • Umgebendes Feld Berechnungen: das umschließende Rechteck eines visuellen Objekts bestimmen.

Architektonisch, die Visual Objekt bietet keine Unterstützung für andere anwendungsentwicklungsanforderungen / WPF Funktionen, die nicht sofort seine Darstellung, wie im folgenden zusammenhängen:

  • Ereignisbehandlung

  • Layout

  • Stile

  • Datenbindung

  • Globalisierung

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

Diagramm der vom Visual-Objekt abgeleiteten Klassen

Hierarchie der Visual-Klasse

In einigen Fällen als definierte Member im geschütztes Visual als leichter zugänglich Elemente mit ähnlichen Namen in der abgeleiteten verfügbar gemachten UIElement Klasse.

Weitere Informationen finden Sie unter WPF Graphics Rendering Overview.

Ein Visual hat eine beschränkte Anzahl von Ebenen. In früheren Versionen von .NET Framework war diese maximale Tiefe 255. Dieser Grenzwert gilt für einige Layouts, die viele in der visuellen Struktur Ebenen.

In .NET Framework 4, die maximale Tiefe einer Visual 2047, was viel tiefere visuelle Strukturen ermöglicht wird. In den meisten Clientanwendungen ist nicht genügend Stapelspeicher so viele Ebenen durchlaufen, und das Ergebnis ist eine StackOverflowException während des Layouts. Für die standardmäßige Stapelgröße, diese Ausnahme wird normalerweise ausgelöst, wenn die Strukturtiefe ungefähr 800 beträgt, was ungefähr 190 geschachtelten entspricht TreeViewItem Objekte.

Wenn diese Ausnahme wird von der Anwendung, und Sie eine tiefere visuelle Struktur haben müssen, können Sie die Stapelgröße der Anwendung erhöhen. Sie können die Größe des Stapels mithilfe der durch die Option zum Zeitpunkt der Kompilierung oder mit dem Hilfsprogramm EDITBIN erhöhen. Erhöhen die Größe des Stapels beeinträchtigen die Leistung Ihrer Anwendung. Weitere Informationen finden Sie unter Stack Allocations und EDITBIN Options.

.NET Framework
Verfügbar seit 3.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: