TaskbarItemInfo.Overlay Propriedade

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 Propriedade

A imagem que aparece sobre o ícone do programa no botão da barra de tarefas. A predefinição é null.

Exemplos

O exemplo seguinte mostra como criar uma TaskbarItemInfo marcação in e definir a Overlay propriedade. Este exemplo faz parte de um exemplo mais amplo fornecido à TaskbarItemInfo turma.

<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 Overlay propriedade no código.

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

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

Observações

Pode adicionar uma imagem ao ícone do programa no botão da barra de tarefas para comunicar o estado da aplicação ao utilizador. A sobreposição utiliza uma estática ou animada ImageSource que está posicionada no canto inferior direito do ícone no botão da barra de tarefas. A sobreposição não é exibida se o utilizador definir a barra de tarefas para mostrar pequenos ícones.

Ícones de programa na área de notificações, que fica no extremo direito da barra de tarefas, são normalmente usados para comunicar o estado da aplicação ao utilizador. No Windows 7, os ícones de programas na área de notificações estão ocultos por defeito e, por isso, são menos úteis para comunicar o estado. Podes usar a sobreposição de botões da barra de tarefas no Windows 7 para comunicar o estado quando o ícone na área de notificações está oculto. A sua aplicação pode detetar a versão do Windows e fornecer notificações de forma adequada ao sistema operativo.

As imagens sobrepostas são renderizadas no tamanho apropriado. Se o ImageSource representa um Icon, também é usada a profundidade de bits apropriada.

A ilustração seguinte mostra a barra Overlayde tarefas .

Windows Overlay da Barra de Tarefas

Ver também

• Version
• OSVersion