DrawingVisual DrawingVisual DrawingVisual DrawingVisual Class

Definición

DrawingVisual es un objeto visual que puede usarse para presentar gráficos vectoriales en la pantalla.DrawingVisual is a visual object that can be used to render vector graphics on the screen. El sistema conserva el contenido.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
Herencia

Comentarios

DrawingVisuales una clase de dibujo ligera que se utiliza para representar formas, imágenes o texto.DrawingVisual is a lightweight drawing class that is used to render shapes, images, or text. Esta clase se considera ligera porque no proporciona control de diseño, de entrada, de foco o de eventos, lo que mejora su rendimiento.This class is considered lightweight because it does not provide layout, input, focus, or event handling, which improves its performance. Por esta razón, los dibujos son ideales para fondos e imágenes prediseñadas.For this reason, drawings are ideal for backgrounds and clip art.

Para usar DrawingVisual objetos, debe crear un contenedor host para los objetos.In order to use DrawingVisual objects, you need to create a host container for the objects. El objeto contenedor host se debe derivar de FrameworkElement la clase, que proporciona el diseño y la compatibilidad con el DrawingVisual control de eventos que la clase no admite.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. El objeto contenedor host no muestra ninguna propiedad visual, ya que su finalidad principal es contener objetos secundarios.The host container object does not display any visual properties, since its main purpose is to contain child objects. Para más información, consulte Usar objetos DrawingVisual.For more information, see Using DrawingVisual Objects.

Para ver un ejemplo completo en el que DrawingVisual se muestra cómo crear objetos con un contenedor host, vea la prueba de posicionamiento mediante el ejemplo DrawingVisuals .For a complete example showing how to create DrawingVisual objects with a host container, see the Hit Test Using DrawingVisuals Sample .

Constructores

DrawingVisual() DrawingVisual() DrawingVisual() DrawingVisual()

Inicializa una nueva instancia de la clase DrawingVisual.Initializes a new instance of the DrawingVisual class.

Propiedades

BitmapEffect BitmapEffect BitmapEffect BitmapEffect

Obtiene o establece un valor de BitmapEffect para ContainerVisual.Gets or sets a BitmapEffect value for the ContainerVisual.

(Inherited from ContainerVisual)
BitmapEffectInput BitmapEffectInput BitmapEffectInput BitmapEffectInput

Obtiene o establece un valor de BitmapEffectInput para ContainerVisual.Gets or sets a BitmapEffectInput value for the ContainerVisual.

(Inherited from ContainerVisual)
CacheMode CacheMode CacheMode CacheMode

Obtiene o establece una representación en caché del objeto ContainerVisual.Gets or sets a cached representation of the ContainerVisual.

(Inherited from ContainerVisual)
Children Children Children Children

Obtiene la colección secundaria de ContainerVisual.Gets the child collection of the ContainerVisual.

(Inherited from ContainerVisual)
Clip Clip Clip Clip

Obtiene o establece la región de recorte de ContainerVisual.Gets or sets the clipping region of the ContainerVisual.

(Inherited from ContainerVisual)
ContentBounds ContentBounds ContentBounds ContentBounds

Obtiene el rectángulo de selección para el contenido de ContainerVisual.Gets the bounding box for the contents of the ContainerVisual.

(Inherited from ContainerVisual)
DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
DescendantBounds DescendantBounds DescendantBounds DescendantBounds

Obtiene la unión de todos los rectángulos de selección del contenido de todos los descendientes del objeto ContainerVisual, sin incluir el contenido de 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.

(Inherited from ContainerVisual)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtiene el objeto Dispatcher al que está asociado DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Drawing Drawing Drawing Drawing

Obtiene el contexto de dibujo del objeto DrawingVisual.Gets the drawing content of the DrawingVisual object.

Effect Effect Effect Effect

Obtiene o establece el efecto de imagen que se va a aplicar a ContainerVisual.Gets or sets the bitmap effect to apply to the ContainerVisual.

(Inherited from ContainerVisual)
IsSealed IsSealed IsSealed IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Offset Offset Offset Offset

Obtiene o establece el valor de desplazamiento de ContainerVisual desde su punto de referencia.Gets or sets the offset value of the ContainerVisual from its reference point.

(Inherited from ContainerVisual)
Opacity Opacity Opacity Opacity

Obtiene o establece la opacidad de ContainerVisual, siendo 0 = transparente y 1 = opaco.Gets or sets the opacity of the ContainerVisual, based on 0=transparent, 1=opaque.

(Inherited from ContainerVisual)
OpacityMask OpacityMask OpacityMask OpacityMask

