Window.Icon Właściwość

Definicja

Pobiera lub ustawia ikonę okna.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); };
public System.Windows.Media.ImageSource Icon { get; set; }
[set: System.Security.SecurityCritical]
public System.Windows.Media.ImageSource Icon { get; set; }
member this.Icon : System.Windows.Media.ImageSource with get, set
[<set: System.Security.SecurityCritical>]
member this.Icon : System.Windows.Media.ImageSource with get, set
Public Property Icon As ImageSource

Wartość właściwości

ImageSource

ImageSourceObiekt, który reprezentuje ikonę.An ImageSource object that represents the icon.

Atrybuty

Przykłady

Poniższy przykład pokazuje, jak ustawić ikonę okna.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)

Uwagi

Aplikacje autonomiczne Windows Presentation Foundation (WPF) mają dwa typy ikon:Windows Presentation Foundation (WPF) standalone applications have two types of icons:

  • Ikona jednego zestawu, która jest określona przy użyciu <ApplicationIcon> właściwości w pliku kompilacji projektu aplikacji.One assembly icon, which is specified by using the <ApplicationIcon> property in the application's project build file. Ta ikona jest używana jako ikona pulpitu dla zestawu.This icon is used as the desktop icon for an assembly.

    Uwaga

    Podczas debugowania w programie Visual Studio ikona może nie być wyświetlana ze względu na proces hostingu.When debugging in Visual Studio, your icon may not appear due to the hosting process. Jeśli uruchomisz plik wykonywalny, zostanie wyświetlona ikona.If you run the executable, the icon will appear. Aby uzyskać więcej informacji, zobacz proces hostingu (vshost.exe).For more information, see Hosting Process (vshost.exe).

  • Jedna ikona na okno, która jest określona przez ustawienie Icon .One icon per window that is specified by setting Icon. Dla każdego okna ta ikona jest używana na pasku tytułu, na pasku zadań i na pozycji listy wyboru aplikacji ALT-TAB.For each window, this icon is used in its title bar, its task bar button, and in its ALT-TAB application selection list entry.

Okno WPF zawsze wyświetla ikonę.A WPF window always displays an icon. Gdy wartość nie jest określona przez ustawienie Icon , WPF wybiera ikonę, która zostanie wyświetlona na podstawie następujących reguł:When one is not provided by setting Icon, WPF chooses an icon to display based on the following rules:

  1. Użyj ikony zestawu, jeśli została określona.Use the assembly icon, if specified.

  2. Jeśli ikona zestawu nie jest określona, Użyj domyślnej ikony systemu Microsoft Windows.If the assembly icon is not specified, use the default Microsoft Windows icon.

Jeśli używasz Icon , aby określić niestandardową ikonę okna, możesz przywrócić domyślną ikonę aplikacji przez ustawienie Icon do null .If you use Icon to specify a custom window icon, you can restore the default application icon by setting Icon to null.

Pojedynczą ikonę można użyć na różne sposoby w systemie Windows, w tym na pasku tytułu okna, pasek zadań dla okna, na liście wyboru pliku 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. Każda z tych pokazuje ikonę przy użyciu innego rozmiaru; ikona 16x16 pikseli jest wyświetlana na pasku tytułu okna i na pasku zadań, a na liście wyboru pliku na karcie ALT + TAB zostanie wyświetlona ikona piksela 32x32.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. Niektóre aplikacje, takie jak Eksplorator Microsoft WindowsMicrosoft Windows Explorer , udostępniają menu Widok umożliwiające wybranie rozmiaru ikony, którą chcesz wyświetlić.Some applications, like Eksplorator Microsoft WindowsMicrosoft Windows Explorer, provide a View menu that allows you to choose the size of the icon you'd like to view.

Aby dowiedzieć się o różnych rozmiarach wyświetlania, plik ikony składa się z co najmniej jednej ikony rzeczywistej, w której każda z nich reprezentuje wersję ikony, która jest przeznaczona dla określonego rozmiaru i głębokości koloru.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. Na przykład jedna ikona może mieć tylko jedną ikonę 16x16 pikseli z 16 kolorami, a inna może zawierać ikony pikseli 16x16 pikseli i 32x32 z 16 kolorami i 256 kolorami.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.

Jeśli ikony dla wszystkich możliwych rozmiarów i głębi kolorów istnieją w pliku ikony, program Window użyje odpowiedniej ikony.If icons for all possible sizes and color depths exist within an icon file, Window will use the appropriate icon. Jeśli plik ikony zawiera tylko podzestaw wszystkich możliwych ikon, program Window używa następnej najbardziej odpowiedniej ikony w kolejności zmniejszania rozmiaru i głębi kolorów.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.

Wynikiem tego jest to, że ikona będzie zawsze używana przez Window program, chociaż użyta ikona może nie wskazywać wymaganego rozmiaru i głębokości koloru.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. Na przykład ikona 16x16 pikseli z 16 kolorami może być używana do wyświetlania jako ikony pikseli 32x32 z 256 kolory.For example, a 16x16 pixel icon with 16 colors may be used for display as a 32x32 pixel icon with 256 colors. Może to spowodować niepożądane efekty wizualne, takie jak pixilation, ale można je uniknąć przez utworzenie ikon dla wszystkich rozmiarów i głębi kolorów.This can cause undesirable visual effects, such as pixilation, but may be avoided by creating icons for all targeted sizes and color depths.

Uwaga

Nie można ustawić lub pobrać tej właściwości, gdy okno jest hostowane w przeglądarce.You cannot set or get this property when a window is hosted in a browser.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field IconProperty
Właściwości metadanych ustawione na trueMetadata properties set to true BrakNone

Dotyczy