TaskbarItemInfo.Overlay Propriedade

Definição

Namespace:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Obtém ou define a imagem que é exibida sobre o ícone de programa no botão da barra de tarefas.

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

ImageSource

A imagem que é exibida sobre o ícone de programa no botão da barra de tarefas. O padrão é null.

Exemplos

O exemplo a seguir mostra como criar um TaskbarItemInfo na marcação e definir a Overlay propriedade . Este exemplo faz parte de um exemplo maior fornecido para a TaskbarItemInfo classe .

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

O exemplo a seguir mostra como definir a propriedade Overlay no código.

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

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

Comentários

Você pode adicionar uma imagem ao ícone do programa no botão da barra de tarefas para comunicar o status do aplicativo ao usuário. A sobreposição usa uma estática ou animada ImageSource posicionada sobre o canto inferior direito do ícone no botão da barra de tarefas. A sobreposição não será exibida se o usuário definir a barra de tarefas para mostrar ícones pequenos.

Os ícones do programa na área de notificação, que fica na extrema direita da barra de tarefas, normalmente são usados para comunicar o status do aplicativo a um usuário. No Windows 7, os ícones do programa na área de notificação são ocultos por padrão e, portanto, são menos úteis para comunicar o status. Você pode usar a sobreposição do botão da barra de tarefas no Windows 7 para comunicar o status quando o ícone na área de notificação estiver oculto. Seu aplicativo pode detectar a versão do Windows e fornecer notificações de maneira apropriada para o sistema operacional.

As imagens de sobreposição são renderizadas no tamanho apropriado. Se o ImageSource representar um Icon, a profundidade de bit apropriada também será usada.

A ilustração a seguir mostra a barra de tarefas Overlay.

Exemplo de informações de Exemplo
Sobreposição da barra de tarefas do Windows

Confira também

• Version
• OSVersion