SettingsFlyout.IconSource Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft das Symbolbild ab, das im Header SettingsFlyout angezeigt wird, oder legt es fest.

public:
 property ImageSource ^ IconSource { ImageSource ^ get(); void set(ImageSource ^ value); };

ImageSource IconSource();

void IconSource(ImageSource value);

public ImageSource IconSource { get; set; }

var imageSource = settingsFlyout.iconSource;
settingsFlyout.iconSource = imageSource;

Public Property IconSource As ImageSource

<SettingsFlyout IconSource="uri"/>

Eigenschaftswert

ImageSource

Das Symbolbild, das im Headerbereich EinstellungenFlyout angezeigt wird, normalerweise rechts neben dem Titel. Der Standardwert ist NULL, sodass kein Bild angezeigt wird.

Hinweise

Hinweis

Obwohl der Standardwert der Eigenschaft NULL ist, legt die Flyoutelementvorlage für Microsoft Visual Studio-Einstellungen die IconSource auf das kleine Logo Ihrer App (IconSource="Assets/SmallLogo.png") fest.

Die IconSource-Eigenschaft wird in der Regel in XAML festgelegt, um die vorteile der integrierten Konvertierung aus Zeichenfolge zu nutzen.

Wenn Sie die IconSource-Eigenschaft im Code festlegen, können Sie ein BitmapImage-Objekt verwenden, das mit dem URI (Uniform Resource Identifier) erstellt wurde, der den Pfad zu einer gültigen Bildquelldatei beschreibt. Sie können auch eine BitmapSource mit einem Stream initialisieren, z. B. mit einem Stream aus einer Speicherdatei, aber dies ist nicht typisch für ein SettingsFlyout UI-Szenario.

Festlegen von IconSource in XAML

Wenn Sie die IconSource-Eigenschaft als Attribut in XAML festlegen, legen Sie die IconSource-Eigenschaft mithilfe eines URI (Uniform Resource Identifier) fest. Dieses Verhalten basiert auf der zugrunde liegenden Typkonvertierung, die die Zeichenfolge als URI (Uniform Resource Identifier) verarbeitet und die Entsprechung des BitmapImage(Uri)- Konstruktors aufruft. Der XAML-Parser interpretiert alle Zeichenfolgen, die einen relativen URI (Uniform Resource Identifier) darstellen, unter Verwendung des Basis-URI (Uniform Resource Identifier) der XAML-Seite, die analysiert wird. Wenn Sie beispielsweise den Wert "Images/myimage.png" in XAML angeben, wird diese Zeichenfolge als relatives Pfadsuffix interpretiert, das an den Basisspeicherort des Uniform Resource Identifier (URI) innerhalb des App-Pakets angefügt wird, in dem die XAML-Seite selbst vorhanden ist.

<SettingsFlyout Width="346" IconSource="Images/myimage.png" />

Eine Eigenschaftselementsyntax in XAML ist ebenfalls möglich, wobei ein BitmapImage-Objektelement mit gültiger Quelle als Eigenschaftswert angegeben wird.

Weitere Informationen

• Source