Window.Icon Vlastnost

Reference

Definice

Obor názvů:: System.Windows

Sestavení:: PresentationFramework.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Hodnota vlastnosti

ImageSource

Objekt ImageSource , který představuje ikonu.

Atributy: SecurityCriticalAttribute

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

Poznámka

Při ladění v Visual Studio se vaše ikona nemusí zobrazit kvůli procesu hostování. Pokud spustíte spustitelný soubor, zobrazí se ikona. Další informace naleznete v tématu Proces hostování (vshost.exe).
Jedna ikona na okno, které je určeno nastavením Icon. U každého okna se tato ikona používá v záhlaví, na tlačítku hlavního panelu a v položce seznamu výběru aplikace ALT-TAB.

Okno WPF vždy zobrazuje ikonu. Pokud ho nastavení nezadáte Icon, WPF zvolí ikonu, která se zobrazí na základě následujících pravidel:

Pokud je zadána, použijte ikonu sestavení.
Pokud není zadána ikona sestavení, použijte výchozí ikonu 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 použít různými způsoby v Windows, včetně zobrazení v záhlaví okna, hlavního panelu okna, seznamu výběru souborů 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 v seznamu výběru souborů ALT+TAB se zobrazí ikona 32 × 32 pixelů. 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 konkrétní velikost a barevnou hloubku. 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× 322 pixelů s 16 barvami a 256 barvami.

Pokud v souboru ikon existují ikony pro všechny možné velikosti a barevné hloubky, Window použije se příslušná ikona. 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, i když 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 32 × 32 pixelů s 256 barvami. To může způsobit nežádoucí vizuální efekty, jako je pixilace, ale může se jim vyhnout vytvořením ikon pro všechny cílové velikosti a barevné hloubky.

Poznámka

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

Informace o vlastnosti závislosti


Pole identifikátoru	IconProperty
Vlastnosti metadat nastavené na `true`	Žádné

Platí pro

Share via