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로 설정한 채, 다음을 섬의 콘텐츠로 설정하면 호스트의 콘텐츠가 첫 번째 열에 표시되지만 두 번째 열은 흰색이 됩니다.

<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 섬) 를 참조하세요.

기본적으로 XAML 콘텐츠에는 불투명한 배경이 있으므로 XAML 쇼 뒤에 호스트 콘텐츠를 포함할 수 없습니다. (WinUI3에서는 이 동작이 변경되고, XAML에는 항상 투명한 배경이 있습니다.)

이 속성을 true 에 현재 스레드의 모든 DesktopWindowXamlSource 객체에 투명한 배경을 제공합니다.

이 인터페이스는 XAML Window창에서 검색됩니다.

참고 항목

이 속성을 true XAML UWP 앱에 설정하면 XAML 창 이 전체 화면 모드일 때( ApplicationView.TryEnterFullScreenMode를 호출한 경우) 투명해집니다.