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 之後) 也保持透明。