Window.Icon Eigenschaft

Definition

Ruft das Symbol eines Fensters ab oder legt dieses fest.

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

Eigenschaftswert

ImageSource

Ein ImageSource-Objekt, das das Symbol darstellt.

Attribute

Beispiele

Das folgende Beispiel zeigt, wie Sie ein Fenstersymbol festlegen.

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

Hinweise

Windows Presentation Foundation (WPF) eigenständige Anwendungen verfügen über zwei Arten von Symbolen:

  • Ein Assemblysymbol, das mithilfe der Eigenschaft in der <ApplicationIcon> Projektbuilddatei der Anwendung angegeben wird. Dieses Symbol wird als Desktopsymbol für eine Assembly verwendet.

    Hinweis

    Beim Debuggen in Visual Studio wird ihr Symbol möglicherweise aufgrund des Hostingvorgangs nicht angezeigt. Wenn Sie die ausführbare Datei ausführen, wird das Symbol angezeigt. Weitere Informationen finden Sie unter Hostprozess („vshost.exe“).

  • Ein Symbol pro Fenster, das durch Einstellung Iconangegeben wird. Für jedes Fenster wird dieses Symbol in der Titelleiste, der Schaltfläche "Taskleiste" und in der Listenliste der ALT-TAB-Anwendung verwendet.

Ein WPF-Fenster zeigt immer ein Symbol an. Wenn eine Einstellung Iconnicht bereitgestellt wird, wählt WPF ein Symbol aus, das basierend auf den folgenden Regeln angezeigt werden soll:

  1. Verwenden Sie das Assemblysymbol, wenn angegeben.

  2. Wenn das Assemblysymbol nicht angegeben wird, verwenden Sie das Standardsymbol microsoft Windows.

Wenn Sie ein benutzerdefiniertes Fenstersymbol angeben, können Sie Icon das Standardanwendungssymbol durch Festlegen Icon auf nullwiederherstellen.

Ein einzelnes Symbol kann auf verschiedene Arten in Windows verwendet werden, einschließlich der Anzeige in der Titelleiste eines Fensters, der Taskleiste für ein Fenster, der ALT+TAB-Dateiauswahlliste. Jede dieser Elemente zeigt das Symbol mit einer anderen Größe; Ein 16x16-Pixelsymbol wird in der Titelleiste eines Fensters und in der Taskleiste angezeigt, während ein 32x32-Pixelsymbol in der LISTE der ALT+TAB-Dateiauswahl angezeigt wird. Einige Anwendungen, z. B. Microsoft Windows Explorer, bieten ein Menü "Ansicht", mit dem Sie die Größe des Symbols auswählen können, das Sie anzeigen möchten.

Um die verschiedenen Anzeigegrößen zu erfüllen, besteht eine Symboldatei aus einem oder mehreren tatsächlichen Symbolen, in denen jeder eine Version des Symbols darstellt, die auf eine bestimmte Größe und Farbtiefe ausgerichtet ist. Ein Symbol kann beispielsweise nur ein einzelnes 16x16-Pixelsymbol mit 16 Farben aufweisen, während ein anderes möglicherweise 16x16 Pixel und 32x32 Pixelsymbole mit 16 Farben und 256 Farben enthält.

Wenn Symbole für alle möglichen Größen und Farbtiefe in einer Symboldatei vorhanden sind, Window wird das entsprechende Symbol verwendet. Wenn eine Symboldatei nur eine Teilmenge aller möglichen Symbole enthält, wird das nächste am besten geeignete Symbol verwendet, Window um die Größe und Farbtiefe zu verringern.

Das Ergebnis ist, dass ein Symbol immer verwendet Windowwird, obwohl das verwendete Symbol möglicherweise nicht auf die erforderliche Größe und Farbtiefe ausgerichtet ist. Beispielsweise kann ein 16x16-Pixelsymbol mit 16 Farben zum Anzeigen als 32x32-Pixelsymbol mit 256 Farben verwendet werden. Dies kann unerwünschte visuelle Effekte verursachen, z. B. Pixilation, aber möglicherweise vermieden werden, indem Symbole für alle gezielten Größen und Farbtiefen erstellt werden.

Hinweis

Sie können diese Eigenschaft nicht festlegen oder abrufen, wenn ein Fenster in einem Browser gehostet wird.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld IconProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für: