Window.Icon Eigenschaft

Definition

Ruft das Symbol eines Fensters ab oder legt dieses fest.Gets or sets a window's icon.

public:
 property System::Windows::Media::ImageSource ^ Icon { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };
[set: System.Security.SecurityCritical]
public System.Windows.Media.ImageSource Icon { 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.An ImageSource object that represents the icon.

Attribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Fenster Symbol festgelegt wird.The following example shows how to set a window icon.

<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 WPF-Anwendungen (Windows Presentation Foundation) haben zwei Arten von Symbolen:Windows Presentation Foundation (WPF) standalone applications have two types of icons:

  • Ein Assemblysymbol, das mit der <ApplicationIcon>-Eigenschaft in der Projektbuilddatei der Anwendung angegeben wird.One assembly icon, which is specified by using the <ApplicationIcon> property in the application's project build file. Dieses Symbol wird als Desktop Symbol für eine Assembly verwendet.This icon is used as the desktop icon for an assembly.

    Hinweis

    Wenn Sie in Visual Studio debuggen, wird das Symbol möglicherweise aufgrund des Hostingprozesses nicht angezeigt.When debugging in Visual Studio, your icon may not appear due to the hosting process. Wenn Sie die ausführbare Datei ausführen, wird das Symbol angezeigt.If you run the executable, the icon will appear. Weitere Informationen finden Sie unter Hostprozess („vshost.exe“).For more information, see Hosting Process (vshost.exe).

  • Ein Symbol pro Fenster, das durch Festlegen von Iconangegeben wird.One icon per window that is specified by setting Icon. Für jedes Fenster wird dieses Symbol in der Titelleiste, der Task leisten Schaltfläche und in der Liste der Anwendungs Auswahl Einträge der alt-Registerkarte verwendet.For each window, this icon is used in its title bar, its task bar button, and in its ALT-TAB application selection list entry.

Ein WPF-Fenster zeigt immer ein Symbol an.A WPF window always displays an icon. Wenn eine nicht durch Festlegen von Iconbereitgestellt wird, wählt WPF ein Symbol aus, das auf der Grundlage der folgenden Regeln angezeigt wird:When one is not provided by setting Icon, WPF chooses an icon to display based on the following rules:

  1. Verwenden Sie das Assembly-Symbol, falls angegeben.Use the assembly icon, if specified.

  2. Wenn das Assemblysymbol nicht angegeben ist, verwenden Sie das Microsoft Windows-Standard Symbol.If the assembly icon is not specified, use the default Microsoft Windows icon.

Wenn Sie Icon verwenden, um ein benutzerdefiniertes Fenster Symbol anzugeben, können Sie das Standard Anwendungssymbol wiederherstellen, indem Sie Icon auf nullfestlegen.If you use Icon to specify a custom window icon, you can restore the default application icon by setting Icon to null.

Ein einzelnes Symbol kann auf verschiedene Weise in Windows verwendet werden, einschließlich der Anzeige in der Titelleiste eines Fensters, der Taskleiste für ein Fenster, der Dateiauswahl Liste Alt + Tab.A single icon can be used in a variety of ways in Windows, including being shown in the title bar of a window, the task bar for a window, the ALT+TAB file selection list. Jedes dieser Zeichen zeigt das Symbol mit einer anderen Größe an. ein 16x16-Pixel-Symbol wird in der Titelleiste eines Fensters und in der Taskleiste angezeigt, während in der Dateiauswahl Liste Alt + Tab ein Symbol für 32 x 32 Pixel angezeigt wird.Each of these shows the icon using a different size; a 16x16 pixel icon is displayed in the title bar of a window and in the task bar, while a 32x32 pixel icon is displayed in the ALT+TAB file selection list. Einige Anwendungen, wie z. b. Microsoft Windows ExplorerMicrosoft Windows Explorer, bieten ein Menü Ansicht , in dem Sie die Größe des Symbols auswählen können, das Sie anzeigen möchten.Some applications, like Microsoft Windows ExplorerMicrosoft Windows Explorer, provide a View menu that allows you to choose the size of the icon you'd like to view.

Um die verschiedenen Anzeige Größen zu berücksichtigen, besteht eine Symbol Datei aus einem oder mehreren echten Symbolen, wobei jede eine Version des Symbols darstellt, das eine bestimmte Größe und Farbtiefe als Ziel hat.To cater to the various display sizes, an icon file is composed of one or more actual icons where each one represents a version of the icon that targets a specific size and color depth. Ein Symbol kann z. b. nur ein einzelnes 16x16-Pixel-Symbol mit 16 Farben enthalten, während ein weiteres 16x16-Pixel-und 32 x 32 Pixel-Symbole mit 16 Farben und 256 Farben enthalten kann.For example, one icon may only have a single 16x16 pixel icon with 16 colors, while another may contain 16x16 pixel and 32x32 pixel icons with both 16 colors and 256 colors.

Wenn in einer Symbol Dateisymbole für alle möglichen Größen und Farb Tiefe vorhanden sind, wird Window das entsprechende Symbol verwenden.If icons for all possible sizes and color depths exist within an icon file, Window will use the appropriate icon. Wenn eine Symbol Datei nur eine Teilmenge aller möglichen Symbole enthält, verwendet Window das am besten geeignete Symbol in der Reihenfolge der abnehmenden Größen und der Farbtiefe.If an icon file contains only a subset of all the possible icons, Window uses the next most appropriate icon in order of decreasing sizes and color depth.

Das Ergebnis ist, dass ein Symbol immer von Windowverwendet wird, obwohl das verwendete Symbol möglicherweise nicht die erforderliche Größe und Farbtiefe als Ziel verwendet.The result is that an icon will always be used by Window, although the icon used may not target the required size and color depth. Beispielsweise kann ein 16x16-Pixel Symbol mit 16 Farben als 32 x 32 Pixel Symbol mit 256 Farben verwendet werden.For example, a 16x16 pixel icon with 16 colors may be used for display as a 32x32 pixel icon with 256 colors. Dies kann zu unerwünschten visuellen Effekten, wie z. b. der Entwicklung, führen, kann jedoch vermieden werden, indem Symbole für alle Zielgrößen und Farbtiefe erstellt werden.This can cause undesirable visual effects, such as pixilation, but may be avoided by creating icons for all targeted sizes and color depths.

Hinweis

Sie können diese Eigenschaft nicht festlegen oder erhalten, wenn ein Fenster in einem Browser gehostet wird.You cannot set or get this property when a window is hosted in a browser.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field IconProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Sicherheit

UIPermission
für die Berechtigung zum Festlegen des Symbols.for permission to set the icon. Zugehörige Enumeration: AllWindowsAssociated enumeration: AllWindows

Gilt für: