Properti IXamlSourceTransparency.IsBackgroundTransparent

Artikel
07/29/2023

Definisi

Namespace: Windows.UI.Xaml

Mendapatkan atau menetapkan nilai yang menentukan apakah latar belakang semua objek DesktopWindowXamlSource pada utas saat ini transparan.

[uuid(06636c29-5a17-458d-8ea2-2422d997a922)]
interface IXamlSourceTransparency
{
    Boolean IsBackgroundTransparent;
};

Nilai Properti

Boolean

true jika latar belakang jendela transparan; jika tidak, false.

Persyaratan Windows

Rangkaian perangkat

Windows 10 (diperkenalkan dalam 10.0.17763.0)

Contoh

Contoh ini menunjukkan objek DesktopWindowXamlSource yang dikonfigurasi untuk memiliki latar belakang transparan.

// Make all DesktopWindowXamlSource objects on this
// thread have a transparent background.
var xamlSourceTransparency = (IXamlSourceTransparency)Window.Current;
xamlSourceTransparency.IsBackgroundTransparent = true;

Dengan IsBackgroundTransparent diatur ke true, jika berikut ini diatur sebagai konten pulau, kolom pertama akan menampilkan konten host tetapi kolom kedua akan berwarna putih.

<Grid ColumnDefinitions="Auto,*">
    <TextBlock>Column 0 text</TextBlock>

    <Border Grid.Column="1" Background="White">
        <TextBlock>Column 1 text</TextBlock>
    </Border>
</Grid>

Keterangan

Kelas DesktopWindowXamlSource digunakan untuk menghosting Xaml di aplikasi lain. Misalnya, Anda dapat menggunakan ini untuk menghosting beberapa konten Xaml di aplikasi WPF atau WinForms. Lihat Kontrol Host WinRT XAML di aplikasi desktop (Kepulauan XAML) untuk informasi selengkapnya.

Secara default, konten XAML memiliki latar belakang buram, yang berarti bahwa tidak dimungkinkan untuk memiliki konten host apa pun di belakang yang ditunjukkan XAML. (Di WinUI3, perilaku ini diubah; XAML selalu memiliki latar belakang transparan.)

Atur properti ini ke true untuk memberikan semua objek DesktopWindowXamlSource pada utas saat ini latar belakang transparan.

Antarmuka ini diambil dari Jendela XAML.

Catatan

Mengatur properti ini ke true dalam aplikasi XAML UWP akan menyebabkan Jendela XAML menjadi transparan juga ketika berada dalam mode layar penuh (ketika Anda telah memanggil ApplicationView.TryEnterFullScreenMode).

Bagikan melalui