ImageIconSource Classe

Définition

Espace de noms:: Microsoft.UI.Xaml.Controls

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente une source d’icône qui utilise un type d’image comme contenu.

/// [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

Héritage: Object IInspectable DependencyObject IconSource ImageIconSource

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

Important

ImageIconSource est limité à utiliser avec la IconSource propriété de certains contrôles. Pour plus d’informations, consultez les remarques.

Tip

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Icons pour les applications Windows.

Ouvrez l’application galerie WinUI 3 et consultez IconElement en action

L’application WinUI 3 Gallery inclut des exemples interactifs de la plupart des contrôles, des caractéristiques et des fonctionnalités de WinUI 3. Obtenez l’application à partir du Microsoft Store ou obtenez le code source sur GitHub.

L’exemple suivant montre une barre d’informations avec une ImageIconSource. ImageSource spécifie une image incluse dans le package d’application.

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

Ici, nous montrons comment charger une ImageIconSource à partir d’un flux bitmap.

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

Remarques

ImageIconSource est limité à utiliser avec la IconSource propriété de ces contrôles :

Une autre utilisation d’ImageIconSource n’entraîne pas d’erreur, mais l’image ne s’affiche pas. Par exemple, cette utilisation d’ImageIconSource avec IconSourceElement n’affiche pas l’image.

<!-- 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 -->

Les types d’images pris en charge sont .bmp, .gif, .jpg, .png, .wdp et .tiff.

ImageIconSource est similaire à ImageIcon. Toutefois, étant donné qu’il n’est pas un FrameworkElement, il peut être partagé.

Constructeurs

Nom	Description
ImageIconSource()	Initialise une nouvelle instance de la classe `ImageIconSource`.

Propriétés

Nom	Description
Dispatcher	Retourne `null` toujours dans une application du Kit de développement logiciel (SDK) d’application Windows. Utilisez DispatcherQueue à la place. (Hérité de DependencyObject)
DispatcherQueue	Obtient le `DispatcherQueue` résultat auquel cet objet est associé. Représente `DispatcherQueue` une installation qui peut accéder au `DependencyObject` thread d’interface utilisateur même si le code est initié par un thread non-interface utilisateur. (Hérité de DependencyObject)
Foreground	Obtient ou définit un pinceau qui peint la couleur de premier plan du contrôle. (Hérité de IconSource)
ImageSource	Obtient ou définit l’URI du fichier image à utiliser comme source d’icône.
ImageSourceProperty	Identifie la `ImageSource` propriété de dépendance.

Méthodes

Nom	Description
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
CreateIconElement()	Crée un élément d’interface utilisateur d’icône. (Hérité de IconSource)
CreateIconElementCore()	Crée un élément d’interface utilisateur d’icône. (Hérité de IconSource)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetIconElementPropertyCore(DependencyProperty)	Mappe les propriétés IconSource à IconElementProperties. (Hérité de IconSource)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à une dependencyProperty spécifique sur cette instance DependencyObject . (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?