Brush Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Media

Define los objetos usados para pintar objetos gráficos. Las clases que derivan de Brush describen cómo se pinta el área.

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

Herencia

Object Platform::Object IInspectable DependencyObject Brush

Derivado

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IAnimationObject

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Para obtener ejemplos y una explicación adicional de los conceptos de dibujo de la interfaz de usuario representados por Brush, consulte Uso de pinceles.

Pinceles como recursos XAML

Cada uno de los tipos brush que se pueden declarar en XAML (SolidColorBrush, LinearGradientBrush, ImageBrush) está diseñado para definirse como un recurso, de modo que pueda reutilizar ese pincel como un recurso en toda la aplicación. La sintaxis XAML que se muestra para los tipos Brush es adecuada para definir el pincel como un recurso. Al declarar un pincel como un recurso, también necesita un atributo x:Key que usará más adelante para hacer referencia a ese recurso desde otras definiciones de interfaz de usuario. Para obtener más información sobre los recursos XAML y cómo usar el atributo x:Key, consulta Referencias a recursos ResourceDictionary y XAML.

La ventaja de declarar pinceles como recursos es que reduce el número de objetos en tiempo de ejecución necesarios para construir una interfaz de usuario: el pincel se comparte ahora como un recurso común que proporciona valores para varias partes del gráfico de objetos.

Si examinas las definiciones de plantillas de control existentes para Windows Runtime controles XAML, verás que las plantillas usan recursos de pincel ampliamente. Muchos de estos recursos son recursos del sistema y usan la extensión de marcado {ThemeResource} para la referencia de recursos en lugar de la extensión de marcado {StaticResource}. Para obtener más información sobre cómo usar pinceles de recursos del sistema en su propio XAML de plantilla de control, consulta Recursos de temas XAML.

Clases derivadas de Brush

Brush es la clase primaria de varias clases derivadas que implementan pinceles prácticos que pintan regiones de la interfaz de usuario o son clases base intermedias para tales pinceles:

• GradientBrush: clase base intermedia para LinearGradientBrush.
• SolidColorBrush: esto es, con mucho, el pincel más usado.
• TileBrush: clase base intermedia para ImageBrush.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

Constructores

Brush()

Proporciona el comportamiento de inicialización de clases base para las clases derivadas de Brush.

Propiedades

Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
Opacity	Obtiene o establece el grado de opacidad de un pincel.
OpacityProperty	Identifica la propiedad de dependencia opacidad .
RelativeTransform	Obtiene o establece la transformación que se aplica al pincel mediante coordenadas relativas.
RelativeTransformProperty	Identifica la propiedad de dependencia RelativeTransform .
Transform	Obtiene o establece la transformación que se aplica al pincel.
TransformProperty	Identifica la propiedad de dependencia Transform .

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define una propiedad que se puede animar.
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Cuando se invalida en una clase derivada, define una propiedad que se puede animar.
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Consulte también

• DependencyObject
• SolidColorBrush
• Color
• Colors
• Usar pinceles
• Image e ImageBrush
• Referencias a ResourceDictionary y a los recursos XAML