BitmapCacheBrush Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Media

Ensamblado:: PresentationCore.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Pinta un área con contenido de la 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 .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 clase BitmapCacheBrush 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 objeto a la Target propiedad y, opcionalmente, asigne a BitmapCache la BitmapCache propiedad . del CacheMode pincel y del destino Visual interactúan para generar comportamientos diferentes. En la tabla siguiente se describe esta interacción.

	El destino no tiene CacheMode	El destino tiene CacheMode
Brush no tiene cacheMode	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 memoria caché; Brush usa la memoria caché del destino al representar.
Brush tiene CacheMode	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 memoria caché; brush representa el destino en la propia 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 de caché de mapa de bits predeterminada 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 .

Constructores

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

Campos

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

Propiedades

AutoLayoutContent	Obtiene o establece un valor que indica si el diseño se aplica al contenido de este pincel.
BitmapCache	Obtiene o establece CacheMode que representa el contenido almacenado en memoria caché.
CanFreeze	Obtiene un valor que indica si el objeto se puede convertir en 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 Dispatcher al que está asociado DispatcherObject. (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. (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 (es de solo lectura). (Heredado de DependencyObject)
Opacity	Obtiene o establece el grado de opacidad de Brush. (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 para guardar en memoria caché.
Transform	Obtiene o establece la transformación que se aplica al pincel. Esta transformación se aplica después de haber asignado y colocado la salida del pincel. (Heredado de Brush)

Métodos

ApplyAnimationClock(DependencyProperty, AnimationClock)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Se aplica AnimationClock al valor de DependencyProperty especificado. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega SnapshotAndReplace. (Heredado de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Aplica una animación a la DependencyProperty especificada. La animación se inicia al representar el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado. (Heredado de Animatable)
CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (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 un DependencyPropertyKey. (Heredado de DependencyObject)
Clone()	Crea un clon modificable del elemento BitmapCacheBrush y hace copias en profundidad de los valores del objeto. 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.
CloneCore(Freezable)	Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con valores de propiedad base (no animadas). (Heredado de Freezable)
CloneCurrentValue()	Crea un clon modificable (copia en profundidad) de BitmapCacheBrush con sus valores actuales.
CloneCurrentValueCore(Freezable)	Convierte esta instancia en un clon modificable (copia en profundidad) del Freezable especificado mediante los valores de propiedad actuales. (Heredado de Freezable)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. 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. (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 clase Freezable derivada. (Heredado de Freezable)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
Freeze()	Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en `true`. (Heredado de Freezable)
FreezeCore(Boolean)	Convierte este objeto Animatable en no modificable o determina si se puede convertir en no modificable. (Heredado de Animatable)
GetAnimationBaseValue(DependencyProperty)	Devuelve el valor no animado del objeto DependencyProperty especificado. (Heredado de Animatable)
GetAsFrozen()	Crea una copia inmovilizada de Freezable, con los valores de propiedades base (no animadas). Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (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). (Heredado de Freezable)
GetCurrentValueAsFrozen()	Crea una copia inmovilizada de Freezable con los valores de propiedad actuales. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Heredado de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convierte la instancia actual en un clon inmovilizado del valor de Freezable especificado. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales. (Heredado de Freezable)
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnChanged()	Se le llama cuando el objeto Freezable actual se modifica. (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. (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)
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. (Heredado de Freezable)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReadPreamble()	Se asegura de que se tiene acceso a Freezable desde un subproceso válido. 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. (Heredado de Freezable)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (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. (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. (Heredado de DependencyObject)
ToString()	Devuelve una representación en forma de cadena de 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. (Heredado de Brush)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)
WritePostscript()	Genera el evento Changed para Freezable e invoca su método OnChanged(). 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. (Heredado de Freezable)
WritePreamble()	Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido. 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. (Heredado de Freezable)

Eventos

Changed

Se produce cuando se modifican la clase Freezable o un objeto que la contiene.

(Heredado de Freezable)

Implementaciones de interfaz explícitas

IFormattable.ToString(String, IFormatProvider)

Da formato al valor de la instancia actual usando el formato especificado.

(Heredado de Brush)

Se aplica a

Compartir vía