ImageIconSource Klasse

Definition

Namespace:: Microsoft.UI.Xaml.Controls

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.

Bearbeiten

Stellt eine Symbolquelle dar, die einen Bildtyp als Inhalt verwendet.

/// [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 ImageIconSource : IconSource

[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 ImageIconSource : IconSource

Public Class ImageIconSource
Inherits IconSource

Vererbung: Object IInspectable DependencyObject IconSource ImageIconSource

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Important

ImageIconSource ist auf die Verwendung mit der IconSource Eigenschaft bestimmter Steuerelemente beschränkt. Weitere Informationen finden Sie in den Hinweisen.

Tip

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Icons für Windows Apps.

Öffnen Sie die WinUI 3 Gallery-App, und sehen Sie iconElement in Aktion.

Die WinUI 3 Gallery-App enthält interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Holen Sie sich die App aus dem Microsoft Store oder holen Sie sich den Quellcode auf GitHub.

Das folgende Beispiel zeigt eine Infoleiste mit einer ImageIconSource. ImageSource gibt ein Bild an, das im App-Paket enthalten ist.

<InfoBar Title="InfoBar Title"
         Message="This is an InfoBar message." 
         IsOpen="True">
    <InfoBar.IconSource>
        <ImageIconSource ImageSource="ms-appx:///Assets/StoreLogo.png"/>
    </InfoBar.IconSource>
</InfoBar>

Hier zeigen wir, wie Sie eine ImageIconSource aus einem Bitmapstream laden.

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new ImageIconSource() { ImageSource = bitmapSource };

Hinweise

ImageIconSource ist auf die Verwendung mit der IconSource Eigenschaft dieser Steuerelemente beschränkt:

Andere Verwendung von ImageIconSource führt nicht zu einem Fehler, aber das Bild wird nicht angezeigt. Bei dieser Verwendung von ImageIconSource mit IconSourceElement wird das Bild beispielsweise nicht angezeigt.

<!-- INCORRECT CODE - DO NOT USE -->
<AppBarButton >
    <AppBarButton.Icon>
        <IconSourceElement>
            <ImageIconSource ImageSource="ms-appx:///Assets/StoreLogo.png"/>
        </IconSourceElement>
    </AppBarButton.Icon>
</AppBarButton>
<!-- INCORRECT CODE - DO NOT USE -->

Die unterstützten Bildtypen sind .bmp, .gif, .jpg, .png, WDP und .tiff.

ImageIconSource ähnelt ImageIcon. Da es sich jedoch nicht um ein FrameworkElement handelt, kann es freigegeben werden.

Konstruktoren

Name	Beschreibung
ImageIconSource()	Initialisiert eine neue Instanz der `ImageIconSource`-Klasse.

Eigenschaften

Name	Beschreibung
Dispatcher	Gibt immer in einer Windows App SDK-App zurück `null` . Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft ab `DispatcherQueue` , dem dieses Objekt zugeordnet ist. Dies `DispatcherQueue` stellt eine Einrichtung dar, die auf den `DependencyObject` UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
Foreground	Dient zum Abrufen oder Festlegen eines Pinsels, der die Vordergrundfarbe des Steuerelements zeichnet. (Geerbt von IconSource)
ImageSource	Dient zum Abrufen oder Festlegen des URI der Bilddatei, die als Symbolquelle verwendet werden soll.
ImageSourceProperty	Identifies the `ImageSource` dependency property.

Methoden

Name	Beschreibung
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
CreateIconElement()	Erstellt ein Symbol-UI-Element. (Geerbt von IconSource)
CreateIconElementCore()	Erstellt ein Symbol-UI-Element. (Geerbt von IconSource)
GetAnimationBaseValue(DependencyProperty)	Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	Ordnet IconSource-Eigenschaften iconElementProperties zu. (Geerbt von IconSource)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?