Propriété IXamlSourceTransparency.IsBackgroundTransparent

Définition

Espace de noms : Windows.UI.Xaml

Obtient ou définit une valeur qui spécifie si l’arrière-plan de tous les objets DesktopWindowXamlSource sur le thread actuel est transparent.

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

Valeur de propriété

Booléen

true si l’arrière-plan de la fenêtre est transparent ; sinon, false.

Configuration requise pour Windows

Famille d’appareils

Windows 10 (introduit dans la version 10.0.17763.0)

Exemples

Cet exemple montre les objets DesktopWindowXamlSource configurés pour avoir un arrière-plan transparent.

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

Avec IsBackgroundTransparent la valeur définie truesur , si la valeur suivante est définie comme contenu d’une île, la première colonne affiche le contenu de l’hôte, mais la deuxième colonne est blanche.

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

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

Notes

La classe DesktopWindowXamlSource est utilisée pour héberger Xaml dans une autre application. Par exemple, vous pouvez l’utiliser pour héberger du contenu Xaml dans une application WPF ou WinForms. Pour plus d’informations, consultez Les contrôles XAML Host WinRT dans les applications de bureau (XAML Islands).

Par défaut, le contenu XAML a un arrière-plan opaque, ce qui signifie qu’il n’est pas possible d’avoir un contenu hôte derrière le code XAML. (Dans WinUI3, ce comportement est modifié ; le code XAML a toujours un arrière-plan transparent.)

Définissez cette propriété pour donner à true tous les objets DesktopWindowXamlSource sur le thread actuel un arrière-plan transparent.

Cette interface est récupérée à partir d’une fenêtre XAML.

Notes

La définition de cette propriété true dans une application UWP XAML entraîne la transparence d’une fenêtre XAML lorsqu’elle est en mode plein écran (lorsque vous avez appelé ApplicationView.TryEnterFullScreenMode).