TaskbarItemInfo.Overlay Eigenschap

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

Waarde van eigenschap

De afbeelding die wordt weergegeven op het programmapictogram op de taakbalkknop. De standaardwaarde is null.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een TaskbarItemInfo markering maakt en de Overlay eigenschap instelt. Dit voorbeeld maakt deel uit van een groter voorbeeld voor de TaskbarItemInfo klasse.

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

In het volgende voorbeeld ziet u hoe u de Overlay eigenschap instelt in code.

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

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

Opmerkingen

U kunt een afbeelding toevoegen aan het programmapictogram op de taakbalkknop om de toepassingsstatus aan de gebruiker te communiceren. De overlay maakt gebruik van een statische of geanimeerde animatie ImageSource die in de rechterbenedenhoek van het pictogram op de taakbalkknop wordt geplaatst. De overlay wordt niet weergegeven als de gebruiker de taakbalk instelt om kleine pictogrammen weer te geven.

Programmapictogrammen in het systeemvak, uiterst rechts op de taakbalk, worden meestal gebruikt om de toepassingsstatus aan een gebruiker te communiceren. In Windows 7 worden programmapictogrammen in het systeemvak standaard verborgen en zijn ze daarom minder nuttig voor het communiceren van de status. U kunt de overlay van de taakbalkknop in Windows 7 gebruiken om de status te communiceren wanneer het pictogram in het systeemvak verborgen is. Uw toepassing kan de versie van Windows detecteren en meldingen geven op een manier die geschikt is voor het besturingssysteem.

Overlay-afbeeldingen worden weergegeven op de juiste grootte. Als het ImageSource een vertegenwoordigt Icon, wordt ook de juiste bitdiepte gebruikt.

In de volgende afbeelding ziet u de taakbalk Overlay.

Windows Taskbar Overlay

Zie ook

• Version
• OSVersion