Obtiene o establece un pincel que especifica una posible máscara de opacidad para ContainerVisual.Gets or sets a brush that specifies a possible opacity mask for the ContainerVisual.

(Inherited from ContainerVisual)
Parent Parent Parent Parent

Obtiene el objeto Visual primario de ContainerVisual.Gets the parent Visual for the ContainerVisual.

(Inherited from ContainerVisual)
Transform Transform Transform Transform

Obtiene o establece la transformación aplicada a ContainerVisual.Gets or sets the transform that is applied to the ContainerVisual.

(Inherited from ContainerVisual)
VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect VisualBitmapEffect

Obtiene o establece el valor de BitmapEffect para Visual.Gets or sets the BitmapEffect value for the Visual.

(Inherited from Visual)
VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput VisualBitmapEffectInput

Obtiene o establece el valor de BitmapEffectInput para Visual.Gets or sets the BitmapEffectInput value for the Visual.

(Inherited from Visual)
VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode VisualBitmapScalingMode

Obtiene o establece el objeto BitmapScalingMode para Visual.Gets or sets the BitmapScalingMode for the Visual.

(Inherited from Visual)
VisualCacheMode VisualCacheMode VisualCacheMode VisualCacheMode

Obtiene o establece una representación en caché del objeto Visual.Gets or sets a cached representation of the Visual.

(Inherited from Visual)
VisualChildrenCount VisualChildrenCount VisualChildrenCount VisualChildrenCount

Obtiene el número de elementos secundarios del objeto ContainerVisual.Gets the number of children for the ContainerVisual.

(Inherited from ContainerVisual)
VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint VisualClearTypeHint

Obtiene o establece el valor de ClearTypeHint que determina cómo se presenta ClearType en el objeto Visual.Gets or sets the ClearTypeHint that determines how ClearType is rendered in the Visual.

(Inherited from Visual)
VisualClip VisualClip VisualClip VisualClip

Obtiene o establece la región de recorte del objeto Visual como valor de Geometry.Gets or sets the clip region of the Visual as a Geometry value.

(Inherited from Visual)
VisualEdgeMode VisualEdgeMode VisualEdgeMode VisualEdgeMode

Obtiene o establece el modo de borde del objeto Visual como valor de EdgeMode.Gets or sets the edge mode of the Visual as an EdgeMode value.

(Inherited from Visual)
VisualEffect VisualEffect VisualEffect VisualEffect

Obtiene o establece el efecto de imagen que se va a aplicar a Visual.Gets or sets the bitmap effect to apply to the Visual.

(Inherited from Visual)
VisualOffset VisualOffset VisualOffset VisualOffset

Obtiene o establece el valor de desplazamiento del objeto visual.Gets or sets the offset value of the visual object.

(Inherited from Visual)
VisualOpacity VisualOpacity VisualOpacity VisualOpacity

Obtiene o establece la opacidad del objeto Visual.Gets or sets the opacity of the Visual.

(Inherited from Visual)
VisualOpacityMask VisualOpacityMask VisualOpacityMask VisualOpacityMask

Obtiene o establece el valor de Brush que representa la máscara de opacidad del objeto Visual.Gets or sets the Brush value that represents the opacity mask of the Visual.

(Inherited from Visual)
VisualParent VisualParent VisualParent VisualParent

Obtiene el objeto primario del árbol visual del objeto visual.Gets the visual tree parent of the visual object.

(Inherited from Visual)
VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip VisualScrollableAreaClip

Obtiene o establece un área de recorte desplazable del objeto Visual.Gets or sets a clipped scrollable area for the Visual.

(Inherited from Visual)
VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode VisualTextHintingMode

Obtiene o establece el TextHintingMode de Visual.Gets or sets the TextHintingMode of the Visual.

(Inherited from Visual)
VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode VisualTextRenderingMode

Obtiene o establece el TextRenderingMode de Visual.Gets or sets the TextRenderingMode of the Visual.

(Inherited from Visual)
VisualTransform VisualTransform VisualTransform VisualTransform

Obtiene o establece el valor de Transform para Visual.Gets or sets the Transform value for the Visual.

(Inherited from Visual)
VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines VisualXSnappingGuidelines

Obtiene o establece la colección de instrucciones de la coordenada x (vertical).Gets or sets the x-coordinate (vertical) guideline collection.

(Inherited from Visual)
VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines VisualYSnappingGuidelines

Obtiene o establece la colección de instrucciones de la coordenada y (horizontal).Gets or sets the y-coordinate (horizontal) guideline collection.

(Inherited from Visual)
XSnappingGuidelines XSnappingGuidelines XSnappingGuidelines XSnappingGuidelines

