BitmapCacheBrush Clase

Definición

Pinta un área con contenido de la caché.Paints an area with cached content.

public ref class BitmapCacheBrush sealed : System::Windows::Media::Brush
public sealed class BitmapCacheBrush : System.Windows.Media.Brush
type BitmapCacheBrush = class
    inherit Brush
Public NotInheritable Class BitmapCacheBrush
Inherits Brush
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo BitmapCache asociar BitmapCacheBrushun con un.The following code example shows how to associate a BitmapCache with a BitmapCacheBrush. Puede usar el BitmapCacheBrush recurso en varios elementos y lograr un buen rendimiento.You can use the BitmapCacheBrush resource on multiple elements and achieve good performance. Para obtener la lista de código completa , consulte Cómo: Usar un elemento almacenado en caché como unpincel.For the complete code listing, see How to: Use a Cached Element as a Brush.

<Window.Resources>
    <RichTextBox x:Key="cachedRichTextBox"  >
        <RichTextBox.CacheMode>
            <BitmapCache EnableClearType="True" RenderAtScale="1" SnapsToDevicePixels="True" />
        </RichTextBox.CacheMode>
    </RichTextBox>

    <BitmapCacheBrush x:Key="cachedRichTextBoxBrush" Target="{StaticResource cachedRichTextBox}">
        <BitmapCacheBrush.BitmapCache>
            <BitmapCache EnableClearType="False" RenderAtScale="0.4" SnapsToDevicePixels="False" />
        </BitmapCacheBrush.BitmapCache>
    </BitmapCacheBrush>        
</Window.Resources>

Comentarios

Use la BitmapCacheBrush clase para reutilizar eficazmente un elemento almacenado en caché.Use the BitmapCacheBrush class to reuse a cached element efficiently. Esto resulta útil cuando se necesita pintar contenido complejo en varios elementos.This is useful when you need to paint complex content onto multiple elements. Use la BitmapCache clase para almacenar en caché un elemento complejo.Use the BitmapCache class to cache a complex element.

Asigne a la Target propiedad y, opcionalmente, asigne BitmapCache un a BitmapCache la propiedad. VisualAssign a Visual to the Target property and optionally assign a BitmapCache to the BitmapCache property. El CacheMode del pincel y el destino Visual interactúan para generar diferentes comportamientos.The CacheMode of the brush and the target Visual interact to produce different behaviors. En la tabla siguiente se describe esta interacción.The following table describes this interaction.

El destino no tiene CacheModeTarget has no CacheMode El destino tiene CacheModeTarget has CacheMode
Brush no tiene CacheModeBrush has no CacheMode Los objetos visuales de destino se representan normalmente; Brush usa el comportamiento de caché predeterminado.Target visual renders normally; brush uses default cache behavior. El visual de destino se representa en su propia memoria caché; Brush usa la memoria caché del destino al representarla.Target visual renders into its own cache; brush uses target's cache when rendering.
El pincel tiene CacheModeBrush has CacheMode Los objetos visuales de destino se representan normalmente; Brush representa el destino en su propia memoria caché y lo usa para representar.Target visual renders normally; brush renders target into its own cache and uses this to render. El visual de destino se representa en su propia memoria caché; Brush representa el destino en la propia memoria caché del pincel y lo usa para representar.Target visual renders into its own cache; brush renders target into brush's own cache and uses this to render.

La BitmapCacheBrush clase es similar a la VisualBrush clase, pero BitmapCacheBrush siempre se representa desde una caché en el elemento de destino, o desde una memoria caché definida BitmapCache por la propiedad.The BitmapCacheBrush class is similar to the VisualBrush class, but BitmapCacheBrush always renders from a cache on the target element, or from a cache defined by the BitmapCache property. La BitmapCacheBrush clase también admite regiones desfasadas.The BitmapCacheBrush class also supports dirty regions.

En la tabla siguiente se muestra la configuración predeterminada de la BitmapCacheBrush caché de mapas de bits para la clase.The following table shows the default bitmap cache settings for the BitmapCacheBrush class.

