DrawingVisual Klasse

Definition

DrawingVisual ist ein visuelles Objekt, das zum Rendern von Vektorgrafiken auf dem Bildschirm verwendet werden kann.DrawingVisual is a visual object that can be used to render vector graphics on the screen. Der Inhalt wird vom System beibehalten.The content is persisted by the system.

public ref class DrawingVisual : System::Windows::Media::ContainerVisual
public class DrawingVisual : System.Windows.Media.ContainerVisual
type DrawingVisual = class
    inherit ContainerVisual
Public Class DrawingVisual
Inherits ContainerVisual
Vererbung

Hinweise

DrawingVisualist eine vereinfachte Zeichnungs Klasse, die zum Rendering von Formen, Bildern oder Text verwendet wird.DrawingVisual is a lightweight drawing class that is used to render shapes, images, or text. Diese Klasse wird als einfach angesehen, da Sie kein Layout, Eingabe, Fokus oder Ereignis Behandlung bereitstellt, wodurch die Leistung verbessert wird.This class is considered lightweight because it does not provide layout, input, focus, or event handling, which improves its performance. Aus diesem Grund sind Zeichnungen für Hintergründe und ClipArt ideal.For this reason, drawings are ideal for backgrounds and clip art.

Um-Objekte verwenden DrawingVisual zu können, müssen Sie einen Host Container für die-Objekte erstellen.In order to use DrawingVisual objects, you need to create a host container for the objects. Das Host Container Objekt muss von der FrameworkElement -Klasse abgeleitet werden, die die Unterstützung für Layout und Ereignis Behandlung bereitstellt, die von der DrawingVisual -Klasse nicht unterstützt wird.The host container object must be derived from the FrameworkElement class, which provides the layout and event handling support that the DrawingVisual class does not support. Das Host Container Objekt zeigt keine visuellen Eigenschaften an, da der Hauptzweck darin besteht, untergeordnete Objekte zu enthalten.The host container object does not display any visual properties, since its main purpose is to contain child objects. Weitere Informationen finden Sie unter Verwenden von DrawingVisual-Objekten.For more information, see Using DrawingVisual Objects.

Ein umfassendes Beispiel, das zeigt, wie DrawingVisual Objekte mit einem Host Container erstellt werden, finden Sie im Beispiel für einen Treffer Test mit DrawingVisuals .For a complete example showing how to create DrawingVisual objects with a host container, see the Hit Test Using DrawingVisuals Sample .

Konstruktoren

DrawingVisual()

Initialisiert eine neue Instanz der DrawingVisual-Klasse.Initializes a new instance of the DrawingVisual class.

Eigenschaften

BitmapEffect

Ruft einen BitmapEffect-Wert für das ContainerVisual ab oder legt diesen fest.Gets or sets a BitmapEffect value for the ContainerVisual.

(Geerbt von ContainerVisual)
BitmapEffectInput

Ruft einen BitmapEffectInput-Wert für das ContainerVisual ab oder legt diesen fest.Gets or sets a BitmapEffectInput value for the ContainerVisual.

(Geerbt von ContainerVisual)
CacheMode

Ruft eine zwischengespeicherte Darstellung des ContainerVisual ab oder legt diese fest.Gets or sets a cached representation of the ContainerVisual.

(Geerbt von ContainerVisual)
Children

Ruft die Auflistung der untergeordneten Elemente des ContainerVisual ab.Gets the child collection of the ContainerVisual.

(Geerbt von ContainerVisual)
Clip

Ruft den Ausschneidebereich des ContainerVisual ab oder legt diesen fest.Gets or sets the clipping region of the ContainerVisual.

(Geerbt von ContainerVisual)
ContentBounds

Ruft das umgebende Feld für den Inhalt des ContainerVisual ab.Gets the bounding box for the contents of the ContainerVisual.

(Geerbt von ContainerVisual)
DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
DescendantBounds

Ruft die Gesamtmenge aller umgebenden Felder des Inhalts für alle Nachfolgerelemente des ContainerVisual ab, doch ohne das umgebende Feld für den Inhalt des ContainerVisual.Gets the union of all the content bounding boxes for all of the descendants of the ContainerVisual, but not including the contents of the ContainerVisual.

(Geerbt von ContainerVisual)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
Drawing

Ruft den Zeichnungsinhalt des DrawingVisual-Objekts ab.Gets the drawing content of the DrawingVisual object.

Effect

Ruft den Bitmapeffekt ab, der auf das ContainerVisual-Objekt angewendet werden soll, oder legt ihn fest.Gets or sets the bitmap effect to apply to the ContainerVisual.

(Geerbt von ContainerVisual)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
Offset

