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 du 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 du 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 TaskbarItemInfo balisage et définir la Overlay propriété. Cet exemple fait partie d’un exemple plus large 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é dans le code Overlay.

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 une image statique ou animée ImageSource positionnée 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 de programme dans la zone de notification, qui se trouvent à 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 du bouton de la barre des tâches dans Windows 7 pour communiquer l’état lorsque l’icône de 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 de superposition sont rendues à la taille appropriée. Si la ImageSource valeur représente un Iconbit, la profondeur de bits appropriée est également utilisée.

L’illustration suivante montre la barre des Overlaytâches .

Superposition de la barre des tâches Windows

Voir aussi

• Version
• OSVersion