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 da propriedade

Um objeto ImageSource que representa o ícone.

Atributos

SecurityCriticalAttribute

Exemplos

O exemplo a seguir 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)

Comentários

Windows Presentation Foundation (WPF) aplicativos autônomos têm dois tipos de ícones:

• Um ícone de assembly, que é especificado usando a <ApplicationIcon> propriedade no arquivo de build do projeto do aplicativo. Esse ícone é usado como o ícone da área de trabalho para um assembly.

  Observação

  Ao depurar no Visual Studio, o ícone pode não aparecer devido ao processo de hospedagem. Se você executar o executável, o ícone será exibido. Para obter mais informações, consulte Processo de hospedagem (vshost.exe).

• Um ícone por janela especificado pela configuração Iconde . Para cada janela, esse ícone é usado em sua barra de título, no botão da barra de tarefas e na entrada da lista de seleção de aplicativos ALT-TAB.

Uma janela do WPF sempre exibe um ícone. Quando um não é fornecido pela configuração Icon, o WPF escolhe um ícone a ser exibido com base nas seguintes regras:

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

2. Se o ícone de assembly não for especificado, use o padrão Microsoft ícone do Windows.

Se você usar Icon para especificar um ícone de janela personalizado, poderá restaurar o ícone de aplicativo padrão definindo Icon como null.

Um único ícone pode ser usado de várias maneiras no Windows, incluindo ser mostrado na barra de título de uma janela, a barra de tarefas de uma janela, a lista de seleção de arquivos ALT+TAB. Cada um deles mostra o ícone usando um tamanho diferente; um ícone de 16 x 16 pixels é exibido na barra de título de uma janela e na barra de tarefas, enquanto um ícone de 32 x 32 pixels é exibido na lista de seleção de arquivos ALT+TAB. Alguns aplicativos, como Microsoft Windows Explorer, fornecem um menu Exibir que permite escolher o tamanho do ícone que você deseja exibir.

Para atender aos vários tamanhos de exibição, um arquivo de ícone é composto por um ou mais ícones reais em que cada um representa uma versão do ícone direcionada a um tamanho específico e profundidade de cor. Por exemplo, um ícone pode ter apenas um único ícone de 16 x 16 pixels com 16 cores, enquanto outro pode conter ícones de 16 x 16 pixels e 32 x 32 pixels com 16 cores e 256 cores.

Se houver ícones para todos os tamanhos e profundidades de cores possíveis dentro de um arquivo de ícone, Window usará o ícone apropriado. Se um arquivo de ícone contiver apenas um subconjunto de todos os ícones possíveis, Window usará o próximo ícone mais apropriado para diminuir tamanhos e profundidade de cor.

O resultado é que um ícone sempre será usado por Window, embora o ícone usado possa não ter como destino o tamanho necessário e a profundidade de cor. Por exemplo, um ícone de 16 x 16 pixels com 16 cores pode ser usado para exibição como um ícone de 32 x 32 pixels com 256 cores. Isso pode causar efeitos visuais indesejáveis, como pixilação, mas pode ser evitado criando ícones para todos os tamanhos de destino e profundidades de cor.

Informações da propriedade de dependência

Aplica-se a