Obtiene o establece la coordenada X (horizontal) de ContainerVisual.Gets or sets the X (horizontal) guideline for the ContainerVisual.

(Inherited from ContainerVisual)
YSnappingGuidelines YSnappingGuidelines YSnappingGuidelines YSnappingGuidelines

Obtiene o establece la coordenada Y (vertical) de ContainerVisual.Gets or sets the Y (vertical) guideline for the ContainerVisual.

(Inherited from ContainerVisual)

Métodos

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

Define la relación primario-secundario entre dos objetos visuales.Defines the parent-child relationship between two visuals.

(Inherited from Visual)
CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina si el subproceso de la llamada tiene acceso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

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

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

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

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

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

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama.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 si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

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

Devuelve el antecesor común de dos objetos visuales.Returns the common ancestor of two visual objects.

(Inherited from Visual)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

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

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de 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)

Devuelve el objeto Visual secundario especificado del objeto ContainerVisual primario.Returns a specified child Visual for the parent ContainerVisual.

(Inherited from ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia una prueba de posicionamiento en ContainerVisual mediante los objetos HitTestFilterCallback y HitTestResultCallback.Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

(Inherited from ContainerVisual)
HitTest(Point) HitTest(Point) HitTest(Point) HitTest(Point)

Devuelve el objeto visual de nivel superior de una prueba de posicionamiento al especificar un objeto Point.Returns the top-most visual object of a hit test by specifying a Point.

(Inherited from ContainerVisual)
HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters) HitTestCore(GeometryHitTestParameters)

Determina si un valor geométrico está dentro de los límites del objeto visual.Determines whether a geometry value is within the bounds of the visual object.

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

Determina si un valor de coordenada de punto está dentro de los límites del objeto DrawingVisual.Determines whether a point coordinate value is within the bounds of the DrawingVisual object.

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

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property

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

Determina si el objeto visual es un antecesor del objeto visual descendiente.Determines whether the visual object is an ancestor of the descendant visual object.

(Inherited from Visual)
IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

Determina si el objeto visual es un descendiente del objeto visual antecesor.Determines whether the visual object is a descendant of the ancestor visual object.

(Inherited from Visual)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Llamado cuando cambia el valor de PPP en el que este cuadro de texto enriquecido se representa.Called when the DPI at which this View is rendered changes.

(Inherited from Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Se informa de la propiedad de dependencia concreta que cambió en los datos de 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)

Se le llama cuando se modifica la colección VisualCollection del objeto visual.Called when the VisualCollection of the visual object is modified.

(Inherited from Visual)
OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

Se le llama cuando se cambia el objeto primario del objeto visual.Called when the parent of the visual object is changed.

(Inherited from Visual)
PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point) PointFromScreen(Point)

Convierte un objeto Point en coordenadas de pantalla en un objeto Point que representa el sistema de coordenadas actual de Visual.Converts a Point in screen coordinates into a Point that represents the current coordinate system of the Visual.

(Inherited from Visual)
PointToScreen(Point) PointToScreen(Point) PointToScreen(Point) PointToScreen(Point)

Convierte un objeto Point que representa el sistema de coordenadas actual del objeto Visual en un objeto Point de coordenadas de pantalla.Converts a Point that represents the current coordinate system of the Visual into a Point in screen coordinates.

(Inherited from Visual)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

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

Quita la relación primario-secundario entre dos objetos visuales.Removes the parent-child relationship between two visuals.

(Inherited from Visual)
RenderOpen() RenderOpen() RenderOpen() RenderOpen()

Abre el objeto DrawingVisual para su representación.Opens the DrawingVisual object for rendering. El valor de DrawingContext devuelto se puede utilizar para representar en DrawingVisual.The returned DrawingContext value can be used to render into the DrawingVisual.

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

Establece el valor de una propiedad de dependencia sin cambiar el origen del valor.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)

Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia.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)

Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia.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)

Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

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

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el antecesor del objeto Visual especificado del objeto visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual ancestor of the visual object.

(Inherited from Visual)
TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el antecesor del objeto Visual3D especificado del objeto visual.Returns a transform that can be used to transform coordinates from the Visual to the specified Visual3D ancestor of the visual object.

(Inherited from Visual)
TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual) TransformToDescendant(Visual)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el descendiente del objeto visual especificado.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object descendant.

(Inherited from Visual)
TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual) TransformToVisual(Visual)

Devuelve una transformación que se puede usar para transformar las coordenadas desde el objeto Visual en el objeto visual especificado.Returns a transform that can be used to transform coordinates from the Visual to the specified visual object.

(Inherited from Visual)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Exige que el subproceso de la llamada tenga acceso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Se aplica a