ImageBrush.ImageSource Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Bildquelle, die von diesem ImageBrush angezeigt wird. Im Code, den Sie mit einer ImageSource-Unterklasseninstanz festlegen, legen Sie dies in XAML mit einem URI auf eine Bildquelldatei fest.
public:
property ImageSource ^ ImageSource { ImageSource ^ get(); void set(ImageSource ^ value); };ImageSource ImageSource();
void ImageSource(ImageSource value);public ImageSource ImageSource { get; set; }var imageSource = imageBrush.imageSource;
imageBrush.imageSource = imageSource;Public Property ImageSource As ImageSource<ImageBrush ImageSource="imageUri"/>
Eigenschaftswert
Ein Objekt, das die Bildquelle darstellt, die von diesem ImageBrush angezeigt werden soll, wenn es auf Inhalte angewendet wird.
Hinweise
Das Festlegen einer Bildquelle aus einer Bildquelldatei oder einem Datenstrom ist inhärent eine asynchrone Aktion. Wenn Sie die Quelle auf einen URI -Wert (Uniform Resource Identifier) festlegen, der nicht in eine gültige Bildquelldatei aufgelöst werden kann, wird kein Fehler ausgelöst. Stattdessen wird ein ImageFailed-Ereignis auf dem ImageBrush ausgelöst. Wenn Sie überprüfen möchten, ob eine Bildquelldatei ordnungsgemäß geladen wurde, können Sie ImageOpened zur Überprüfung behandeln, plus ImageFailed als Möglichkeit, eine Fallbackbildquelle bereitzustellen oder die Benutzeroberfläche neu zu kompilieren.
Festlegen von ImageSource in XAML
Sie können diese Eigenschaft in XAML festlegen, aber in diesem Fall legen Sie den ImageSource-Attributwert als Zeichenfolge fest, die einen Uniform Resource Identifier (URI) darstellt. Dieses Verhalten basiert auf der zugrunde liegenden Typkonvertierung, die die Zeichenfolge als Uniform Resource Identifier (URI) verarbeitet, und ruft das interne Äquivalent des BitmapImage(Uri) -Konstruktors auf.
Das ImageFailed-Ereignis kann auftreten, wenn der ursprüngliche ImageSource-Attributwert in XAML keine gültige Quelle angibt. Sie können einen relativen Pfad verwenden, um auf ein Bild zu verweisen, das Sie mit der App verpacken, oder einen absoluten Uniform Resource Identifier (URI), um auf ein Bild von einem Server zu verweisen. Wenn Sie eine Bildquelle verwenden, die als Teil Ihrer App verpackt ist, ist es üblich, entweder die Schemas "ms-appx " oder "ms-resource " zu verwenden.
Festlegen von ImageSource im Code
Wenn Sie einen ImageBrush mithilfe von Code definieren, erfordert ImageBrush.ImageSource ein BitmapImage (nicht einen Uniform Resource Identifier (URI)) im Code. Falls es sich bei deiner Quelle um einen Datenstrom handelt, initialisiere den Wert mit der SetSourceAsync-Methode. Wenn Ihre Quelle ein URI (Uniform Resource Identifier) ist, der auf eine Datei verweist, die Inhalte in Ihrer App enthält, die die Schemas "ms-appx " oder "ms-resource " verwenden, verwenden Sie den BitmapImage-Konstruktor , der einen URI (Uniform Resource Identifier) verwendet. 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. Beispiel für XAML-Bilder finden Sie unter Beispielcode.
Wenn Sie einen URI in Bezug auf ein anderes Objekt in der Benutzeroberfläche erstellen müssen, um den Bereich der Ressourcenanforderung zu unterstützen, können Sie manchmal die FrameworkElement.BaseUri-Eigenschaft verwenden, die für ein anderes Objekt in der Benutzeroberfläche aufgerufen wird. Dies stellt einen Basis-URI bereit, in dem die XAML-Seite innerhalb der Projektstruktur der App stammt.
Hinweis
Sie können die automatische Behandlung für den Zugriff auf nicht qualifizierte Ressourcen mit aktuellen Skalierungs- und Kulturqualifizierern verwenden, oder Sie können ResourceManager und ResourceMap mit Qualifizierern für Kultur und Skalierung verwenden, um die Ressourcen direkt abzurufen. Weitere Informationen finden Sie unter Ressourcenverwaltungssystem.
Bildquellen und Skalierung
Sie sollten Ihre Bildquellen mit mehreren empfohlenen Größen erstellen, um sicherzustellen, dass Ihre App gut aussieht, wenn Windows 8 sie skaliert. 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 Benennungskonvention und weitere Informationen finden Sie in der Schnellstartanleitung: Verwenden von Datei- oder Bildressourcen.
Weitere Informationen zum Entwerfen der Skalierung finden Sie in den UX-Richtlinien für Layout und Skalierung.
Weitere Informationen zu App-Ressourcen und zum Verpacken von Bildquellen in einer App finden Sie unter Definieren von App-Ressourcen.