IXamlSourceTransparency.IsBackgroundTransparent-Eigenschaft

Artikel
07/29/2023

Definition

Namespace: Windows.UI.Xaml

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Hintergrund aller DesktopWindowXamlSource -Objekte im aktuellen Thread transparent ist.

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

Eigenschaftswert

Boolescher Wert

truewenn der Fensterhintergrund transparent ist; andernfalls . false

Windows-Anforderungen

Gerätefamilie

Windows 10 (eingeführt in 10.0.17763.0)

Beispiele

In diesem Beispiel werden die DesktopWindowXamlSource-Objekte dargestellt, die für einen transparenten Hintergrund konfiguriert sind.

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

trueWenn IsBackgroundTransparent folgendes als Inhalt einer Insel festgelegt ist, zeigt die erste Spalte den Inhalt des Hosts an, aber die zweite Spalte ist weiß.

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

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

Hinweise

Die DesktopWindowXamlSource-Klasse wird verwendet, um Xaml in einer anderen App zu hosten. Sie können dies beispielsweise verwenden, um xaml-Inhalte in einer WPF- oder WinForms-App zu hosten. Weitere Informationen finden Sie unter Host-WinRT-XAML-Steuerelemente in Desktop-Apps (XAML-Inseln ).

Standardmäßig verfügt der XAML-Inhalt über einen undurchsichtigen Hintergrund, was bedeutet, dass kein Hostinhalt hinter dem XAML-Code angezeigt werden kann. (In WinUI3 wird dieses Verhalten geändert; der XAML-Code verfügt immer über einen transparenten Hintergrund.)

Legen Sie diese Eigenschaft fest, um true allen DesktopWindowXamlSource-Objekten im aktuellen Thread einen transparenten Hintergrund zu verleihen.

Diese Schnittstelle wird aus einem XAML-Fenster abgerufen.

Hinweis

Wenn Sie diese Eigenschaft true in einer XAML-UWP-App festlegen, wird auch ein XAML-Fenster transparent sein, wenn sie sich im Vollbildmodus befindet (wenn Sie ApplicationView.TryEnterFullScreenMode aufgerufen haben).

Freigeben über