ImageIcon Classe
Définition
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.
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 : IconElementPublic Class ImageIcon
Inherits IconElement- Héritage
-
ImageIcon
- Attributs
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 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 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). |