BitmapCacheBrush Clase

Definición

Espacio de nombres:

System.Windows.Media

Ensamblado:

PresentationCore.dll

Pinta un área con contenido almacenado en caché.

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

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

BitmapCacheBrush

Ejemplos

En el ejemplo de código siguiente se muestra cómo asociar un BitmapCache objeto a un BitmapCacheBrush. Puede usar el BitmapCacheBrush recurso en varios elementos y lograr un buen rendimiento. Para obtener la lista de código completa, vea Cómo: Usar un elemento almacenado en caché como pincel.

<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 un elemento almacenado en caché de forma eficaz. Esto resulta útil cuando necesita pintar contenido complejo en varios elementos. Use la BitmapCache clase para almacenar en caché un elemento complejo.

Asigne un Visual elemento a la Target propiedad y, opcionalmente, asigne un BitmapCache elemento a la BitmapCache propiedad . CacheMode del pincel y del destino Visual interactúan para generar comportamientos diferentes. En la tabla siguiente se describe esta interacción.

Brush tiene CacheMode	El destino no tiene cacheMode	El destino tiene CacheMode
No	El objeto visual de destino se representa normalmente; brush usa el comportamiento predeterminado de la caché.	El objeto visual de destino se representa en su propia caché; brush usa la memoria caché del destino al representar.
Sí	El objeto visual de destino se representa normalmente; brush representa el destino en su propia memoria caché y lo usa para representarlo.	El objeto visual de destino se representa en su propia caché; brush representa el destino en la propia memoria caché del pincel y lo usa para representarlo.

La BitmapCacheBrush clase es similar a la VisualBrush clase , pero BitmapCacheBrush siempre se representa desde una memoria caché en el elemento de destino, o desde una caché definida por la BitmapCache propiedad . La BitmapCacheBrush clase también admite regiones desfasadas.

En la tabla siguiente se muestra la configuración predeterminada de caché de mapa de bits para la BitmapCacheBrush clase .

Bitmap Cache (propiedad)	Valor predeterminado
SnapsToDevicePixels	false
EnableClearType	false
RenderAtScale	1

La SnapsToDevicePixels clase omite la BitmapCacheBrush propiedad .

La BitmapCacheBrush clase omite las siguientes propiedades en la raíz Visual. Este comportamiento difiere de la VisualBrush clase .

• VisualOffset

• VisualTransform

• VisualClip

• VisualEffect

• VisualOpacity

• VisualOpacityMask

Constructores

Nombre	Description
BitmapCacheBrush()	Inicializa una nueva instancia de la clase BitmapCacheBrush.
BitmapCacheBrush(Visual)	Inicializa una nueva instancia de la BitmapCacheBrush clase con el especificado Visual.

Campos

Nombre	Description
AutoLayoutContentProperty	Identifica la AutoLayoutContent propiedad de dependencia.
BitmapCacheProperty	Identifica la BitmapCache propiedad de dependencia.
TargetProperty	Identifica la Target propiedad de dependencia.

Propiedades

Nombre	Description
AutoLayoutContent	Obtiene o establece un valor que indica si el diseño se aplica al contenido de este pincel.
BitmapCache	Obtiene o establece un CacheMode objeto que representa el contenido almacenado en caché.
CanFreeze	Obtiene un valor que indica si el objeto se puede hacer no modificable. (Heredado de Freezable)
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto al que DispatcherDispatcherObject está asociado. (Heredado de DispatcherObject)
HasAnimatedProperties	Obtiene un valor que indica si uno o varios AnimationClock objetos están asociados a cualquiera de las propiedades de dependencia de este objeto. (Heredado de Animatable)
IsFrozen	Obtiene un valor que indica si el objeto se puede modificar actualmente. (Heredado de Freezable)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (solo lectura). (Heredado de DependencyObject)
Opacity	Obtiene o establece el grado de opacidad de un Brushobjeto . (Heredado de Brush)
RelativeTransform	Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas. (Heredado de Brush)
Target	Obtiene o establece el objeto visual de destino que se va a almacenar en caché.
Transform	Obtiene o establece la transformación que se aplica al pincel. Esta transformación se aplica después de asignar y colocar la salida del pincel. (Heredado de Brush)

Métodos