Propiedad de caché de mapa de bitsBitmap Cache Property Configuración predeterminadaDefault Setting
SnapsToDevicePixels false
EnableClearType false
RenderAtScale 11

La SnapsToDevicePixels BitmapCacheBrush clase omite la propiedad.The SnapsToDevicePixels property is ignored by the BitmapCacheBrush class.

La BitmapCacheBrush clase omite las siguientes propiedades en la raíz Visual.The BitmapCacheBrush class ignores the following properties on the root Visual. Este comportamiento difiere de la VisualBrush clase.This behavior differs from the VisualBrush class.

Constructores

BitmapCacheBrush()

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

BitmapCacheBrush(Visual)

Inicializa una nueva instancia de la clase BitmapCacheBrush con el objeto Visual especificado.Initializes a new instance of the BitmapCacheBrush class with the specified Visual.

Campos

AutoLayoutContentProperty

Identifica la propiedad de dependencia AutoLayoutContent.Identifies the AutoLayoutContent dependency property.

BitmapCacheProperty

Identifica la propiedad de dependencia BitmapCache.Identifies the BitmapCache dependency property.

TargetProperty

Identifica la propiedad de dependencia Target.Identifies the Target dependency property.

Propiedades

AutoLayoutContent

Obtiene o establece un valor que indica si el diseño se aplica al contenido de este pincel.Gets or sets a value that indicates whether layout is applied to the contents of this brush.

BitmapCache

Obtiene o establece CacheMode que representa el contenido almacenado en memoria caché.Gets or sets a CacheMode that represents cached content.

CanFreeze

Obtiene un valor que indica si el objeto se puede convertir en no modificable.Gets a value that indicates whether the object can be made unmodifiable.

(Heredado de Freezable)
DependencyObjectType

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

(Heredado de DependencyObject)
Dispatcher

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

(Heredado de DispatcherObject)
HasAnimatedProperties

Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Heredado de Animatable)
IsFrozen

Obtiene un valor que indica si el objeto se puede modificar actualmente.Gets a value that indicates whether the object is currently modifiable.

(Heredado de Freezable)
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).

(Heredado de DependencyObject)
Opacity

Obtiene o establece el grado de opacidad de Brush.Gets or sets the degree of opacity of a Brush.

(Heredado de Brush)
RelativeTransform

Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas.Gets or sets the transformation that is applied to the brush using relative coordinates.

(Heredado de Brush)
Target

Obtiene o establece el objeto visual de destino para guardar en memoria caché.Gets or sets the target visual to cache.

Transform

Obtiene o establece la transformación que se aplica al pincel.Gets or sets the transformation that is applied to the brush. Esta transformación se aplica después de haber asignado y colocado la salida del pincel.This transformation is applied after the brush's output has been mapped and positioned.

(Heredado de Brush)

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Se aplica AnimationClock al valor de DependencyProperty especificado.Applies an AnimationClock to the specified DependencyProperty. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado.If the property is already animated, the specified HandoffBehavior is used.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Aplica una animación a la DependencyProperty especificada.Applies an animation to the specified DependencyProperty. La animación se inicia al representar el siguiente fotograma.The animation is started when the next frame is rendered. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado.If the specified property is already animated, the specified HandoffBehavior is used.

(Heredado de Animatable)
CheckAccess()

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

(Heredado de DispatcherObject)
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.

(Heredado de DependencyObject)
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.

(Heredado de DependencyObject)
Clone()

Crea un clon modificable del elemento BitmapCacheBrush y hace copias en profundidad de los valores del objeto.Creates a modifiable clone of the BitmapCacheBrush, making deep copies of the object's values. Cuando se copian las propiedades de dependencia del objeto, este método copia las expresiones (que puede que ya no se resuelvan), pero no copia las animaciones ni sus valores actuales.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

CloneCore(Freezable)

Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con valores de propiedad base (no animadas).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Heredado de Freezable)
CloneCurrentValue()

