Verwenden von Pinseln zum Zeichnen von Vor- und Hintergründen sowie Rändern

Verwende Pinsel-Objekte, um das Innere und die Umrisse von XAML-Formen, -Text und -Steuerelementen zu zeichnen, sodass Sie in der Benutzeroberfläche der Anwendung sichtbar werden.

Wichtige APIs: Brush-Klasse

Einführung in Pinsel

Zum Malen von auf dem App-Canvas angezeigten Formen, Texten oder Steuerelementteilen legen Sie die Eigenschaft Füllen der Form oder die Eigenschaften Hintergrund und Vordergrund eines Steuerelements auf einen Pinsel-Wert fest.

Es gibt folgende Pinseltypen:

• AcrylicBrush
• SolidColorBrush
• LinearGradientBrush
• RadialGradientBrush
• ImageBrush
• WebViewBrush
• XamlCompositionBrushBase

Einfarbige Pinsel

Ein SolidColorBrush zeichnet einen Bereich mit einer einzelnen Color, z. B. Rot oder Blau. Dies ist der einfachste Pinsel. Es gibt in XAML drei Möglichkeiten, einen SolidColorBrush und die zugehörige Farbe zu definieren: vordefinierte Farbnamen, hexadezimale Farbwerte und die Syntax für Eigenschaftselemente.

Vordefinierte Farbnamen

Sie können einen vordefinierten Farbnamen wie Yellow oder Magenta verwenden. Es stehen 256 benannte Farben zur Verfügung. Der XAML-Parser wandelt den Farbnamen in eine Color-Struktur mit den richtigen Farbkanälen um. Die 256 benannten Farben basieren auf den X11-Farbnamen der CSS3-Spezifikation (Cascading Style Sheets, Level 3). Möglicherweise kennen Sie diese Liste benannter Farben also bereits, wenn Sie über Vorkenntnisse in Webentwicklung oder -design verfügen.

In diesem Beispiel wird die Fill-Eigenschaft eines Rectangle auf die vordefinierte Farbe Red festgelegt.

<Rectangle Width="100" Height="100" Fill="Red" />

Auf ein Rechteck angewendeter SolidColorBrush

Wenn Sie einen SolidColorBrush mit Code anstatt mit XAML definieren, sind die einzelnen benannten Farben als statische Eigenschaftswerte der Colors-Klasse verfügbar. Wenn Sie z. B. einen Color-Wert eines SolidColorBrush zum Darstellen der benannten Farbe „Orchid“ deklarieren möchten, legen Sie den Color-Wert auf den statischen Wert Colors.Orchid fest.

Hexadezimale Farbwerte

Sie können eine Zeichenfolge im Hexadezimalformat verwenden, um präzise 24-Bit-Farbwerte mit 8-Bit-Alphakanal für einen SolidColorBrush zu deklarieren. Zwei Zeichen im Bereich 0 bis F definieren die einzelnen Komponentenwerte. Die Reihenfolge der Komponentenwerte für die Hexadezimalzeichenfolge lautet wie folgt: Alphakanal (Deckkraft), roter Kanal, grüner Kanal und blauer Kanal (ARGB). Der Hexadezimalwert "#FFFF0000" definiert beispielsweise vollständig undurchsichtig rot (alpha="FF", red="FF", green="00" und blue="00").

In diesem XAML-Beispiel wird die Fill-Eigenschaft eines Rechtecks auf den hexadezimalen Wert "#FFFF0000" festgelegt, und es wird ein identisches Ergebnis für die Verwendung der benannten Farbe Colors.Red zurückgegeben.

<StackPanel>
  <Rectangle Width="100" Height="100" Fill="#FFFF0000" />
</StackPanel>

Eigenschaftenelementsyntax

Mithilfe der Syntax für Eigenschaftselemente können Sie einen SolidColorBrush definieren. Diese Syntax ist ausführlicher als die zuvor gezeigten Methoden, und Sie können zusätzliche Eigenschaftswerte für ein Element angeben, wie z. B. die Opacity des Pinsels. Weitere Informationen zur XAML-Syntax, einschließlich der Syntax für Eigenschaftselemente, finden Sie in der XAML-Übersicht und der Anleitung zur XAML-Syntax.

