Window.Icon Egenskap

Definition

Hämtar eller anger ett fönsters ikon.

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

Egenskapsvärde

Ett ImageSource objekt som representerar ikonen.

Attribut

Exempel

I följande exempel visas hur du anger en fönsterikon.

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

Kommentarer

Windows Presentation Foundation (WPF) fristående program har två typer av ikoner:

  • En sammansättningsikon som anges med hjälp <ApplicationIcon> av egenskapen i programmets projektversionsfil. Den här ikonen används som skrivbordsikon för en sammansättning.

    Note

    När du felsöker i Visual Studio kanske ikonen inte visas på grund av värdprocessen. Om du kör den körbara filen visas ikonen. Mer information finns i Värdprocess (vshost.exe).

  • En ikon per fönster som anges genom att ange Icon. För varje fönster används den här ikonen i dess namnlist, dess aktivitetsfältknapp och i dess ALT-TAB post i listan över programval.

Ett WPF fönster visar alltid en ikon. När du inte anger Icon väljer WPF en ikon som ska visas baserat på följande regler:

  1. Använd sammansättningsikonen om det anges.

  2. Om sammansättningsikonen inte har angetts använder du standardikonen Microsoft Windows.

Om du använder Icon för att ange en anpassad fönsterikon kan du återställa standardprogramikonen genom att ange Icon till null.

En enda ikon kan användas på flera olika sätt i Windows, inklusive att visas i namnlisten i ett fönster, aktivitetsfältet för ett fönster, alt+TAB-filvalslistan. Var och en av dessa visar ikonen med en annan storlek. En ikon på 16 x 16 bildpunkter visas i namnlisten i ett fönster och i aktivitetsfältet, medan en 32 x 32 bildpunktsikon visas i listan med val av ALT+TAB-fil. Vissa program, till exempel Microsoft Windows Explorer, tillhandahåller en View-meny som gör att du kan välja storleken på ikonen som du vill visa.

För att tillgodose de olika visningsstorlekarna består en ikonfil av en eller flera faktiska ikoner där var och en representerar en version av ikonen som riktar sig mot en viss storlek och färgdjup. En ikon kanske till exempel bara har en ikon på 16 x 16 bildpunkter med 16 färger, medan en annan kan innehålla ikoner på 16 x 16 bildpunkter och 32 x 32 bildpunkter med både 16 färger och 256 färger.

Om det finns ikoner för alla möjliga storlekar och färgdjup i en ikonfil Window använder du lämplig ikon. Om en ikonfil endast innehåller en delmängd av alla möjliga ikoner Window använder du nästa lämpligaste ikon i ordning för att minska storlek och färgdjup.

Resultatet är att en ikon alltid används av Window, även om ikonen som används kanske inte riktar sig mot den storlek och det färgdjup som krävs. Till exempel kan en ikon på 16 x 16 bildpunkter med 16 färger användas för visning som en 32 x 32 bildpunktsikon med 256 färger. Detta kan orsaka oönskade visuella effekter, till exempel pixilation, men kan undvikas genom att skapa ikoner för alla målstorlekar och färgdjup.

Note

Du kan inte ange eller hämta den här egenskapen när ett fönster finns i en webbläsare.

Information om beroendeegenskap

Identifierarfält IconProperty
Metadataegenskaper inställda på true Ingen

Gäller för