Questa documentazione è stata archiviata e non viene gestita.

Classe Brushes

Aggiornamento: novembre 2007

Implementa un insieme di oggetti SolidColorBrush predefiniti.

Spazio dei nomi:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS per XAML: http://schemas.microsoft.com/winfx/xaml/presentation

public sealed class Brushes
public final class Brushes
public final class Brushes
Non è possibile dichiarare questa classe gestita nella sintassi XAML, ma è possibile utilizzare le relative proprietà statiche per assegnare valori in XAML.

I nomi dei colori in Windows Presentation Foundation (WPF) corrispondono a quelli disponibili in Microsoft .NET Framework, Windows Form e Microsoft Internet Explorer. Questi colori e i relativi nomi sono basati sui valori di colore UNIX X11.

Di seguito sono illustrati il colore di ogni pennello predefinito, il relativo nome e il relativo valore esadecimale.

Tabella dei colori contenente un campione di colore, il nome del colore e il valore esadecimale

Colori predefiniti

Per altre modalità di disegno di un'area più complesse, vedere la classe Brush. Ad esempio, provare a utilizzare sfumature (LinearGradientBrush, RadialGradientBrush) o immagini (ImageBrush).

Per disegnare un'area con un colore a tinta unita è possibile utilizzare un pennello di sistema predefinito, ad esempio Red o Blue, oppure è possibile creare un nuovo oggetto SolidColorBrush e descrivere la relativa proprietà Color utilizzando valori alfa, rossi, verdi e blu. In XAML, è inoltre possibile disegnare un'area con un colore a tinta unita utilizzando la notazione esadecimale.

Negli esempi riportati di seguito viene utilizzata ognuna di queste tecniche per disegnare un oggetto Rectangle blu.

Utilizzo di un pennello predefinito

Nell'esempio riportato di seguito viene utilizzato il pennello predefinito Blue per disegnare un rettangolo blu.

<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;


Per un elenco dei pennelli predefiniti, vedere la classe Brushes.

xaml

Utilizzo della notazione esadecimale

Nell’esempio successivo viene utilizzata la notazione esadecimale a 8 cifre per disegnare un rettangolo blu.

<!-- 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" />


Utilizzo dei valori ARGB

Nell’esempio successivo viene creato un oggetto SolidColorBrush e viene descritta la relativa proprietà Color utilizzando i valori ARGB per il colore blu.

<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;           


Per altre modalità di descrizione del colore, vedere la struttura Color.

Argomenti correlati

Per ulteriori informazioni su SolidColorBrush e per esempi aggiuntivi, vedere i Cenni preliminari su Cenni sul disegno con colori a tinta unita e sfumature.

Questo esempio di codice fa parte di un esempio più esaustivo fornito per la classe SolidColorBrush. Per l'esempio completo, vedere Esempio Brush.

System.Object
  System.Windows.Media.Brushes

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0
Mostra: