Share via

ImageIcon Classe

  • Référence

Définition

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

Représente une icône qui utilise une image comme contenu.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

/// [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
Héritage
IconElement
ImageIcon
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

Conseil

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

Les applications WinUI 3 Gallery et WinUI 2 Gallery incluent des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 3 et WinUI 2.

Si elles sont déjà installées, ouvrez-les en cliquant sur les liens suivants : WinUI 3 Gallery ou WinUI 2 Gallery.

Si elles ne sont pas installées, vous pouvez télécharger WinUI 3 Gallery et WinUI 2 Gallery à partir du Microsoft Store.

Vous pouvez également obtenir le code source des deux applications à partir de GitHub (utilisez la branche main pour WinUI 3 et la branche winui2 pour WinUI 2).

L’exemple suivant montre un AppBarButton avec un ImageIcon. Source spécifie une image incluse dans le package d’application.

<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->

<AppBarButton Label="ImageIcon">
    <AppBarButton.Icon>
        <muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
    </AppBarButton.Icon>
</AppBarButton>

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

// using muxc = Microsoft.UI.Xaml.Controls;

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };

Remarques

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

L’image doit être solide sur un arrière-plan transparent.

Seule la première image d’une image à plusieurs images est utilisée. Pour utiliser des icônes animées, consultez AnimatedIcon.

En raison des types de fichiers pris en charge, ImageIcon ignore la propriété Foreground , vous ne pouvez donc pas modifier la couleur de premier plan comme vous le pouvez sur d’autres contrôles dérivés IconSource .

ImageIcon est généralement utilisé avec un AppBarButton, mais il peut être utilisé partout où un IconElement peut être utilisé.

Constructeurs

ImageIcon()

Initialise une nouvelle instance de la classe ImageIcon.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

Source

Obtient ou définit l’URI du fichier image à utiliser comme icône.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
SourceProperty

Identifie la propriété de dépendance Source.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

S’applique à

Voir aussi