Свойство IXamlSourceTransparency.IsBackgroundTransparent

Статья
07/29/2023

Определение

Пространство имен: Windows.UI.Xaml

Возвращает или задает значение, указывающее, является ли фон всех объектов DesktopWindowXamlSource в текущем потоке прозрачным.

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

Значение свойства

Boolean

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;

trueЕсли IsBackgroundTransparent задано значение , если в качестве содержимого острова задано следующее значение, первый столбец будет отображать содержимое узла, но второй столбец будет белым.

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

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

Замечания

Класс DesktopWindowXamlSource используется для размещения Xaml в другом приложении. Например, это можно использовать для размещения содержимого Xaml в приложении WPF или WinForms. Дополнительные сведения см. в элементах управления WinRT XAML в классических приложениях (XAML Islands).

По умолчанию содержимое XAML имеет непрозрачный фон, что означает, что невозможно использовать любое содержимое узла за отображением XAML. (В WinUI3 это поведение изменяется; XAML всегда имеет прозрачный фон.)

Задайте это свойство, чтобы true предоставить всем объектам DesktopWindowXamlSource текущего потока прозрачный фон.

Этот интерфейс извлекается из окна XAML.

Примечание.

Установка этого свойства true в приложении UWP XAML приведет к прозрачности окна XAML, а также при использовании полноэкранного режима (при вызове ApplicationView.TryEnterFullScreenMode).

Поделиться через