TaskbarItemInfo.Overlay Properti

Definisi

Ruang nama:

System.Windows.Shell

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur gambar yang ditampilkan di atas ikon program di tombol taskbar.

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

Nilai Properti

ImageSource

Gambar yang ditampilkan di atas ikon program di tombol taskbar. Defaultnya adalah null.

Contoh

Contoh berikut menunjukkan cara membuat TaskbarItemInfo dalam markup dan mengatur Overlay properti . Contoh ini adalah bagian dari contoh yang lebih besar yang disediakan untuk TaskbarItemInfo kelas .

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

Contoh berikut menunjukkan cara mengatur Overlay properti dalam kode.

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

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

Keterangan

Anda dapat menambahkan gambar ke ikon program di tombol taskbar untuk mengomunikasikan status aplikasi kepada pengguna. Overlay menggunakan statis atau animasi ImageSource yang diposisikan di sudut kanan bawah ikon di tombol taskbar. Overlay tidak ditampilkan jika pengguna mengatur taskbar untuk menampilkan ikon kecil.

Ikon program di area pemberitahuan, yang berada di ujung kanan taskbar, biasanya digunakan untuk mengomunikasikan status aplikasi kepada pengguna. Di Windows 7, ikon program di area pemberitahuan disembunyikan secara default, dan oleh karena itu, kurang berguna untuk mengomunikasikan status. Anda dapat menggunakan overlay tombol taskbar di Windows 7 untuk berkomunikasi status ketika ikon di area pemberitahuan disembunyikan. Aplikasi Anda dapat mendeteksi versi Windows dan memberikan pemberitahuan dengan cara yang sesuai untuk sistem operasi.

Gambar overlay dirender pada ukuran yang sesuai. ImageSource Jika mewakili Icon, kedalaman bit yang sesuai juga digunakan.

Ilustrasi berikut menunjukkan taskbar Overlay.

Sampel Info Windows Taskbar Overlay

Lihat juga

• Version
• OSVersion