Crea un clon modificable (copia en profundidad) de BitmapCacheBrush con sus valores actuales.Creates a modifiable clone (deep copy) of the BitmapCacheBrush using its current values.

CloneCurrentValueCore(Freezable)

Convierte esta instancia en un clon modificable (copia en profundidad) del Freezable especificado mediante los valores de propiedad actuales.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Heredado de Freezable)
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.

(Heredado de DependencyObject)
CreateInstance()

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

(Heredado de Freezable)
CreateInstanceCore()

Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Heredado de Freezable)
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.

(Heredado de DependencyObject)
Freeze()

Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Heredado de Freezable)
FreezeCore(Boolean)

Convierte este objeto Animatable en no modificable o determina si se puede convertir en no modificable.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Heredado de Animatable)
GetAnimationBaseValue(DependencyProperty)

Devuelve el valor no animado del objeto DependencyProperty especificado.Returns the non-animated value of the specified DependencyProperty.

(Heredado de Animatable)
GetAsFrozen()

Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas).Creates a frozen copy of the Freezable, using base (non-animated) property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Heredado de Freezable)
GetAsFrozenCore(Freezable)

Convierte la instancia en un clon inmovilizado de la clase Freezable especificada con los valores de propiedades base (no animadas).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Heredado de Freezable)
GetCurrentValueAsFrozen()

Crea una copia inmovilizada de Freezable con los valores de propiedad actuales.Creates a frozen copy of the Freezable using current property values. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convierte la instancia actual en un clon inmovilizado de la clase Freezable especificada.Makes the current instance a frozen clone of the specified Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales.If the object has animated dependency properties, their current animated values are copied.

(Heredado de Freezable)
GetHashCode()

Obtiene un código hash de este objeto DependencyObject.Gets a hash code for this DependencyObject.

(Heredado de DependencyObject)
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.

(Heredado de DependencyObject)
GetType()

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

(Heredado de Object)
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.

(Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)

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

(Heredado de DependencyObject)
MemberwiseClone()

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

(Heredado de Object)
OnChanged()

Se le llama cuando el objeto Freezable actual se modifica.Called when the current Freezable object is modified.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Reemplaza la implementación DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también cualquier controlador Changed en respuesta a una propiedad de dependencia cambiante de tipo Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Heredado de Freezable)
ReadLocalValue(DependencyProperty)

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

(Heredado de DependencyObject)
ReadPreamble()

Se asegura de que se tiene acceso a Freezable desde un subproceso válido.Ensures that the Freezable is being accessed from a valid thread. Los herederos de Freezable deben llamar a este método al inicio de las API que leen miembros de datos que no son propiedades de dependencia.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Heredado de Freezable)
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.

(Heredado de DependencyObject)
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.

(Heredado de DependencyObject)
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.

(Heredado de DependencyObject)
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.

(Heredado de DependencyObject)
ToString()

Devuelve una representación en forma de cadena de Brush.Return string representation of this Brush.

(Heredado de Brush)
ToString(IFormatProvider)

Crea una representación de cadena de este objeto con la información de formato específica de la referencia cultural especificada.Creates a string representation of this object based on the specified culture-specific formatting information.

(Heredado de Brush)
VerifyAccess()

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

(Heredado de DispatcherObject)
WritePostscript()

Genera el evento Changed para Freezable e invoca su método OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no estén almacenados como propiedades de dependencia.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Heredado de Freezable)
WritePreamble()

Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Los herederos de Freezable deben llamar a este método al inicio de las API que escriben en miembros de datos que no son propiedades de dependencia.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Heredado de Freezable)

Eventos

Changed

Se produce cuando se modifican la clase Freezable o un objeto que la contiene.Occurs when the Freezable or an object it contains is modified.

(Heredado de Freezable)

Implementaciones de interfaz explícitas

IFormattable.ToString(String, IFormatProvider)

Aplica formato al valor de la instancia actual utilizando el formato especificado.Formats the value of the current instance using the specified format.

(Heredado de Brush)

Se aplica a

Consulte también: