Window.Icon Eigenschaft

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

SecurityCriticalAttribute

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

Eigenständige Windows Presentation Foundation (WPF)-Anwendungen weisen zwei Arten von Symbolen auf:

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

  Note

  Beim Debuggen in Visual Studio wird Ihr Symbol möglicherweise aufgrund des Hostingprozesses nicht angezeigt. Wenn Sie die ausführbare Datei ausführen, wird das Symbol angezeigt.

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

In einem WPF-Fenster wird immer ein Symbol angezeigt. Wenn eine einstellung nicht bereitgestellt Iconwird, 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 Standardmäßige Microsoft Windows-Symbol.

Wenn Sie Icon ein benutzerdefiniertes Fenstersymbol angeben, können Sie das Standardanwendungssymbol wiederherstellen, indem Sie auf null festlegenIcon.

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. Jedes dieser Symbole 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 in der Dateiauswahlliste ALT+TAB ein 32 x 32-Pixelsymbol 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, wobei jeder eine Version des Symbols darstellt, die auf eine bestimmte Größe und Farbtiefe ausgerichtet ist. Ein Symbol kann beispielsweise nur ein einzelnes Symbol mit 16 x 16 Pixeln mit 16 Farben enthalten, während ein anderes 16 x 16 Pixel und 32 x 32 Pixel Symbole mit 16 Farben und 256 Farben enthalten kann.

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 Größen und Farbtiefe zu verringern.

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 Symbol mit 16 x 16 Pixeln mit 16 Farben für die Anzeige als Symbol mit 32 x 32 Pixeln mit 256 Farben verwendet werden. Dies kann unerwünschte visuelle Effekte verursachen, z. B. Pixilation, kann jedoch vermieden werden, indem Symbole für alle zielbezogenen Größen und Farbtiefen erstellt werden.

Informationen zur Abhängigkeitseigenschaft