Window.Icon Propriété

Définition

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; [System.Security.SecurityCritical] set; }
public System.Windows.Media.ImageSource Icon { get; set; }
[<set: System.Security.SecurityCritical>]
member this.Icon : System.Windows.Media.ImageSource with 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.

Attributs

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

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

  • Une icône d’assembly, qui est spécifiée à l’aide de la propriété dans le <ApplicationIcon> 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 paramètre Icon. 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’un paramètre n’est pas fourni 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 l’icône Microsoft Windows par défaut.

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 Icon nullsur .

Une icône unique peut être utilisée de différentes manières 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. Chacune d’elles affiche l’icône à l’aide d’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 Windows Explorer, 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ône 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 icône de 16 x 16 pixels avec 16 couleurs, tandis qu’une autre peut contenir 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ône, Window utilisez l’icône appropriée. Si un fichier d’icône contient uniquement un sous-ensemble de toutes les icônes possibles, Window utilise l’icône la plus appropriée suivante dans l’ordre de diminution des tailles et de la profondeur de couleur.

Le résultat est qu’une icône sera 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 entraîner 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 d’identificateur IconProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à