ImageIcon Klasse

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

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 : IconElement
Public Class ImageIcon
Inherits IconElement
Vererbung
IconElement
ImageIcon
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 ImageIcon-Klasse.

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 Source-Abhängigkeitseigenschaft.

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Gilt für:

Weitere Informationen