In den voranstehenden Beispielen wird der erstellte Pinsel implizit und automatisch erstellt und ist Teil einer durchdachten Kurzschrift der XAML-Sprache, mit der die UI-Definitionen für die am häufigsten Anwendungsfälle unkompliziert gehalten werden. Im nächsten Beispiel werden ein Rectangle und dann explizit der SolidColorBrush als Elementwert für eine Rectangle.Fill-Eigenschaft erstellt. Die Color von SolidColorBrush wird auf Blue und die Opacity auf 0,5 festgelegt.

<Rectangle Width="200" Height="150">
    <Rectangle.Fill>
        <SolidColorBrush Color="Blue" Opacity="0.5" />
    </Rectangle.Fill>
</Rectangle>

Lineare Farbverlaufspinsel

Ein LinearGradientBrush zeichnet einen Bereich mit einem Farbverlauf entlang einer Linie. Diese Linie wird als Farbverlaufsachse bezeichnet. Sie geben die Farben für den Farbverlauf und ihre Position an der Farbverlaufsachse mithilfe von GradientStop-Objekten an. Standardmäßig verläuft die Farbverlaufsachse von der oberen linken Ecke zur unteren rechten Ecke des Bereichs, den der Pinsel zeichnet. Dies führt zu einer diagonalen Schattierung.

Der GradientStop bildet die Grundlage für einen Farbverlaufspinsel. Ein Farbverlaufsstopp gibt die Color des Pinsels an einem Offset entlang der Farbverlaufsachse an, wenn der Pinsel auf den zu zeichnenden Bereich angewendet wird.

Die Color-Eigenschaft des Farbverlaufsstopps gibt die Farbe am Farbverlaufsstopp an. Sie können diese Farbe mit einem vordefinierten Farbnamen oder mit hexadezimalen ARGB-Werten angeben.

Die Offset-Eigenschaft eines GradientStop gibt die Position für jeden GradientStop entlang der Farbverlaufsachse an. Der Offset ist ein double-Wert zwischen 0 und 1. Mit einem Offset von 0 wird der GradientStop am Anfang der Farbverlaufsachse platziert, also in der Nähe des StartPoint. Ein Offset von 1 platziert den GradientStop am EndPoint. Ein sinnvoller LinearGradientBrush sollte mindestens über zwei GradientStop-Werte verfügen. Dabei sollte jeder GradientStop eine andere Color und einen anderen Offset zwischen 0 und 1 aufweisen.

Dieses Beispiel erstellt einen linearen Farbverlauf mit vier Farben, der zum Zeichnen eines Rectangle verwendet wird.

<!-- This rectangle is painted with a diagonal linear gradient. -->
<Rectangle Width="200" Height="100">
    <Rectangle.Fill>
        <LinearGradientBrush StartPoint="0,0" EndPoint="1,1">
            <GradientStop Color="Yellow" Offset="0.0" x:Name="GradientStop1"/>
            <GradientStop Color="Red" Offset="0.25" x:Name="GradientStop2"/>
            <GradientStop Color="Blue" Offset="0.75" x:Name="GradientStop3"/>
            <GradientStop Color="LimeGreen" Offset="1.0" x:Name="GradientStop4"/>
        </LinearGradientBrush>
    </Rectangle.Fill>
</Rectangle>

Die Farbe der einzelnen Punkte zwischen den Farbverlaufsstopps wird linear als eine Kombination der von den beiden umgebenden Farbverlaufsstopps angegebenen Farben interpoliert. In der folgenden Abbildung sind die Farbverlaufsstopps aus dem vorherigen Beispiel hervorgehoben. Die Kreise kennzeichnen die Position der Farbverlaufsstopps, und die gestrichelte Linie zeigt die Farbverlaufsachse.

Kombination der von den beiden umgebenden Farbverlaufsstopps angegebenen Farben

