Exportar (0) Imprimir
Expandir todo

Brush (Clase)

Actualización: noviembre 2007

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

Espacio de nombres:  System.Windows.Media
Ensamblado:  PresentationCore (en PresentationCore.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/xaml/presentation

[TypeConverterAttribute(typeof(BrushConverter))]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public abstract class Brush : Animatable, 
	IFormattable
/** @attribute TypeConverterAttribute(BrushConverter) */
/** @attribute LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable) */
public abstract class Brush extends Animatable implements IFormattable
public abstract class Brush extends Animatable implements IFormattable
Para obtener información sobre XAML, vea la sección Comentarios.

Un objeto Brush "pinta" o "rellena" un área con sus resultados. Los distintos pinceles tienen tipos de resultados diferentes. Algunos pinceles pintan un área con un color sólido, otros con un degradado, una trama, una imagen o un dibujo. La lista siguiente describe los distintos tipos de pinceles de WPF:

Pinceles predefinidos

Utilice la clase Brushes para pintar un objeto mediante un color sólido predefinido, como AliceBlue o Red.

Pinceles en XAML

La tabla siguiente muestra los distintos tipos de objetos Brush que se pueden usar en XAML y la sintaxis que admiten. Para obtener más información sobre la sintaxis de un pincel concreto, vea la página de tipos del pincel.

Clase

Sintaxis de atributo

Sintaxis de elementos de objeto

SolidColorBrush

DrawingBrush

No

ImageBrush

No

LinearGradientBrush

No

RadialGradientBrush

No

VisualBrush

No

Para obtener un ejemplo que muestre cómo pintar rápidamente un área con un color sólido, vea Cómo: Pintar un área con un color sólido.

Características de objetos Freezable

Un pincel es un tipo de objeto Freezable. Para obtener información sobre las características de los objetos Freezable, como la inmovilización y la clonación, vea Información general sobre objetos Freezable.

Notas para los herederos:

Al heredar de la clase Brush, es necesario reemplazar el método CreateInstanceCore. En función de si la clase debe realizar trabajo de inicialización adicional o contiene miembros de datos de propiedades que no son de dependencia, quizá deba invalidar los métodos Freezable adicionales. Para obtener más información sobre cómo heredar de tipos Freezable, vea Información general sobre objetos Freezable.

Para pintar una área con un color sólido, puede utilizar un pincel predefinido del sistema, como Red o Blueo puede crear un nuevo SolidColorBrush y describir su propiedad Color mediante sus valores de alfa, rojo, verde y azul. En XAML, puede pintar también una área con un color sólido utilizando la notación hexadecimal.

En los ejemplos siguientes se utilizan cada una de estas técnicas para pintar un objeto Rectangle de azul.

Utilizar un pincel predefinido

En el ejemplo siguiente se utiliza la propiedad Blue del pincel predefinido para pintar un rectángulo de azul.

<Rectangle Width="50" Height="50" Fill="Blue" />


// Create a rectangle and paint it with
// a predefined brush.
Rectangle myPredefinedBrushRectangle = new Rectangle();
myPredefinedBrushRectangle.Width = 50;
myPredefinedBrushRectangle.Height = 50;
myPredefinedBrushRectangle.Fill = Brushes.Blue;


Para obtener una lista de pinceles predefinidos, vea la clase Brushes.

xaml

Utilizar la notación hexadecimal

En el ejemplo siguiente se utiliza la notación hexadecimal de 8 dígitos para pintar un rectángulo de azul.

<!-- Note that the first two characters "FF" of the 8-digit
     value is the alpha which controls the transparency of 
     the color. Therefore, to make a completely transparent
     color (invisible), use "00" for those digits (e.g. #000000FF). -->
<Rectangle Width="50" Height="50" Fill="#FF0000FF" />


Utilizar los valores ARGB

En el ejemplo siguiente se crea un objeto SolidColorBrush y se describe su propiedad Color utilizando los valores ARGB para el color azul.

<Rectangle Width="50" Height="50">
  <Rectangle.Fill>
    <SolidColorBrush>
     <SolidColorBrush.Color>

        <!-- Describes the brush's color using
             RGB values. Each value has a range of 0-255.  
             R is for red, G is for green, and B is for blue.
             A is for alpha which controls transparency of the
             color. Therefore, to make a completely transparent
             color (invisible), use a value of 0 for Alpha. -->
        <Color A="255" R="0" G="0" B="255" />
     </SolidColorBrush.Color>
    </SolidColorBrush>
  </Rectangle.Fill>
</Rectangle>


Rectangle myRgbRectangle = new Rectangle();
myRgbRectangle.Width = 50;
myRgbRectangle.Height = 50;
SolidColorBrush mySolidColorBrush = new SolidColorBrush();

// Describes the brush's color using RGB values. 
// Each value has a range of 0-255.
mySolidColorBrush.Color = Color.FromArgb(255, 0, 0, 255);
myRgbRectangle.Fill = mySolidColorBrush;           


Para obtener otras maneras de describir colores, vea la estructura Color.

Temas relacionados

Para obtener más información acerca de SolidColorBrush y más ejemplos, vea Información general sobre el dibujo con colores sólidos y degradados.

Este ejemplo de código forma parte de un ejemplo más extenso referente a la clase SolidColorBrush. Para obtener el ejemplo completo, vea Ejemplo Brushes.

Más código

Cómo: Hacer que un elemento UIElement sea transparente o semitransparenteEn este ejemplo se muestra cómo hacer que un elemento UIElement sea transparente o semitransparente. Para hacer que un elemento sea transparente o semitransparente, se establece su propiedad Opacity. Un valor de 0.0 hace que el elemento sea completamente transparente, mientras que un valor de 1.0 lo deja completamente opaco. Un valor de 0.5 aplica al elemento una opacidad del 50%, y así sucesivamente. La propiedad Opacity de un elemento se establece en 1.0 de manera predeterminada.
Cómo: Pintar un área con un degradado linealEn este ejemplo se muestra cómo utilizar la clase LinearGradientBrush para pintar una área con un degradado lineal. En el ejemplo siguiente, la propiedad Fill de Rectangle se pinta con un degradado lineal diagonal que efectúa una transición del amarillo al rojo, al azul y al verde esmeralda.
Cómo: Pintar un área con un degradado radialEn este ejemplo se muestra cómo utilizar la clase RadialGradientBrush para pintar una área con un degradado radial.
Cómo: Pintar un área con una imagenEn este ejemplo se muestra cómo utilizar la clase ImageBrush para pintar una área con una imagen. Un ImageBrush muestra una imagen única, que se especifica mediante su propiedad ImageSource.
Cómo: Pintar un área con un pincel del sistemaLa clase SystemColors proporciona acceso a los pinceles y colores del sistema, tales como ControlBrush, ControlBrushKey y DesktopBrush. Un pincel del sistema es un objeto SolidColorBrush que pinta una área con el color del sistema especificado. Un pincel del sistema siempre genera un relleno sólido; no se puede utilizar para crear un degradado.
Cómo: Pintar un área con un objeto Visual En este ejemplo se muestra cómo utilizar la clase VisualBrush para pintar una área con un objeto Visual.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft