Window.Icon Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví ikonu 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; set; }

member this.Icon : System.Windows.Media.ImageSource with get, set

Public Property Icon As ImageSource

Hodnota vlastnosti

ImageSource

Objekt ImageSource , který představuje ikonu.

Příklady

Následující příklad ukazuje, jak nastavit ikonu 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)

Poznámky

Samostatné aplikace Windows Presentation Foundation (WPF) mají dva typy ikon:

• Jedna ikona sestavení, která je určena pomocí <ApplicationIcon> vlastnosti v souboru sestavení projektu aplikace. Tato ikona se používá jako ikona plochy pro sestavení.

  Note

  Při ladění v sadě Visual Studio se vaše ikona nemusí zobrazit kvůli procesu hostování. Pokud spustíte spustitelný soubor, zobrazí se ikona.

• Jedna ikona na okno, které je určeno nastavením Icon. Pro každé okno se tato ikona používá v záhlaví, na tlačítku hlavního panelu a v ALT-TAB položce seznamu výběru aplikace.

V okně WPF se vždy zobrazí ikona. Pokud ho nastavení Iconnezadá, WPF zvolí ikonu, která se zobrazí na základě následujících pravidel:

1. Pokud je zadána, použijte ikonu sestavení.
2. Pokud není zadána ikona sestavení, použijte výchozí ikonu systému Microsoft Windows.

Pokud používáte Icon k zadání vlastní ikony okna, můžete výchozí ikonu aplikace obnovit nastavením Icon na null.

Jednu ikonu lze ve Windows použít různými způsoby, včetně zobrazení v záhlaví okna, hlavního panelu okna, seznamu výběru souboru ALT+TAB. Každá z těchto možností zobrazuje ikonu s jinou velikostí; Ikona 16 × 16 pixelů se zobrazí v záhlaví okna a na hlavním panelu, zatímco ikona 32 × 32 pixelů se zobrazí v seznamu výběru souboru ALT+TAB. Některé aplikace, jako je Microsoft Windows Explorer, poskytují nabídku Zobrazení , která umožňuje zvolit velikost ikony, kterou chcete zobrazit.

Pro zajištění různých velikostí zobrazení se soubor ikony skládá z jedné nebo více skutečných ikon, kde každá z nich představuje verzi ikony, která cílí na určitou velikost a hloubku barev. Jedna ikona může mít například jedinou ikonu 16 × 16 pixelů s 16 barvami, zatímco jiná může obsahovat 16 × 16 pixelů a 32 × 32 pixelů ikony s 16 barvami i 256 barvami.

Pokud v souboru ikon existují ikony pro všechny možné velikosti a hloubky barev, Window použijte příslušnou ikonu. Pokud soubor ikony obsahuje pouze podmnožinu všech možných ikon, Window použije další nejvhodnější ikonu v pořadí zmenšení velikosti a hloubky barev.

Výsledkem je, že ikona bude vždy používána Window, ačkoli použitá ikona nemusí cílit na požadovanou velikost a barevnou hloubku. Například ikona 16× 16 pixelů s 16 barvami se může použít pro zobrazení jako ikona 32x32 pixelů s 256 barvami. To může způsobit nežádoucí vizuální efekty, jako je pixilace, ale může se vyhnout vytvořením ikon pro všechny cílové velikosti a barevné hloubky.

Note

Tuto vlastnost nelze nastavit nebo získat, pokud je okno hostované v prohlížeči.

Informace o vlastnosti závislosti

Pole Identifikátor	IconProperty
Vlastnosti metadat nastavené na true	None