Freigeben über


TaskbarItemInfo.Overlay Eigenschaft

Definition

Ruft das Bild ab, das über dem Programmsymbol in der Taskleistenschaltfläche angezeigt wird, oder legt es fest.

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

Eigenschaftswert

Das Bild, das über dem Programmsymbol in der Taskleistenschaltfläche angezeigt wird. Der Standardwert lautet null.

Beispiele

Das folgende Beispiel zeigt, wie Sie ein TaskbarItemInfo Markup erstellen und die Overlay Eigenschaft festlegen. Dieses Beispiel ist Teil eines größeren Beispiels, das für die TaskbarItemInfo Klasse bereitgestellt wird.

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

Das folgende Beispiel zeigt, wie die Overlay Eigenschaft im Code festgelegt wird.

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

Hinweise

Sie können dem Programmsymbol in der Taskleistenschaltfläche ein Bild hinzufügen, um dem Benutzer den Anwendungsstatus mitzuteilen. Die Überlagerung verwendet eine statische oder animierte ImageSource , die über der unteren rechten Ecke des Symbols in der Taskleistenschaltfläche positioniert ist. Die Überlagerung wird nicht angezeigt, wenn der Benutzer die Taskleiste so festlegt, dass kleine Symbole angezeigt werden.

Programmsymbole im Infobereich, die sich ganz rechts auf der Taskleiste befinden, werden in der Regel verwendet, um dem Benutzer den Anwendungsstatus mitzuteilen. In Windows 7 sind Programmsymbole im Infobereich standardmäßig ausgeblendet und daher weniger nützlich für die Kommunikation des Status. Sie können die Taskleisten-Schaltflächenüberlagerung in Windows 7 verwenden, um den Status zu kommunizieren, wenn das Symbol im Infobereich ausgeblendet ist. Ihre Anwendung kann die Version von Windows erkennen und Benachrichtigungen auf eine Weise bereitstellen, die für das Betriebssystem geeignet ist.

Überlagerungsbilder werden in der entsprechenden Größe gerendert. Wenn dies ImageSource eine Icondarstellt, wird auch die entsprechende Bittiefe verwendet.

Die folgende Abbildung zeigt die Taskleiste Overlay.

Infobeispiel für Taskleistenelement-Info zu Windows Taskleistenüberlagerung

Gilt für:

Weitere Informationen