Window.Icon Tulajdonság

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállítja az ablak ikonját.

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

Tulajdonság értéke

ImageSource

Az ImageSource ikont jelképező objektum.

Példák

Az alábbi példa bemutatja, hogyan állíthat be ablakikont.

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

Megjegyzések

Windows megjelenítési alaprendszer (WPF) különálló alkalmazások két ikontípussal rendelkeznek:

• Egy szerelvényikon, amely az <ApplicationIcon> alkalmazás projekt buildfájljában található tulajdonság használatával van megadva. Ez az ikon egy szerelvény asztali ikonjaként használatos.

  Note

  Ha hibakeresést Visual Studio, előfordulhat, hogy az ikon nem jelenik meg az üzemeltetési folyamat miatt. Ha futtatja a végrehajtható fájlt, megjelenik az ikon. További információ: Üzemeltetési folyamat (vshost.exe).

• Ablakonként egy ikon, amely a beállítással Iconvan megadva. Minden egyes ablakban ezt az ikont használja a címsor, a tálcája gombja és ALT-TAB alkalmazáskijelölési lista bejegyzése.

A WPF ablakban mindig megjelenik egy ikon. Ha a Icon beállítással nincs megadva, WPF a következő szabályok alapján megjelenítendő ikont választ:

1. Ha meg van adva, használja a szerelvény ikont.

2. Ha a szerelvényikon nincs megadva, használja az alapértelmezett Microsoft Windows ikont.

Ha egyéni ablakikont ad Icon meg, a beállítással Icon visszaállíthatja az alapértelmezett alkalmazásikont null.

A Windows különböző módokon használható egyetlen ikon, például az ablak címsorában, az ablak tálcájában, az ALT+TAB fájlkijelölési listában. Ezek mindegyike eltérő méretben jeleníti meg az ikont; egy 16x16 képpontos ikon jelenik meg egy ablak címsorában és a tálcán, míg egy 32x32 képpontos ikon jelenik meg az ALT+TAB fájlkijelölési listában. Egyes alkalmazások, például Microsoft Windows Explorer, View menüt biztosítanak, amellyel kiválaszthatja a megtekinteni kívánt ikon méretét.

A különböző megjelenítési méretek kielégítése érdekében egy ikonfájl egy vagy több tényleges ikonból áll, amelyek mindegyike az ikon egy adott méretre és színmélységre vonatkozó verzióját jelöli. Az egyik ikon például csak egyetlen 16x16 képpontos ikonnal rendelkezhet 16 színnel, míg egy másik 16x16 képpontos és 32x32 képpontos ikont is tartalmazhat 16 és 256 színnel.

Ha az ikonfájlban minden lehetséges mérethez és színmélységhez ikonok tartoznak, Window a megfelelő ikont fogja használni. Ha egy ikonfájl csak az összes lehetséges ikon egy részhalmazát tartalmazza, Window a következő legmegfelelőbb ikont használja a méret és a színmélység csökkentése érdekében.

Ennek az az eredménye, hogy a rendszer mindig egy ikont Windowhasznál, bár a használt ikon nem feltétlenül a kívánt méretre és színmélységre irányul. Például egy 16x16 képpontos ikon 16 színnel 32x32 képpontos ikonként, 256 színnel jeleníthető meg. Ez nemkívánatos vizuális hatásokat, például pixilációt okozhat, de elkerülhető, ha ikonokat hoz létre az összes célzott mérethez és színmélységhez.

Note

Ezt a tulajdonságot nem lehet beállítani vagy lekérni, ha egy ablakot böngészőben üzemeltetnek.

Függőségi tulajdonság adatai

Azonosító mező	IconProperty
Metaadat-tulajdonságok beállítása: true	None