Sie können die Linie ändern, an der die Farbverlaufsstopps positioniert werden, indem Sie die StartPoint- und EndPoint-Eigenschaften auf unterschiedliche Werte festlegen als die Standardeinstellungen (1,1) für den (0,0) Farbverlauf. Durch Ändern der Koordinatenwerte für StartPoint und EndPoint können Sie horizontale oder vertikale Farbverläufe erstellen, die Richtung des Farbverlaufs umkehren oder die Farbverlaufsausdehnung verkleinern und so auf einen kleineren Bereich als den gesamten gezeichneten Bereich anwenden. Zum Verkleinern des Farbverlaufs legen Sie die Werte für StartPoint und/oder EndPoint auf einen Wert zwischen 0 und 1 fest. Angenommen, Sie möchten einen horizontalen Farbverlauf erstellen, bei dem der Farbverlauf nur in der linken Hälfte des Pinsels erfolgt und die rechte Hälfte nur die letzte GradientStop-Farbe hat. Hierfür geben Sie einen StartPoint von (0,0) und einen EndPoint von (0.5,0) an.

Verwenden von Tools zum Erstellen von Farbverläufen

Nachdem Sie nun wissen, wie lineare Farbverläufe funktionieren, können Sie Visual Studio oder Blend nutzen, um diese Farbverläufe einfacher erstellen zu können. Um einen Farbverlauf zu erstellen, wählen Sie in der Entwurfsoberfläche oder in der XAML-Ansicht das Objekt aus, auf das ein Farbverlauf angewendet werden soll. Erweitern Sie Pinsel, und wählen Sie die Registerkarte Linearer Farbverlauf aus.

Erstellen eines linearen Farbverlaufs in Visual Studio

Jetzt können Sie die Farben der Farbverlaufsstopps ändern und ihre Positionen unter Verwendung der Leiste am unteren Rand verschieben. Sie können auch neue Farbverlaufsstopps hinzufügen, indem Sie auf die Leiste klicken, und Farbverlaufsstopps entfernen, indem Sie sie von der Leiste herunter ziehen (siehe nächstes Bildschirmfoto).

Schieberegler für Farbverlauf

Radiale Farbverlaufspinsel

Ein RadialGradientBrush wird innerhalb einer Ellipse gezeichnet, die durch die Eigenschaften Center, RadiusX und RadiusY definiert wird. Farben für den Farbverlauf beginnen in der Mitte der Ellipse und enden am Radius.

Die Farben für den radialen Farbverlauf werden durch Farbstopps definiert, die der GradientStops-Sammlungseigenschaft hinzugefügt werden. Jeder Farbverlaufsstopp gibt eine Farbe und einen Versatz entlang des Farbverlaufs an.

Der Farbverlaufsursprung ist standardmäßig zentriert und kann mithilfe der GradientOrigin-Eigenschaft versetzt werden.

MappingMode definiert, ob Center, RadiusX, RadiusY und GradientOrigin relative oder absolute Koordinaten angeben.

Wenn MappingMode auf RelativeToBoundingBox festgelegt ist, werden die X- und Y-Werte der drei Eigenschaften als relativ zu den Elementgrenzen behandelt, wobei (0,0) die obere linke und (1,1) die untere rechte Ecke der Elementgrenzen für die Eigenschaften Center, RadiusX und RadiusY und (0,0) den Mittelpunkt für die Eigenschaft GradientOrigin angibt.

Wenn MappingMode auf Absolute festgelegt ist, werden die X- und Y-Werte der drei Eigenschaften als absolute Koordinaten innerhalb der Elementgrenzen behandelt.

Dieses Beispiel erstellt einen linearen Farbverlauf mit vier Farben, der zum Zeichnen eines Rectangle verwendet wird.

<!-- This rectangle is painted with a radial gradient. -->
<Rectangle Width="200" Height="200">
    <Rectangle.Fill>
        <media:RadialGradientBrush>
            <GradientStop Color="Blue" Offset="0.0" />
            <GradientStop Color="Yellow" Offset="0.2" />
            <GradientStop Color="LimeGreen" Offset="0.4" />
            <GradientStop Color="LightBlue" Offset="0.6" />
            <GradientStop Color="Blue" Offset="0.8" />
            <GradientStop Color="LightGray" Offset="1" />
        </media:RadialGradientBrush>
    </Rectangle.Fill>
</Rectangle>

