Propiedad IXamlSourceTransparency.IsBackgroundTransparent

Definición

Espacio de nombres: Windows.UI.Xaml

Obtiene o establece un valor que especifica si el fondo de todos los objetos DesktopWindowXamlSource del subproceso actual es transparente.

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

Valor de propiedad

Booleanos

true si el fondo de la ventana es transparente; de lo contrario, false.

Requisitos de Windows

Familia de dispositivos

Windows 10 (introducido en 10.0.17763.0)

Ejemplos

En este ejemplo se muestran los objetos DesktopWindowXamlSource configurados para tener un fondo transparente.

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

Con IsBackgroundTransparent establecido trueen , si lo siguiente se establece como el contenido de una isla, la primera columna mostrará el contenido del host, pero la segunda columna será blanca.

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

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

Comentarios

La clase DesktopWindowXamlSource se usa para hospedar Xaml en otra aplicación. Por ejemplo, puedes usarlo para hospedar contenido Xaml en una aplicación WPF o WinForms. Consulta Hospedar controles XAML de WinRT en aplicaciones de escritorio (islas XAML) para obtener más información.

De forma predeterminada, el contenido XAML tiene un fondo opaco, lo que significa que no es posible tener ningún contenido host detrás de la presentación XAML. (En WinUI3, este comportamiento cambia; el XAML siempre tiene un fondo transparente).

Establezca esta propiedad true en para proporcionar a todos los objetos DesktopWindowXamlSource en el subproceso actual un fondo transparente.

Esta interfaz se recupera de una ventana XAML.

Nota

Establecer esta propiedad true en en una aplicación para UWP XAML hará que una ventana XAML sea transparente también cuando esté en modo de pantalla completa (cuando se llama a ApplicationView.TryEnterFullScreenMode).