Window.Icon Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Recupera o imposta l'icona di una finestra.

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

Valore della proprietà

ImageSource

Oggetto ImageSource che rappresenta l'icona.

Esempio

Nell'esempio seguente viene illustrato come impostare un'icona di finestra.

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

Commenti

le applicazioni autonome Windows Presentation Foundation (WPF) hanno due tipi di icone:

• Un'icona dell'assembly, specificata usando la <ApplicationIcon> proprietà nel file di compilazione del progetto dell'applicazione. Questa icona viene usata come icona desktop per un assembly.

  Nota

  Quando si esegue il debug in Visual Studio, l'icona potrebbe non essere visualizzata a causa del processo di hosting. Se si esegue l'eseguibile, verrà visualizzata l'icona. Per altre informazioni, vedere Processo di hosting (vshost.exe).

• Un'icona per ogni finestra specificata impostando Icon. Per ogni finestra, questa icona viene usata nella barra del titolo, nel pulsante della barra delle applicazioni e nella voce dell'elenco di selezione dell'applicazione ALT-TAB.

Una finestra WPF visualizza sempre un'icona. Quando non viene fornito impostando Icon, WPF sceglie un'icona da visualizzare in base alle regole seguenti:

1. Usare l'icona dell'assembly, se specificata.

2. Se l'icona dell'assembly non è specificata, usare l'icona predefinita Microsoft Windows.

Se si usa Icon per specificare un'icona di finestra personalizzata, è possibile ripristinare l'icona dell'applicazione predefinita impostando Icon su null.

Un'unica icona può essere usata in diversi modi in Windows, tra cui la visualizzazione nella barra del titolo di una finestra, la barra delle attività per una finestra, l'elenco di selezione dei file ALT+TAB. Ognuno di questi mostra l'icona usando una dimensione diversa; viene visualizzata un'icona a 16x16 pixel nella barra del titolo di una finestra e nella barra delle applicazioni, mentre nell'elenco di selezione dei file ALT+TAB viene visualizzata un'icona a 32x32 pixel. Alcune applicazioni, ad esempio Microsoft Esplora risorse, forniscono un menu Visualizzazione che consente di scegliere le dimensioni dell'icona da visualizzare.

Per soddisfare le varie dimensioni di visualizzazione, un file di icona è costituito da una o più icone effettive in cui ognuna rappresenta una versione dell'icona che punta a una dimensione e profondità di colore specifica. Ad esempio, un'icona può avere solo un'icona a 16x16 pixel con 16 colori, mentre un altro può contenere 16x16 pixel e icone a 32x32 pixel con entrambi i colori 16 e 256 colori.

Se le icone per tutte le dimensioni e la profondità dei colori possibili esistono all'interno di un file di icona, Window useranno l'icona appropriata. Se un file di icona contiene solo un subset di tutte le icone possibili, Window usa l'icona più appropriata successiva in ordine di riduzione delle dimensioni e della profondità del colore.

Il risultato è che un'icona verrà sempre usata da Window, anche se l'icona usata potrebbe non puntare alla dimensione e alla profondità di colore richiesta. Ad esempio, un'icona a 16x16 pixel con 16 colori può essere usata per la visualizzazione come icona a 32x32 pixel con 256 colori. Ciò può causare effetti visivi indesiderati, ad esempio pixilation, ma può essere evitata creando icone per tutte le dimensioni di destinazione e profondità dei colori.

Nota

Non è possibile impostare o ottenere questa proprietà quando una finestra è ospitata in un browser.

Informazioni proprietà di dipendenza

Campo Identificatore	IconProperty
Proprietà dei metadati impostate su true	Nessuno