Proprietà IXamlSourceTransparency.IsBackgroundTransparent

Definizione

Spazio dei nomi: Windows.UI.Xaml

Ottiene o imposta un valore che specifica se lo sfondo di tutti gli oggetti DesktopWindowXamlSource nel thread corrente è trasparente.

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

Valore della proprietà

Booleano

true se lo sfondo della finestra è trasparente; in caso contrario, false.

Requisiti Windows

Famiglia di dispositiviWindows 10 (introdotto nella versione 10.0.17763.0)

Esempi

Questo esempio mostra gli oggetti DesktopWindowXamlSource configurati per avere uno sfondo trasparente.

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

Con IsBackgroundTransparent impostato su true, se il codice seguente viene impostato come contenuto di un'isola, la prima colonna mostrerà il contenuto dell'host, ma la seconda colonna sarà bianca.

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

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

Osservazioni:

La classe DesktopWindowXamlSource viene usata per ospitare Xaml in un'altra app. Ad esempio, puoi usarlo per ospitare alcuni contenuti Xaml in un'app WPF o WinForms. Per altre info, vedi Ospitare controlli XAML WinRT nelle app desktop (isole XAML).

Per impostazione predefinita, il contenuto XAML ha uno sfondo opaco, ovvero non è possibile avere alcun contenuto host dietro lo show XAML. In WinUI3 questo comportamento viene modificato. Il codice XAML ha sempre uno sfondo trasparente.

Impostare questa proprietà su true per assegnare a tutti gli oggetti DesktopWindowXamlSource nel thread corrente uno sfondo trasparente.

Questa interfaccia viene recuperata da una finestra XAML.

Nota

L'impostazione di questa proprietà su true in un'app UWP XAML causerà la trasparenza di una finestra XAML anche quando è in modalità schermo intero (quando hai chiamato ApplicationView.TryEnterFullScreenMode).