Window.Icon Właściwość

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

Autonomiczne aplikacje programu Windows Presentation Foundation (WPF) mają dwa typy ikon:

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

  Note

  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 Hosting Process (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 systemu 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 systemie Windows, w tym wyświetlane na pasku tytułu okna, pasek zadań okna, lista wyboru pliku ALT+TAB. Każdy z tych elementów pokazuje ikonę przy użyciu innego rozmiaru; 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, w której każda z nich reprezentuje wersję ikony, która jest przeznaczona dla określonego rozmiaru i głębokości koloru. Na przykład jedna ikona może mieć tylko jedną ikonę 16x16 pikseli z 16 kolorami, a druga 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 rozmiarów 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ć skierowana do 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.

Informacje o właściwości zależności