Compartilhar via


Window.Icon Propriedade

Definição

Obtém ou define um ícone de janela.

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

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.

Observação

Você não pode definir ou obter essa propriedade quando uma janela está hospedada em um navegador.

Informações da propriedade de dependência

Campo Identificador IconProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a