ImageIcon Klasse
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.
Stellt ein Symbol dar, das ein Bild als Inhalt verwendet.
Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageIcon : IconElement[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ImageIcon : IconElementPublic Class ImageIcon
Inherits IconElement- Vererbung
-
ImageIcon
- Attribute
Beispiele
Tipp
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Symbole für Windows-Apps.
Die WinUI 3-Katalog- und WinUI 2-Katalog-Apps umfassen interaktive Beispiele für die meisten WinUI 3- und WinUI 2-Steuerelemente, -Features und -Funktionen.
Wenn sie bereits installiert sind, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3-Katalog oder WinUI 2-Katalog.
Wenn sie nicht installiert sind, können Sie den WinUI 3-Katalog und den WinUI 2-Katalog aus dem Microsoft Store herunterladen.
Sie können auch den Quellcode für beide von GitHub abrufen (verwenden Sie denmain-Branch für WinUI 3 und den Branchwinui2 für WinUI 2).
Das folgende Beispiel zeigt ein AppBarButton-Element mit einem ImageIcon.
Source gibt ein Bild an, das im App-Paket enthalten ist.
<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
<AppBarButton Label="ImageIcon">
<AppBarButton.Icon>
<muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
</AppBarButton.Icon>
</AppBarButton>
Hier zeigen wir, wie sie aus ImageIcon einem Bitmapdatenstrom laden.
// using muxc = Microsoft.UI.Xaml.Controls;
var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };
Hinweise
Unterstützte Bildtypen sind .bmp, .gif, .jpg, .png, .wdp und .tiff.
Das Bild sollte auf einem transparenten Hintergrund einfarbig sein.
Es wird nur der erste Frame eines Multiframebilds verwendet. Informationen zur Verwendung animierter Symbole finden Sie unter AnimatedIcon.
Aufgrund der unterstützten ImageIcon Dateitypen ignoriert die Foreground-Eigenschaft , sodass Sie die Vordergrundfarbe nicht wie bei anderen von IconSource abgeleiteten Steuerelementen ändern können.
ImageIcon wird in der Regel mit einem AppBarButton verwendet, kann aber überall dort verwendet werden, wo ein IconElement verwendet werden kann.
Konstruktoren
| ImageIcon() |
Initialisiert eine neue Instanz der Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
Eigenschaften
| Source |
Ruft den URI der Bilddatei ab, die als Symbol verwendet werden soll, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |
| SourceProperty |
Bezeichnet die Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces). |