TaskbarItemInfo.Overlay Propiedad

Definición

Espacio de nombres:

System.Windows.Shell

Ensamblado:

PresentationFramework.dll

Obtiene o establece la imagen que aparece sobre el icono de programa en el botón de la barra de tareas.

public:
 property System::Windows::Media::ImageSource ^ Overlay { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };

public System.Windows.Media.ImageSource Overlay { get; set; }

member this.Overlay : System.Windows.Media.ImageSource with get, set

Public Property Overlay As ImageSource

Valor de propiedad

ImageSource

Imagen que aparece sobre el icono de programa en el botón de la barra de tareas. De manera predeterminada, es null.

Ejemplos

En el ejemplo siguiente se muestra cómo crear un TaskbarItemInfo en el marcado y establecer la Overlay propiedad . Este ejemplo forma parte de un ejemplo más grande proporcionado para la TaskbarItemInfo clase .

<Window.TaskbarItemInfo>
    <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                     Overlay="{StaticResource ResourceKey=StopImage}"
                     ThumbnailClipMargin="80,0,80,140"
                     Description="Taskbar Item Info Sample">
        <TaskbarItemInfo.ThumbButtonInfos>
            <ThumbButtonInfoCollection>
                <ThumbButtonInfo
                    DismissWhenClicked="False"
                    Command="MediaCommands.Play"
                    CommandTarget="{Binding ElementName=btnPlay}"
                    Description="Play"
                    ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                <ThumbButtonInfo
                    DismissWhenClicked="True"
                    Command="MediaCommands.Stop"
                    CommandTarget="{Binding ElementName=btnStop}"
                    Description="Stop"
                    ImageSource="{StaticResource ResourceKey=StopImage}"/>
            </ThumbButtonInfoCollection>
        </TaskbarItemInfo.ThumbButtonInfos>
    </TaskbarItemInfo>
</Window.TaskbarItemInfo>

En el siguiente ejemplo, se muestra cómo establecer la propiedad Overlay en código.

this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("StopImage");

Me.taskBarItemInfo1.Overlay = Me.FindResource("StopImage")

Comentarios

Puede agregar una imagen al icono del programa en el botón de la barra de tareas para comunicar el estado de la aplicación al usuario. La superposición usa un elemento estático o animado ImageSource situado sobre la esquina inferior derecha del icono en el botón de la barra de tareas. La superposición no se muestra si el usuario establece la barra de tareas para mostrar iconos pequeños.

Los iconos de programa en el área de notificación, que se encuentra en el extremo derecho de la barra de tareas, se suelen usar para comunicar el estado de la aplicación a un usuario. En Windows 7, los iconos de programa del área de notificación están ocultos de forma predeterminada y, por tanto, son menos útiles para comunicar el estado. Puedes usar la superposición del botón de la barra de tareas en Windows 7 para comunicar el estado cuando el icono del área de notificación está oculto. La aplicación puede detectar la versión de Windows y proporcionar notificaciones de una manera adecuada para el sistema operativo.

Las imágenes superpuestas se representan en el tamaño adecuado. ImageSource Si representa un Iconobjeto , también se usa la profundidad de bits adecuada.

En la ilustración siguiente se muestra la barra de Overlaytareas .

de tareas Ejemplo
Superposición de la barra de tareas de Windows

Consulte también

• Version
• OSVersion