Window.Icon Propriedade

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

Valor de Propriedade

Um ImageSource objeto que representa o ícone.

Atributos

SecurityCriticalAttribute

Exemplos

O exemplo seguinte mostra como definir um ícone de janela.

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

Observações

As aplicações autónomas do Windows Presentation Foundation (WPF) têm dois tipos de ícones:

• Um ícone de assembly, que é especificado usando a <ApplicationIcon> propriedade no ficheiro de construção do projeto da aplicação. Este ícone é usado como ícone do ambiente de trabalho para uma montagem.

  Note

  Ao depurar no Visual Studio, o seu ícone pode não aparecer devido ao processo de alojamento. Se executares o executável, o ícone vai aparecer. Para mais informações, consulte Processo de Alojamento (vshost.exe).

• Um ícone por janela especificado definindo Icon. Para cada janela, este ícone é usado na barra de título, no botão da barra de tarefas e na entrada da lista de seleção de aplicações ALT-TAB.

Uma janela WPF mostra sempre um ícone. Quando não é fornecido ao definir Icon, WPF escolhe um ícone a mostrar com base nas seguintes regras:

1. Use o ícone de montagem, se especificado.

2. Se o ícone de montagem não estiver especificado, use o ícone de Microsoft Windows predefinido.

Se usares Icon para especificar um ícone de janela personalizado, podes restaurar o ícone de aplicação predefinido definindo Icon para null.

Um único ícone pode ser usado de várias formas no Windows, incluindo ser mostrado na barra de título de uma janela, na barra de tarefas de uma janela, na lista de seleção de ficheiros ALT+TAB. Cada um destes mostra o ícone com um tamanho diferente; um ícone de 16x16 píxeis é exibido na barra de título de uma janela e na barra de tarefas, enquanto um ícone de 32x32 píxeis é exibido na lista de seleção de ficheiros ALT+TAB. Algumas aplicações, como Microsoft Windows Explorer, fornecem um menu View que permite escolher o tamanho do ícone que pretende visualizar.

Para acomodar os vários tamanhos de ecrã, um ficheiro de ícones é composto por um ou mais ícones reais, cada um representando uma versão do ícone que visa um tamanho e profundidade de cor específicos. Por exemplo, um ícone pode ter apenas um ícone de 16x16 píxeis com 16 cores, enquanto outro pode conter ícones de 16x16 píxeis e 32x32 píxeis com 16 e 256 cores.

Se existirem ícones de todos os tamanhos e profundidades de cor possíveis dentro de um ficheiro de ícones, Window usará o ícone apropriado. Se um ficheiro de ícones contiver apenas um subconjunto de todos os ícones possíveis, Window usa o ícone seguinte mais apropriado por ordem decrescente de tamanhos e profundidade de cor.

O resultado é que um ícone será sempre usado por Window, embora o ícone usado possa não ter como objetivo o tamanho e profundidade de cor necessários. Por exemplo, um ícone de 16x16 píxeis com 16 cores pode ser usado para exibição como um ícone de 32x32 píxeis com 256 cores. Isto pode causar efeitos visuais indesejáveis, como pixelização, mas pode ser evitado criando ícones para todos os tamanhos e profundidades de cor alvo.

Informação de Propriedade de Dependência