ImageBrush Klasse

Definition

public ref class ImageBrush sealed : TileBrush

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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 ImageBrush final : TileBrush

/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ImageBrush final : TileBrush

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class ImageBrush : TileBrush

[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ImageBrush : TileBrush

Public NotInheritable Class ImageBrush
Inherits TileBrush

<ImageBrush .../>

Vererbung

Object Platform::Object IInspectable DependencyObject Brush TileBrush ImageBrush

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Beispiele

In diesem XAML-Beispiel wird gezeigt, wie die Vordergrundeigenschaft eines TextBlock auf einen ImageBrush festgelegt wird, dessen Bild als Füllung für den textBlock gerenderten Text verwendet wird.

<!-- TextBlock with an image brush applied to the text. -->
<TextBlock FontFamily="Verdana" FontSize="72"
 FontStyle="Italic" FontWeight="Bold">
    SHRUBBERY
  <TextBlock.Foreground>
    <ImageBrush ImageSource="forest.jpeg"/>
  </TextBlock.Foreground>
</TextBlock>

Hinweise

Ein ImageBrush ist ein Pinseltyp , der seinen Inhalt als Bild definiert, das optional gestreckt und ausgerichtet werden kann. Die Verwendung von ImageBrush umfasst dekorative Effekte für Text oder Bildhintergründe für Steuerelemente oder Layoutcontainer.

Es ist nützlich, in zwei Standard Szenarien ein ImageBrush anstelle eines Image-Steuerelements zu verwenden:

1. Sie möchten einen nicht rechteckigen Bereich wie eine Auslassungspunkte oder einen Rahmen mit einem Bild zeichnen.
2. Sie möchten einen einzelnen ImageBrush verwenden, um mehrere Bereiche oder UIElements mit demselben Bild zu zeichnen, was effizienter ist als die Verwendung mehrerer Image-Steuerelemente

Wenn Sie einen ImageBrush-Code definieren, verwenden Sie den Standardkonstruktor, und legen Sie dann ImageBrush.ImageSource fest. Dies erfordert ein BitmapImage (nicht einen URI (Uniform Resource Identifier)) im Code. Falls es sich bei deiner Quelle um einen Datenstrom handelt, initialisiere den Wert mit der SetSourceAsync-Methode. Wenn Ihre Quelle ein Uniform Resource Identifier (URI) ist, der Inhalte in Ihrer App enthält, die die Schemas ms-appx oder ms-resource verwenden, verwenden Sie den BitmapImage-Konstruktor , der einen Uniform Resource Identifier (URI) akzeptiert. Für den Fall, dass beim Abrufen oder Decodieren der Bildquelle Probleme mit der Zeitsteuerung auftreten und du alternativen Inhalt anzeigen musst, bis die Bildquelle verfügbar ist, empfiehlt es sich unter Umständen auch, das ImageOpened-Ereignis zu behandeln. Beispielcode finden Sie im Beispiel für XAML-Bilder .

Die Stretch-Eigenschaft ist wichtig für die Anwendung des Bilds, wenn es als Pinsel verwendet wird. Einige Bilder sehen gut aus, wenn sie so gestreckt werden, wie sie mit dem Fill-Verhalten auf eine bestimmte Brush-Eigenschaft angewendet wird, während andere Bilder nicht gut gestreckt oder skaliert werden und möglicherweise den Wert None oder Uniform for Stretch erfordern. Experimentieren Sie mit verschiedenen Werten für Stretch , um zu ermitteln, welches Verhalten am besten aussieht, wenn es auf die Benutzeroberfläche angewendet wird.

Bildquellen und Skalierung

Sie sollten Ihre Bildquellen in mehreren empfohlenen Größen erstellen, um sicherzustellen, dass Ihre App beim Skalieren Windows 8 gut aussieht. Wenn Sie eine ImageSource für einen ImageBrush angeben, können Sie eine Benennungskonvention verwenden, die automatisch auf die richtige Ressource für die aktuelle Skalierung verweist. Einzelheiten zur Namenskonvention sowie weiterführende Informationen findest du unter Schnellstart: Verwenden von Datei- oder Bildressourcen.

Weitere Informationen zum Entwerfen für die Skalierung finden Sie unter UX-Richtlinien für Layout und Skalierung.

Hinweise zu früheren Versionen

Windows 8

Windows 8 ein Problem mit der ImageSource-Auflösung eines XAML-Attribut-URI-Werts aufgetreten, wenn imageBrush Teil einer XAML-Formatvorlage oder Vorlage ist, die auf ein Steuerelement angewendet wird. Die Steuerelementverwendung verwendet manchmal einen komponentenspezifischen Basis-URI und nicht den entsprechenden Basis-URI für den Stil oder die Vorlage, der normalerweise von der App stammt. Das Problem wurde ab Windows 8.1 behoben. Der Basis-URI wird je nach Dem Bereich, der den Basis-URI benötigt, ordnungsgemäß für App-Ressourcen oder Komponentenressourcen bestimmt. Apps, die für Windows 8 kompiliert wurden, haben möglicherweise Problemumgehungen für dieses Verhalten verwendet, indem sie ihre Bildquelldateien an der "falschen" Stelle platzieren, an der der XAML-URI aufgelöst und die App die Bilder anzeigt. Wenn Sie XAML von Windows 8 zu Windows 8.1 migrieren, sollten Sie alle ImageBrush-Verwendungen in einem Stil oder einer Vorlage aus Ihrem XAML-Code testen und überprüfen, ob die Bildauflösung in Ihrer App mit Windows 8.1 funktioniert. Wenn Sie ein Problem haben, sollten Sie Ihre Bildquelldateien innerhalb des Pakets verschieben, sodass sie sich im richtigen Ressourcenbereich für das neue Verhalten befinden.

Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• TileBrush
• Image
• Image und ImageBrush
• XAML-vektorbasiertes Zeichnungsbeispiel (siehe Szenario 2)