TaskbarItemInfo.Overlay Propriété

Définition

Espace de noms:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Obtient ou définit l'image affichée sur l'icône de programme dans le bouton de la barre des tâches.

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

Valeur de propriété

ImageSource

Image affichée sur l'icône de programme dans le bouton de la barre des tâches. La valeur par défaut est null.

Exemples

L’exemple suivant montre comment créer un dans le TaskbarItemInfo balisage et définir la Overlay propriété. Cet exemple fait partie d’un exemple plus grand fourni pour la 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>

L'exemple suivant montre comment définir la propriété Overlay dans le code.

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

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

Remarques

Vous pouvez ajouter une image à l’icône du programme dans le bouton de la barre des tâches pour communiquer l’état de l’application à l’utilisateur. La superposition utilise un statique ou un animé ImageSource qui est positionné sur le coin inférieur droit de l’icône dans le bouton de la barre des tâches. La superposition n’est pas affichée si l’utilisateur définit la barre des tâches pour afficher de petites icônes.

Les icônes du programme dans la zone de notification, qui se trouve à l’extrême droite de la barre des tâches, sont généralement utilisées pour communiquer l’état de l’application à un utilisateur. Dans Windows 7, les icônes de programme dans la zone de notification sont masquées par défaut et sont donc moins utiles pour communiquer l’état. Vous pouvez utiliser la superposition de bouton de la barre des tâches dans Windows 7 pour communiquer l’état lorsque l’icône dans la zone de notification est masquée. Votre application peut détecter la version de Windows et fournir des notifications d’une manière appropriée pour le système d’exploitation.

Les images superposées sont rendues à la taille appropriée. Si représente ImageSource un Icon, la profondeur de bits appropriée est également utilisée.

L’illustration suivante montre la barre Overlaydes tâches .

Superposition de la barre des tâches Windows

Voir aussi

• Version
• OSVersion