共用方式為


IXamlSourceTransparency.IsBackgroundTransparent 屬性

定義

命名空間:Windows.UI.Xaml

取得或設定一個值,用來指定目前執行緒上所有 DesktopWindowXamlSource 物件的背景是否為透明。

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

屬性值

布林值

如果視窗背景為透明,則為 true;否則為 false

Windows 需求

裝置系列Windows 10 (在 10.0.17763.0 中引進)

範例

此範例顯示設定為透明背景的 DesktopWindowXamlSource 物件。

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

IsBackgroundTransparent 設為 true 時,如果將下列項目設為一個 Island 的內容,則第一欄將會顯示主機的內容,但第二欄將會是白色。

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

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

備註

DesktopWindowXamlSource 類別的作用是在另一個應用程式中裝載 Xaml。 例如,您可以使用此類別,在 WPF 或 WinForms 應用程式中裝載一些 Xaml 內容。 如需詳細資訊,請參閱在桌面應用程式中裝載 WinRT XAML 控制項 (XAML Islands)

預設情況下,XAML 內容的背景為不透明,亦即無法透過 XAML 內容看到任何主機內容。 (在 WinUI3 中,此行為已經改變;XAML 將一律具有透明背景。)

將此屬性設定為 true 時,目前執行緒上的所有 DesktopWindowXamlSource 物件皆會設為透明背景。

此介面擷取自 XAML 視窗

注意

在 XAML UWP 應用程式中將此屬性設定為 true,會讓 XAML 視窗在全螢幕模式中 (呼叫 ApplicationView.TryEnterFullScreenMode 之後) 也保持透明。