Sdílet prostřednictvím


Window.Icon Vlastnost

Definice

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

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:

  1. Pokud je zadána, použijte ikonu sestavení.

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