TaskbarItemInfo.Overlay Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Shell

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

ImageSource

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

Beispiele

Im folgenden Beispiel wird gezeigt, wie sie im 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>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Overlay-Eigenschaft im Code festlegen.

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

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

Hinweise

Sie können dem Programmsymbol auf der Taskleistenschaltfläche ein Bild hinzufügen, um dem Benutzer den Anwendungsstatus mitzuteilen. Die Überlagerung verwendet ein statisches oder animiertes ImageSource Element, das ü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, der sich ganz rechts auf der Taskleiste befindet, werden in der Regel verwendet, um einen Benutzer über den Anwendungsstatus zu informieren. In Windows 7 sind Programmsymbole im Infobereich standardmäßig ausgeblendet und daher für die Statuskommunikation weniger nützlich. Sie können die Überlagerung der Taskleistenschaltfläche 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 ein ImageSource darstellt Icon, wird auch die entsprechende Bittiefe verwendet.

Die folgende Abbildung zeigt die Taskleiste Overlay.

Beispiel für Taskleistenelementinformationen für Elementinformationen
Windows-Taskleistenüberlagerung

Gilt für:

Freigeben über