Nombre	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica un AnimationClock objeto al especificado DependencyProperty. Si la propiedad ya está animada, se usa el especificado HandoffBehavior . (Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica un AnimationClock objeto al especificado DependencyProperty. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace . (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación al especificado DependencyProperty. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el especificado HandoffBehavior . (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación al especificado DependencyProperty. La animación se inicia cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace . (Heredado de Animatable)
CheckAccess()	Determina si el subproceso que llama tiene acceso a este DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. Un identificador especifica DependencyProperty la propiedad que se va a borrar. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante .DependencyPropertyKey (Heredado de DependencyObject)
Clone()	Crea un clon modificable de BitmapCacheBrush, haciendo copias profundas de los valores del objeto. Al copiar las propiedades de dependencia del objeto, este método copia expresiones (que podrían dejar de resolverse), pero no animaciones ni sus valores actuales.
CloneCore(Freezable)	Convierte la instancia en un clon (copia profunda) del especificado Freezable mediante valores de propiedad base (no animados). (Heredado de Freezable)
CloneCurrentValue()	Crea un clon modificable (copia profunda) del BitmapCacheBrush utilizando sus valores actuales.
CloneCurrentValueCore(Freezable)	Convierte la instancia en un clon modificable (copia profunda) del especificado Freezable mediante los valores de propiedad actuales. (Heredado de Freezable)
CoerceValue(DependencyProperty)	Coerce el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier CoerceValueCallback función especificada en metadatos de propiedad para la propiedad de dependencia tal como existe en la llamada DependencyObjecta . (Heredado de DependencyObject)
CreateInstance()	Inicializa una nueva instancia de la clase Freezable. (Heredado de Freezable)
CreateInstanceCore()	Cuando se implementa en una clase derivada, crea una nueva instancia de la Freezable clase derivada. (Heredado de Freezable)
Equals(Object)	Determina si un proporcionado DependencyObject es equivalente al objeto actual DependencyObject. (Heredado de DependencyObject)
Freeze()	Hace que el objeto actual no se pueda modificar y establezca su IsFrozen propiedad trueen . (Heredado de Freezable)
FreezeCore(Boolean)	Hace que este Animatable objeto no se pueda modificar o determina si se puede hacer no modificable. (Heredado de Animatable)
GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado del especificado DependencyProperty. (Heredado de Animatable)
GetAsFrozen()	Crea una copia inmovilizada de , Freezablemediante valores de propiedad base (no animados). Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetAsFrozenCore(Freezable)	Convierte la instancia en un clon inmovilizado del especificado Freezable mediante valores de propiedad base (no animados). (Heredado de Freezable)
GetCurrentValueAsFrozen()	Crea una copia inmovilizada de mediante los valores de Freezable propiedad actuales. Dado que la copia está inmovilizada, los sub-objetos congelados se copian por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte la instancia actual en un clon inmovilizado del especificado Freezable. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales. (Heredado de Freezable)
GetHashCode()	Obtiene un código hash para este DependencyObjectobjeto . (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia tienen valores establecidos localmente en este DependencyObject. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de .DependencyObject (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo de la propiedad de dependencia especificada. (Heredado de DependencyObject)
OnChanged()	Se llama cuando se modifica el objeto actual Freezable . (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no está pensada para usarse directamente desde el código. (Heredado de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantiza que los punteros de contexto adecuados se establecen para un DependencyObjectType miembro de datos que se acaba de establecer. (Heredado de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invalida la DependencyObject implementación de OnPropertyChanged(DependencyPropertyChangedEventArgs) para invocar también los Changed controladores en respuesta a una propiedad de dependencia cambiante de tipo Freezable. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReadPreamble()	Garantiza que Freezable se accede a desde un subproceso válido. Los heredadores de Freezable deben llamar a este método al principio de cualquier API que lea miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar su origen de valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificada por el DependencyPropertyKey identificador de la propiedad de dependencia. (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 proporcionada. (Heredado de DependencyObject)
ToString()	Devuelve la representación de cadena de este Brush. (Heredado de Brush)
ToString(IFormatProvider)	Crea una representación de cadena de este objeto en función de la información de formato específica de la referencia cultural especificada. (Heredado de Brush)
VerifyAccess()	Exige que el subproceso de llamada tenga acceso a este DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el Changed evento para e Freezable invoca su OnChanged() método . Las clases que derivan de Freezable deben llamar a este método al final de cualquier API que modifique los miembros de clase que no se almacenan como propiedades de dependencia. (Heredado de Freezable)
WritePreamble()	Comprueba que Freezable no está inmovilizado y que se accede a él desde un contexto de subproceso válido. Freezable Los heredares deben llamar a este método al principio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Heredado de Freezable)

Eventos

Nombre	Description
Changed	Se produce cuando se modifica o Freezable un objeto que contiene. (Heredado de Freezable)

Implementaciones de interfaz explícitas

Nombre	Description
IFormattable.ToString(String, IFormatProvider)	Da formato al valor de la instancia actual mediante el formato especificado. (Heredado de Brush)

Consulte también

• BitmapCache
• Visual