Ruft den Wert für den Offset des ContainerVisual von seinem Bezugspunkt ab oder legt diesen fest.Gets or sets the offset value of the ContainerVisual from its reference point.

(Geerbt von ContainerVisual)
Opacity

Ruft die Durchlässigkeit des ContainerVisual ab oder legt diese fest, wobei 0=transparent und 1=undurchlässig ist.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

(Geerbt von ContainerVisual)
OpacityMask

Ruft einen Pinsel ab, der eine mögliche Durchlässigkeitsmaske für das ContainerVisual angibt, oder legt diesen fest.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

(Geerbt von ContainerVisual)
Parent

Ruft das übergeordnete Visual für das ContainerVisual ab.Gets the parent Visual for the ContainerVisual.

(Geerbt von ContainerVisual)
Transform

Ruft die auf das ContainerVisual angewendete Transformation ab oder legt diese fest.Gets or sets the transform that is applied to the ContainerVisual.

(Geerbt von ContainerVisual)
VisualBitmapEffect

Ruft den BitmapEffect-Wert für das Visual ab oder legt diesen fest.Gets or sets the BitmapEffect value for the Visual.

(Geerbt von Visual)
VisualBitmapEffectInput

Ruft den BitmapEffectInput-Wert für das Visual ab oder legt diesen fest.Gets or sets the BitmapEffectInput value for the Visual.

(Geerbt von Visual)
VisualBitmapScalingMode

Ruft die BitmapScalingMode für den Visual ab oder legt diese fest.Gets or sets the BitmapScalingMode for the Visual.

(Geerbt von Visual)
VisualCacheMode

Ruft eine zwischengespeicherte Darstellung des Visual ab oder legt diese fest.Gets or sets a cached representation of the Visual.

(Geerbt von Visual)
VisualChildrenCount

Ruft die Anzahl der untergeordneten Elemente für das ContainerVisual ab.Gets the number of children for the ContainerVisual.

(Geerbt von ContainerVisual)
VisualClearTypeHint

Ruft die ClearTypeHint ab, die bestimmt, wie ClearType im Visual dargestellt wird.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

(Geerbt von Visual)
VisualClip

Ruft den Ausschneidebereich des Visual als Geometry-Wert ab oder legt diesen fest.Gets or sets the clip region of the Visual as a Geometry value.

(Geerbt von Visual)
VisualEdgeMode

Ruft den Randmodus des Visual als EdgeMode-Wert ab oder legt diesen fest.Gets or sets the edge mode of the Visual as an EdgeMode value.

(Geerbt von Visual)
VisualEffect

Ruft den Bitmapeffekt ab, der auf das Visual-Objekt angewendet werden soll, oder legt ihn fest.Gets or sets the bitmap effect to apply to the Visual.

(Geerbt von Visual)
VisualOffset

Ruft den Offsetwert des visuellen Objekts ab oder legt diesen fest.Gets or sets the offset value of the visual object.

(Geerbt von Visual)
VisualOpacity

Ruft die Durchlässigkeit des Visual ab oder legt diese fest.Gets or sets the opacity of the Visual.

(Geerbt von Visual)
VisualOpacityMask

Ruft den Brush-Wert ab, der die Durchlässigkeitsmaske des Visual darstellt, oder legt diesen fest.Gets or sets the Brush value that represents the opacity mask of the Visual.

(Geerbt von Visual)
VisualParent

Ruft das übergeordnete visuelle Strukturelement vom visuellen Objekt ab.Gets the visual tree parent of the visual object.

(Geerbt von Visual)
VisualScrollableAreaClip

Ruft einen abgeschnittenen bildlauffähigen Bereich für das Visual-Objekt ab oder legt diesen fest.Gets or sets a clipped scrollable area for the Visual.

(Geerbt von Visual)
VisualTextHintingMode

Ruft den TextHintingMode von Visual ab oder legt ihn fest.Gets or sets the TextHintingMode of the Visual.

(Geerbt von Visual)
VisualTextRenderingMode

Ruft den TextRenderingMode von Visual ab oder legt ihn fest.Gets or sets the TextRenderingMode of the Visual.

(Geerbt von Visual)
VisualTransform

Ruft den Transform-Wert für das Visual ab oder legt diesen fest.Gets or sets the Transform value for the Visual.

(Geerbt von Visual)
VisualXSnappingGuidelines

Ruft die (vertikale) x-Koordinatenführungslinien-Auflistung ab oder legt diese fest.Gets or sets the x-coordinate (vertical) guideline collection.

(Geerbt von Visual)
VisualYSnappingGuidelines

Ruft die (horizontale) y-Koordinatenführungslinien-Auflistung ab oder legt diese fest.Gets or sets the y-coordinate (horizontal) guideline collection.

(Geerbt von Visual)
XSnappingGuidelines

Ruft die (horizontale) X-Führungslinie für ContainerVisual ab oder legt sie fest.Gets or sets the X (horizontal) guideline for the ContainerVisual.

(Geerbt von ContainerVisual)
YSnappingGuidelines

Ruft die (vertikale) Y-Führungslinie für ContainerVisual ab oder legt sie fest.Gets or sets the Y (vertical) guideline for the ContainerVisual.

(Geerbt von ContainerVisual)

Methoden

AddVisualChild(Visual)

Definiert die hierarchische Beziehung zwischen zwei visuellen Elementen.Defines the parent-child relationship between two visuals.

(Geerbt von Visual)
CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Gibt den gemeinsamen Vorgänger zweier visueller Objekte zurück.Returns the common ancestor of two visual objects.

(Geerbt von Visual)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
GetVisualChild(Int32)

Gibt ein angegebenes untergeordnetes Visual-Element für das übergeordnete ContainerVisual-Element zurück.Returns a specified child Visual for the parent ContainerVisual.

(Geerbt von ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initialisiert einen Treffertest für das ContainerVisual-Objekt, indem das HitTestFilterCallback- und das HitTestResultCallback-Objekt verwendet werden.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

(Geerbt von ContainerVisual)
HitTest(Point)

Gibt durch Angeben von Point das oberste visuelle Objekt eines Treffertests zurück.Returns the top-most visual object of a hit test by specifying a Point.

(Geerbt von ContainerVisual)
HitTestCore(GeometryHitTestParameters)

Bestimmt, ob sich ein Geometriewert innerhalb der Grenzen des visuellen Objekts befindet.Determines whether a geometry value is within the bounds of the visual object.

HitTestCore(PointHitTestParameters)

Bestimmt, ob sich ein Punktkoordinatenwert innerhalb der Grenzen des DrawingVisual-Objekts befindet.Determines whether a point coordinate value is within the bounds of the DrawingVisual object.

InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
IsAncestorOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Vorgänger des visuellen Nachfolgerobjekts ist.Determines whether the visual object is an ancestor of the descendant visual object.

(Geerbt von Visual)
IsDescendantOf(DependencyObject)

Bestimmt, ob das visuelle Objekt ein Nachfolger des visuellen Vorgängerobjekts ist.Determines whether the visual object is a descendant of the ancestor visual object.

(Geerbt von Visual)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDpiChanged(DpiScale, DpiScale)

Wird aufgerufen, wenn sich der DPI-Wert ändert, mit dem diese Ansicht gerendert wird.Called when the DPI at which this View is rendered changes.

(Geerbt von Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Wird aufgerufen, wenn die VisualCollection des visuellen Objekts geändert wurde.Called when the VisualCollection of the visual object is modified.

(Geerbt von Visual)
OnVisualParentChanged(DependencyObject)

Wird aufgerufen, wenn das übergeordnete Element des visuellen Objekts geändert wird.Called when the parent of the visual object is changed.

(Geerbt von Visual)
PointFromScreen(Point)

Konvertiert einen in Bildschirmkoordinaten angegebenen Point in einen Point, der das aktuelle Koordinatensystem des Visual darstellt.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

(Geerbt von Visual)
PointToScreen(Point)

Konvertiert einen Point, der das aktuelle Koordinatensystem des Visual darstellt, in einen in Bildschirmkoordinaten angegebenen Point.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

(Geerbt von Visual)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
RemoveVisualChild(Visual)

Entfernt die hierarchische Beziehung zwischen zwei visuellen Elementen.Removes the parent-child relationship between two visuals.

(Geerbt von Visual)
RenderOpen()

Öffnet das DrawingVisual-Objekt für das Rendering.Opens the DrawingVisual object for rendering. Der zurückgegebene DrawingContext-Wert kann zum Rendern in das DrawingVisual verwendet werden.The returned DrawingContext value can be used to render into the DrawingVisual.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.Sets the local value of a dependency property, specified by its dependency property identifier.

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

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TransformToAncestor(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in den Visual-Vorgänger des visuellen Objekts transformiert werden können.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

(Geerbt von Visual)
TransformToAncestor(Visual3D)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in den Visual3D-Vorgänger des visuellen Objekts transformiert werden können.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

(Geerbt von Visual)
TransformToDescendant(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in den angegebenen Nachfolger des visuellen Objekts transformiert werden können.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

(Geerbt von Visual)
TransformToVisual(Visual)

Gibt eine Transformation zurück, mit der Koordinaten des Visual in das angegebene visuelle Objekt transformiert werden können.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

(Geerbt von Visual)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Gilt für: