TaskbarItemInfo.Overlay Proprietà

Definizione

Spazio dei nomi:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Ottiene o imposta l'immagine visualizzata sull'icona del programma nel pulsante della barra delle applicazioni.

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

Valore della proprietà

ImageSource

Immagine visualizzata sull'icona del programma nel pulsante della barra delle applicazioni. Il valore predefinito è null.

Esempio

Nell'esempio seguente viene illustrato come creare un TaskbarItemInfo oggetto nel markup e impostare la Overlay proprietà . Questo esempio fa parte di un esempio più ampio fornito per 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>

Nell'esempio riportato di seguito viene illustrato come impostare la proprietà Overlay nel codice.

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

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

Commenti

È possibile aggiungere un'immagine all'icona del programma nel pulsante della barra delle applicazioni per comunicare lo stato dell'applicazione all'utente. La sovrimpressione usa un elemento statico o animato ImageSource posizionato sull'angolo inferiore destro dell'icona nel pulsante della barra delle applicazioni. La sovrimpressione non viene visualizzata se l'utente imposta la barra delle applicazioni per visualizzare icone di piccole dimensioni.

Le icone del programma nell'area di notifica, che si trova all'estrema destra della barra delle applicazioni, vengono in genere usate per comunicare lo stato dell'applicazione a un utente. In Windows 7 le icone del programma nell'area di notifica sono nascoste per impostazione predefinita e pertanto sono meno utili per comunicare lo stato. Puoi usare la sovrimpressione del pulsante della barra delle applicazioni in Windows 7 per comunicare lo stato quando l'icona nell'area di notifica è nascosta. L'applicazione può rilevare la versione di Windows e fornire notifiche in modo appropriato per il sistema operativo.

Il rendering delle immagini sovrapposte viene eseguito con le dimensioni appropriate. ImageSource Se rappresenta un Iconoggetto , viene utilizzata anche la profondità di bit appropriata.

La figura seguente mostra la barra Overlaydelle applicazioni .

di informazioni sull'elemento della
Sovrimpressione della barra delle applicazioni di Windows

Vedi anche

• Version
• OSVersion