Die Farbe der einzelnen Punkte zwischen den Farbverlaufsstopps wird radial als eine Kombination der von den beiden umgebenden Farbverlaufsstopps angegebenen Farben interpoliert. In der folgenden Abbildung sind die Farbverlaufsstopps aus dem vorherigen Beispiel hervorgehoben.

Farbverlaufstopps

Bildpinsel

Mit einem ImageBrush wird in einem Bereich ein Bild gezeichnet. Dabei stammt das zu zeichnende Bild aus einer Bilddateiquelle. Legen Sie die ImageSource-Eigenschaft auf den Pfad des Bilds fest, das Sie laden möchten. Normalerweise stammt die Bildquelle aus einem Content-Element, das Teil der App-Ressourcen ist.

Ein ImageBrush streckt das Bild standardmäßig so weit, dass es den gezeichneten Bereich ausfüllt. Dadurch wird möglicherweise das Bild verzerrt, wenn der gezeichnete Bereich ein anderes Seitenverhältnis als das Bild aufweist. Sie können dieses Verhalten ändern, indem Sie die Stretch-Eigenschaft vom Standardwert Fill in None, Uniform oder UniformToFill ändern.

Im nächsten Beispiel wird ein ImageBrush erstellt und ImageSource auf das Bild „licorice.jpg“ festgelegt, das Sie als Ressource in die App aufnehmen müssen. Der ImageBrush zeichnet dann den von einer Ellipse-Form definierten Bereich.

<Ellipse Height="200" Width="300">
   <Ellipse.Fill>
     <ImageBrush ImageSource="licorice.jpg" />
   </Ellipse.Fill>
</Ellipse>

Ein gerenderter ImageBrush

ImageBrush und Image verweisen beide mit einem URI (Uniform Resource Identifier) auf eine Bildquelldatei. Die Bildquelldatei liegt dabei in verschiedenen Formaten vor. Diese Bildquelldateien werden als URIs angegeben. Weitere Informationen zum Angeben von Bildquellen, zu den verwendbaren Bildformaten und zum Packen dieser Dateien in einer App finden Sie unter „Image“ und „ImageBrush“.

Pinsel und Text

Sie können mit Pinseln auch Renderingmerkmale auf Textelemente anwenden. Die Foreground-Eigenschaft von TextBlock akzeptiert z. B. einen Brush. Sie können alle hier beschriebenen Pinsel auf Text anwenden. Gehen Sie jedoch beim Anwenden von Pinseln auf Text mit Bedacht vor, da der Text möglicherweise nicht lesbar ist, wenn Sie Pinsel verwenden, die in den Hintergrund auslaufen. Verwenden Sie den SolidColorBrush, der i. d. R. keine negativen Auswirkungen auf die Lesbarkeit hat. Es sei denn, Sie möchten das Textelement besonders dekorativ gestalten.

Achten Sie auch bei Volltonfarben immer darauf, dass die ausgewählte Textfarbe einen ausreichenden Kontrast zur Hintergrundfarbe des Layoutcontainers für den Text aufweist. Die Stärke des Kontrasts zwischen Textvordergrund und Textcontainer sollte im Hinblick auf die Barrierefreiheit festgelegt werden.

WebViewBrush

Bei einem WebViewBrush handelt es sich um einen besonderen Pinseltyp, mit dem auf die Inhalte zugegriffen werden kann, die normalerweise in einem WebView-Steuerelement angezeigt werden. Anstatt den Inhalt im rechteckigen WebView-Steuerelementbereich zu rendern, zeichnet WebViewBrush diesen Inhalt in ein anderes Element mit einer Brush-Typeigenschaft für eine Renderingoberfläche. WebViewBrush ist nicht für jedes Pinselszenario geeignet, kann aber für Übergänge einer WebView hilfreich sein. Weitere Informationen finden Sie unter WebViewBrush.

XamlCompositionBrushBase

XamlCompositionBrushBase ist eine Basisklasse zum Erstellen benutzerdefinierter Pinsel, die CompositionBrush verwenden, um XAML-UI Elemente zu zeichnen.

