ImageIcon Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mewakili ikon yang menggunakan Gambar sebagai kontennya.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageIcon : IconElement

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ImageIcon : IconElement

Public Class ImageIcon
Inherits IconElement

Warisan

IconElement

ImageIcon

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Ikon untuk aplikasi Windows.

Aplikasi Galeri WinUI 3 dan Galeri WinUI 2 mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3 dan WinUI 2.

Jika sudah diinstal, buka dengan mengklik tautan berikut: Galeri WinUI 3 atau Galeri WinUI 2.

Jika tidak diinstal, Anda dapat mengunduh Galeri WinUI 3 dan Galeri WinUI 2 dari Microsoft Store.

Anda juga bisa mendapatkan kode sumber untuk keduanya dari GitHub (gunakan cabang utama untuk WinUI 3 dan cabang winui2 untuk WinUI 2).

Contoh berikut menunjukkan AppBarButton dengan ImageIcon. Sumber menentukan gambar yang disertakan dalam paket aplikasi.

<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->

<AppBarButton Label="ImageIcon">
    <AppBarButton.Icon>
        <muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
    </AppBarButton.Icon>
</AppBarButton>

Di sini kami menunjukkan cara memuat ImageIcon dari aliran bitmap.

// using muxc = Microsoft.UI.Xaml.Controls;

var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };

Keterangan

Jenis gambar yang didukung adalah .bmp, .gif, .jpg, .png, .wdp, dan .tiff.

Gambar harus solid pada latar belakang transparan.

Hanya bingkai pertama dari gambar multi-bingkai yang digunakan. Untuk menggunakan ikon animasi, lihat AnimatedIcon.

Karena jenis file yang didukung, ImageIcon mengabaikan properti Latar Depan , sehingga Anda tidak dapat mengubah warna latar depan seperti yang Anda bisa pada kontrol turunan IconSource lainnya.

ImageIcon biasanya digunakan dengan AppBarButton, tetapi dapat digunakan di mana pun IconElement dapat digunakan.

Konstruktor

ImageIcon()

Menginisialisasi instans baru kelas ImageIcon. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Properti

Source	Mendapatkan atau mengatur URI file gambar untuk digunakan sebagai ikon. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SourceProperty	Source Mengidentifikasi properti dependensi. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Lihat juga

• IconSource
• AppBarButton
• Gambar
• Ikon untuk aplikasi UWP