Window.Icon Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Obtient ou définit une icône de fenêtre.

public:
 property System::Windows::Media::ImageSource ^ Icon { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };

public System.Windows.Media.ImageSource Icon { get; set; }

member this.Icon : System.Windows.Media.ImageSource with get, set

Public Property Icon As ImageSource

Valeur de propriété

ImageSource

Objet ImageSource qui représente l'icône.

Exemples

L’exemple suivant montre comment définir une icône de fenêtre.

<Window
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.MainWindow"
    Icon="WPFIcon1.ico">
</Window>

// Set an icon using code
Uri iconUri = new Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute);
this.Icon = BitmapFrame.Create(iconUri);

' Set an icon using code
Dim iconUri As New Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute)
Me.Icon = BitmapFrame.Create(iconUri)

Remarques

Windows Presentation Foundation applications autonomes (WPF) ont deux types d’icônes :

• Une icône d’assembly, qui est spécifiée à l’aide de la <ApplicationIcon> propriété dans le fichier de build de projet de l’application. Cette icône est utilisée comme icône de bureau pour un assembly.

  Notes

  Lors du débogage dans Visual Studio, votre icône peut ne pas apparaître en raison du processus d’hébergement. Si vous exécutez l’exécutable, l’icône s’affiche. Pour plus d’informations, consultez Processus d’hébergement (vshost.exe).

• Une icône par fenêtre spécifiée par la définition Iconde . Pour chaque fenêtre, cette icône est utilisée dans sa barre de titre, son bouton de barre des tâches et dans son entrée de liste de sélection d’application ALT-TAB.

Une fenêtre WPF affiche toujours une icône. Lorsqu’il n’en est pas fourni par le paramètre Icon, WPF choisit une icône à afficher en fonction des règles suivantes :

1. Utilisez l’icône d’assembly, si elle est spécifiée.

2. Si l’icône d’assembly n’est pas spécifiée, utilisez la valeur par défaut Microsoft icône Windows.

Si vous utilisez Icon pour spécifier une icône de fenêtre personnalisée, vous pouvez restaurer l’icône d’application par défaut en définissant sur Iconnull.

Une icône unique peut être utilisée de différentes façons dans Windows, notamment dans la barre de titre d’une fenêtre, la barre des tâches d’une fenêtre, la liste de sélection de fichiers ALT+TAB. Chacun d’entre eux affiche l’icône avec une taille différente ; Une icône de 16 x 16 pixels s’affiche dans la barre de titre d’une fenêtre et dans la barre des tâches, tandis qu’une icône de 32 x 32 pixels s’affiche dans la liste de sélection de fichiers ALT+TAB. Certaines applications, comme Microsoft’Explorateur Windows, fournissent un menu Affichage qui vous permet de choisir la taille de l’icône que vous souhaitez afficher.

Pour répondre aux différentes tailles d’affichage, un fichier d’icônes est composé d’une ou plusieurs icônes réelles où chacune représente une version de l’icône qui cible une taille et une profondeur de couleur spécifiques. Par exemple, une icône ne peut avoir qu’une seule icône de 16 x 16 pixels avec 16 couleurs, tandis qu’une autre peut contenir des icônes de 16 x 16 pixels et 32 x 32 pixels avec 16 couleurs et 256 couleurs.

Si des icônes pour toutes les tailles et profondeurs de couleurs possibles existent dans un fichier d’icônes, Window utilise l’icône appropriée. Si un fichier d’icônes contient uniquement un sous-ensemble de toutes les icônes possibles, Window utilise l’icône la plus appropriée suivante par ordre décroissant de taille et de profondeur de couleur.

Le résultat est qu’une icône est toujours utilisée par Window, bien que l’icône utilisée ne cible pas la taille et la profondeur de couleur requises. Par exemple, une icône de 16 x 16 pixels avec 16 couleurs peut être utilisée pour l’affichage en tant qu’icône de 32 x 32 pixels avec 256 couleurs. Cela peut provoquer des effets visuels indésirables, tels que la pixilation, mais peut être évité en créant des icônes pour toutes les tailles ciblées et les profondeurs de couleurs.

Notes

Vous ne pouvez pas définir ou obtenir cette propriété lorsqu’une fenêtre est hébergée dans un navigateur.

Informations sur les propriétés de dépendance

Champ Identificateur	IconProperty
Propriétés de métadonnées définies sur true	Aucun