Propriedade IXamlSourceTransparency.IsBackgroundTransparent

Artigo
07/05/2024

Definição

Namespace: 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

Booliano

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 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 true, se o seguinte for definido como o 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 Hospedar controles XAML do WinRT em aplicativos da á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 como true para 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ê chamar ApplicationView.TryEnterFullScreenMode).

Compartilhar via