Window.Icon Propiedad

Definición

Obtiene o establece el icono de una ventana.

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 propiedad

Objeto ImageSource que representa el icono.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo establecer un icono de ventana.

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

Comentarios

las aplicaciones independientes de Windows Presentation Foundation (WPF) tienen dos tipos de iconos:

  • Un icono de ensamblado, que se especifica mediante la <ApplicationIcon> propiedad en el archivo de compilación del proyecto de la aplicación. Este icono se usa como icono de escritorio para un ensamblado.

    Nota

    Al depurar en Visual Studio, es posible que el icono no aparezca debido al proceso de hospedaje. Si ejecuta el archivo ejecutable, aparecerá el icono. Para obtener más información, vea Proceso de alojamiento (vshost.exe).

  • Un icono por ventana especificado estableciendo Icon. Para cada ventana, este icono se usa en su barra de título, su botón de barra de tareas y en su entrada de lista de selección de la aplicación ALT-TAB.

Una ventana de WPF siempre muestra un icono. Cuando no se proporciona uno estableciendo Icon, WPF elige un icono para mostrar en función de las reglas siguientes:

  1. Use el icono de ensamblado, si se especifica.

  2. Si no se especifica el icono de ensamblado, use el icono predeterminado Microsoft Windows.

Si usa Icon para especificar un icono de ventana personalizado, puede restaurar el icono de aplicación predeterminado estableciendo Icon en null.

Un solo icono se puede usar de varias maneras en Windows, incluida la que se muestra en la barra de título de una ventana, la barra de tareas de una ventana, la lista de selección de archivos ALT+TAB. Cada uno de estos muestra el icono con un tamaño diferente; Se muestra un icono de 16 x 16 píxeles en la barra de título de una ventana y en la barra de tareas, mientras que un icono de 32 x 32 píxeles se muestra en la lista de selección de archivos ALT+TAB. Algunas aplicaciones, como Microsoft Explorador de Windows, proporcionan un menú Ver que le permite elegir el tamaño del icono que desea ver.

Para satisfacer los distintos tamaños de presentación, un archivo de icono se compone de uno o varios iconos reales donde cada uno representa una versión del icono que tiene como destino un tamaño y una profundidad de color específicos. Por ejemplo, un icono solo puede tener un icono de 16 x 16 píxeles con 16 colores, mientras que otro puede contener 16 x 16 píxeles y iconos de 32 x 32 píxeles con 16 colores y 256 colores.

Si existen iconos para todos los tamaños y profundidades de color posibles dentro de un archivo de icono, Window usará el icono adecuado. Si un archivo de icono contiene solo un subconjunto de todos los iconos posibles, Window usa el siguiente icono más adecuado para reducir tamaños y profundidad de color.

El resultado es que siempre usará Windowun icono, aunque es posible que el icono usado no tenga como destino el tamaño y la profundidad de color necesarios. Por ejemplo, se puede usar un icono de 16 x 16 píxeles con 16 colores para mostrarse como un icono de 32 x 32 píxeles con 256 colores. Esto puede causar efectos visuales no deseados, como pixilation, pero puede evitarse mediante la creación de iconos para todos los tamaños de destino y profundidades de color.

Nota

No se puede establecer ni obtener esta propiedad cuando se hospeda una ventana en un explorador.

Información sobre propiedades de dependencia

Campo identificador IconProperty
Propiedades de metadatos establecidas en true Ninguno

Se aplica a