Freigeben über


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

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 eigenständige Anwendungen (WPF) verfügen über zwei Arten von Symbolen:

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

    Hinweis

    Beim Debuggen in Visual Studio wird Ihr Symbol aufgrund des Hostingprozesses möglicherweise 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 Festlegen Iconvon angegeben wird. Für jedes Fenster wird dieses Symbol in der Titelleiste, in der Taskleistenschaltfläche und in der Auswahlliste der ALT-TAB-Anwendung verwendet.

Ein WPF-Fenster zeigt immer ein Symbol an. Wenn sie nicht durch Festlegen Iconbereitgestellt wird, wählt WPF ein Symbol aus, das basierend auf den folgenden Regeln angezeigt werden soll:

  1. Verwenden Sie das Assemblysymbol, falls angegeben.

  2. Wenn das Assemblysymbol nicht angegeben ist, verwenden Sie das Standardsymbol Microsoft Windows.

Wenn Sie zum Angeben eines benutzerdefinierten Fenstersymbols verwendenIcon, können Sie das Standardanwendungssymbol wiederherstellen, indem Sie auf nullfestlegenIcon.

Ein einzelnes Symbol kann in Windows auf verschiedene Arten verwendet werden, einschließlich der Darstellung in der Titelleiste eines Fensters, der Taskleiste für ein Fenster, der Auswahlliste der ALT+TAB-Datei. Jede dieser Elemente zeigt das Symbol mit einer anderen Größe an. Ein Symbol mit 16 x 16 Pixeln wird in der Titelleiste eines Fensters und in der Taskleiste angezeigt, während ein Symbol mit 32 x 32 Pixeln in der Auswahlliste der ALT+TAB-Datei angezeigt wird. Einige Anwendungen, z. B. Microsoft Windows-Explorer, bieten ein Menü Ansicht, mit dem Sie die Größe des anzuzeigenden Symbols auswählen können.

Um die verschiedenen Anzeigegrößen zu erfüllen, besteht eine Symboldatei aus einem oder mehreren tatsächlichen Symbolen, wobei jedes eine Version des Symbols darstellt, die auf eine bestimmte Größe und Farbtiefe abzielt. Beispielsweise kann ein Symbol nur ein einzelnes 16 x 16 Pixel-Symbol mit 16 Farben enthalten, während ein anderes Symbol 16 x 16 Pixel und 32 x 32 Pixel mit jeweils 16 Farben und 256 Farben enthalten kann.

Wenn Symbole für alle möglichen Größen und Farbtiefen in einer Symboldatei vorhanden sind, Window wird das entsprechende Symbol verwendet. Wenn eine Symboldatei nur eine Teilmenge aller möglichen Symbole enthält, Window wird das nächst geeignete Symbol in der Reihenfolge der abnehmenden Größen und Farbtiefe verwendet.

Das Ergebnis ist, dass ein Symbol immer von Windowverwendet wird, obwohl das verwendete Symbol möglicherweise nicht auf die erforderliche Größe und Farbtiefe ausgerichtet ist. Beispielsweise kann ein 16x16-Pixelsymbol mit 16 Farben für die Anzeige als 32x32-Pixelsymbol mit 256 Farben verwendet werden. Dies kann unerwünschte visuelle Effekte, z. B. Pixilation, verursachen, kann jedoch vermieden werden, indem Symbole für alle Zielgröß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: