Window.Icon Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows

Zestaw:: PresentationFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Użyj ikony zestawu, jeśli zostanie określona.
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

Dotyczy