Window.Icon Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia ikonę okna.

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

Wartość właściwości

ImageSource

ImageSource Obiekt reprezentujący ikonę.

Atrybuty

SecurityCriticalAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić ikonę okna.

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

• Jedna ikona zestawu, która jest określana przy użyciu <ApplicationIcon> właściwości w pliku kompilacji projektu aplikacji. Ta ikona jest używana jako ikona pulpitu dla zestawu.

  Uwaga

  Podczas debugowania w Visual Studio ikona może nie być widoczna z powodu procesu hostingu. Jeśli uruchomisz plik wykonywalny, zostanie wyświetlona ikona. Aby uzyskać więcej informacji, zobacz Proces hostingu (vshost.exe).

• Jedna ikona na okno określone przez ustawienie Icon. Dla każdego okna ta ikona jest używana na pasku tytułu, przycisku paska zadań i wpisie listy wyboru aplikacji ALT-TAB.

W oknie WPF zawsze jest wyświetlana ikona. Jeśli jeden nie jest dostarczany przez ustawienie Icon, WPF wybiera ikonę do wyświetlenia na podstawie następujących reguł:

1. Użyj ikony zestawu, jeśli zostanie określona.

2. Jeśli nie określono ikony zestawu, użyj domyślnej ikony microsoft Windows.

Jeśli używasz Icon polecenia , aby określić niestandardową ikonę okna, możesz przywrócić domyślną ikonę aplikacji, ustawiając wartość Icon null.

Pojedyncza ikona może być używana na różne sposoby w Windows, w tym pokazywane na pasku tytułu okna, na pasku zadań okna, na liście wyboru pliku ALT+TAB. Każda z tych opcji pokazuje ikonę o innym rozmiarze; Ikona 16x16 pikseli jest wyświetlana na pasku tytułu okna i na pasku zadań, a ikona 32x32 pikseli jest wyświetlana na liście wyboru pliku ALT+TAB. Niektóre aplikacje, takie jak Microsoft Windows Explorer, udostępniają menu Widok, które umożliwia wybranie rozmiaru ikony, którą chcesz wyświetlić.

Aby zaspokoić różne rozmiary wyświetlania, plik ikony składa się z co najmniej jednej rzeczywistej ikony, gdzie każda z nich reprezentuje wersję ikony, która jest przeznaczona dla określonego rozmiaru i głębokości kolorów. Na przykład jedna ikona może mieć tylko jedną ikonę 16 x 16 pikseli z 16 kolorami, podczas gdy inna może zawierać ikony 16x16 pikseli i 32x32 pikseli z 16 kolorami i 256 kolorami.

Jeśli ikony dla wszystkich możliwych rozmiarów i głębokości kolorów istnieją w pliku ikony, Window użyje odpowiedniej ikony. Jeśli plik ikony zawiera tylko podzbiór wszystkich możliwych ikon, Window użyj następnej najbardziej odpowiedniej ikony w celu zmniejszenia rozmiaru i głębokości kolorów.

Wynikiem jest to, że ikona będzie zawsze używana przez Windowelement , chociaż użyta ikona może nie być docelowa wymaganego rozmiaru i głębokości koloru. Na przykład ikona 16x16 pikseli z 16 kolorami może być używana do wyświetlania jako ikona 32x32 pikseli z 256 kolorami. Może to spowodować niepożądane efekty wizualne, takie jak pixilation, ale można uniknąć, tworząc ikony dla wszystkich docelowych rozmiarów i głębokości kolorów.

Uwaga

Nie można ustawić ani pobrać tej właściwości, gdy okno jest hostowane w przeglądarce.

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

Pole identyfikatora	IconProperty
Właściwości metadanych ustawione na true	Brak