Propriedade IXamlSourceTransparency.IsBackgroundTransparent

Definição

Espaço de nome: Windows.UI.Xaml

Obtém ou define um valor que especifica se o plano de fundo de todos os objetos DesktopWindowXamlSource no thread atual é transparente.

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

Valor da propriedade

Boolean

true se o fundo da janela for transparente; caso contrário, false.

Requisitos do Windows

Família de dispositivos

Windows 10 (introduzido em 10.0.17763.0)

Exemplos

Este exemplo mostra os objetos DesktopWindowXamlSource que estão sendo configurados para ter um plano de fundo transparente.

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

Com IsBackgroundTransparent definido como , se o seguinte for definido como trueo conteúdo de uma ilha, a primeira coluna mostrará o conteúdo do host, mas a segunda coluna será branca.

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

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

Comentários

A classe DesktopWindowXamlSource é usada para hospedar Xaml em outro aplicativo. Por exemplo, você pode usar isso para hospedar algum conteúdo Xaml em um aplicativo WPF ou WinForms. Consulte Controles XAML do Host WinRT em aplicativos de área de trabalho (Ilhas XAML) para obter mais informações.

Por padrão, o conteúdo XAML tem um plano de fundo opaco, o que significa que não é possível ter nenhum conteúdo do host por trás do XAML exibido. (No WinUI3, esse comportamento é alterado; o XAML sempre tem um plano de fundo transparente.)

Defina essa propriedade para true dar a todos os objetos DesktopWindowXamlSource no thread atual um plano de fundo transparente.

Essa interface é recuperada de uma janela XAML.

Observação

Definir essa propriedade como true em um aplicativo UWP XAML fará com que uma Janela XAML também seja transparente quando estiver no modo de tela inteira (quando você chamou ApplicationView.TryEnterFullScreenMode).