Dies ermöglicht die „Dropdown”-Interoperabilität zwischen den Ebenen „Windows.UI.Xaml“ und „Windows.UI.Composition“, wie in der Übersicht über die visuelle Ebene beschrieben.

Zum Erstellen eines benutzerdefinierten Pinsels erstellen Sie eine neue Klasse, die von „XamlCompositionBrushBase“ erbt und die erforderlichen Methoden implementiert.

Dies kann beispielsweise zum Anwenden von Effekten auf XAML-UI-Elemente verwendet werden, wobei ein CompositionEffectBrush verwendet wird, z. B. ein GaussianBlurEffect oder ein SceneLightingEffect, der die reflektierenden Eigenschaften eines XAML-UI-Elements steuert, wenn es durch ein XamlLight beleuchtet wird.

Codebeispiele finden Sie unter XamlCompositionBrushBase.

Pinsel als XAML-Ressourcen

Sie können jeden Pinsel als XAML-Ressource mit Schlüssel in einem XAML-Ressourcenwörterbuch deklarieren. So können die gleichen Pinselwerte bequem dupliziert und auf eine Vielzahl von Elementen auf einer Benutzeroberfläche angewendet werden. Die Pinselwerte werden dann freigegeben und in allen Fällen angewendet, in denen Sie auf die Pinselressource mit einer {StaticResource}-Verwendung im XAML verweisen. Hierzu gehören auch Fälle, in denen mit einer XAML-Steuerelementvorlage auf den freigegebenen Pinsel verwiesen wird und es sich bei der Steuerelementvorlage selbst um eine XAML-Ressource mit Schlüssel handelt.

Pinsel in Code

Pinsel werden in der Regel mit XAML und nicht mit Code angegeben. Das liegt daran, dass Pinsel normalerweise als XAML-Ressourcen definiert und Pinselwerte häufig von Entwicklungstools ausgegeben werden oder Teil einer XAML-Benutzeroberflächendefinition sind. Für die Gelegenheiten, bei denen Sie einen Pinsel mithilfe von Code definieren möchten, stehen weiterhin alle Pinsel-Typen für die Codeinstanziierung zur Verfügung.

Verwenden Sie zum Erstellen eines SolidColorBrush-Elements in Code den Konstruktor, der einen Color-Parameter akzeptiert. Übergeben Sie einen Wert, bei dem es sich um eine statische Eigenschaft der Colors-Klasse handelt:

SolidColorBrush blueBrush = new SolidColorBrush(Windows.UI.Colors.Blue);

Dim blueBrush as SolidColorBrush = New SolidColorBrush(Windows.UI.Colors.Blue)

Windows::UI::Xaml::Media::SolidColorBrush blueBrush{ Windows::UI::Colors::Blue() };

blueBrush = ref new SolidColorBrush(Windows::UI::Colors::Blue);

Verwenden Sie für WebViewBrush und ImageBrush den Standardkonstruktor, und rufen Sie dann andere APIs auf, bevor Sie diesen Pinsel für eine UI-Eigenschaft verwenden.

• Für ImageSource ist ein BitmapImage (kein URI) erforderlich, wenn Sie einen ImageBrush mithilfe von Code definieren. Falls es sich bei Ihrer Quelle um einen Datenstrom handelt, initialisieren Sie den Wert mit der SetSourceAsync-Methode. Ist Ihre Quelle ein URI (wozu auch App-Inhalte gehören, die das Schema ms-appx oder ms-resource verwenden), verwenden Sie den BitmapImage-Konstruktor, der einen URI akzeptiert. Für den Fall, dass beim Abrufen oder Decodieren der Bildquelle Probleme mit der Zeitsteuerung auftreten und Sie den alternativen Inhalt anzeigen müssen, bis die Bildquelle verfügbar ist, empfiehlt es sich unter Umständen auch, das ImageOpened-Ereignis zu behandeln.
• Für WebViewBrush müssen Sie möglicherweise Redraw aufrufen, wenn Sie kürzlich die SourceName-Eigenschaft zurückgesetzt haben oder der Inhalt von WebView ebenfalls mittels Code geändert wird.

Codebeispiele finden Sie unter WebViewBrush, ImageBrush und XamlCompositionBrushBase.