Window.Icon Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur ikon jendela.

public:
 property System::Windows::Media::ImageSource ^ Icon { System::Windows::Media::ImageSource ^ get(); void set(System::Windows::Media::ImageSource ^ value); };

public System.Windows.Media.ImageSource Icon { get; set; }

member this.Icon : System.Windows.Media.ImageSource with get, set

Public Property Icon As ImageSource

Nilai Properti

ImageSource

Objek ImageSource yang mewakili ikon.

Contoh

Contoh berikut menunjukkan cara mengatur ikon jendela.

<Window
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.MainWindow"
    Icon="WPFIcon1.ico">
</Window>

// Set an icon using code
Uri iconUri = new Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute);
this.Icon = BitmapFrame.Create(iconUri);

' Set an icon using code
Dim iconUri As New Uri("pack://application:,,,/WPFIcon2.ico", UriKind.RelativeOrAbsolute)
Me.Icon = BitmapFrame.Create(iconUri)

Keterangan

Aplikasi mandiri Windows Presentation Foundation (WPF) memiliki dua jenis ikon:

• Satu ikon rakitan, yang ditentukan dengan menggunakan <ApplicationIcon> properti dalam file build proyek aplikasi. Ikon ini digunakan sebagai ikon desktop untuk rakitan.

  Catatan

  Saat menelusuri kesalahan di Visual Studio, ikon Anda mungkin tidak muncul karena proses hosting. Jika Anda menjalankan executable, ikon akan muncul. Untuk informasi selengkapnya, lihat Proses Hosting (vshost.exe).

• Satu ikon per jendela yang ditentukan dengan mengatur Icon. Untuk setiap jendela, ikon ini digunakan di bilah judulnya, tombol bilah tugasnya, dan di entri daftar pilihan aplikasi ALT-TAB-nya.

Jendela WPF selalu menampilkan ikon. Ketika seseorang tidak disediakan dengan mengatur Icon, WPF memilih ikon untuk ditampilkan berdasarkan aturan berikut:

1. Gunakan ikon rakitan, jika ditentukan.

2. Jika ikon rakitan tidak ditentukan, gunakan ikon default Microsoft Windows.

Jika Anda menggunakan Icon untuk menentukan ikon jendela kustom, Anda dapat memulihkan ikon aplikasi default dengan mengatur Icon ke null.

Ikon tunggal dapat digunakan dalam berbagai cara di Windows, termasuk ditampilkan di bilah judul jendela, bilah tugas untuk jendela, daftar pilihan file ALT+TAB. Masing-masing menunjukkan ikon menggunakan ukuran yang berbeda; ikon piksel 16x16 ditampilkan di bilah judul jendela dan di bilah tugas, sementara ikon piksel 32x32 ditampilkan dalam daftar pilihan file ALT+TAB. Beberapa aplikasi, seperti Microsoft Windows Explorer, menyediakan menu Tampilan yang memungkinkan Anda memilih ukuran ikon yang ingin Anda lihat.

Untuk memenuhi berbagai ukuran tampilan, file ikon terdiri dari satu atau beberapa ikon aktual di mana masing-masing mewakili versi ikon yang menargetkan ukuran dan kedalaman warna tertentu. Misalnya, satu ikon mungkin hanya memiliki satu ikon piksel 16x16 dengan 16 warna, sementara ikon lain mungkin berisi 16x16 piksel dan 32x32 piksel dengan 16 warna dan 256 warna.

Jika ikon untuk semua kemungkinan ukuran dan kedalaman warna ada dalam file ikon, Window akan menggunakan ikon yang sesuai. Jika file ikon hanya berisi subset dari semua ikon yang mungkin, Window gunakan ikon berikutnya yang paling tepat untuk mengurangi ukuran dan kedalaman warna.

Hasilnya adalah bahwa ikon akan selalu digunakan oleh Window, meskipun ikon yang digunakan mungkin tidak menargetkan ukuran dan kedalaman warna yang diperlukan. Misalnya, ikon 16x16 piksel dengan 16 warna dapat digunakan untuk tampilan sebagai ikon piksel 32x32 dengan 256 warna. Ini dapat menyebabkan efek visual yang tidak diinginkan, seperti piksilasi, tetapi dapat dihindari dengan membuat ikon untuk semua ukuran dan kedalaman warna yang ditargetkan.

Catatan

Anda tidak dapat mengatur atau mendapatkan properti ini ketika jendela dihosting di browser.

Informasi Properti Dependensi

Bidang pengidentifikasi	IconProperty
Properti metadata diatur ke true	Tidak ada