Condividi tramite


DesktopWindowXamlSource Classe

Definizione

Consente a un'applicazione desktop (ad esempio, un'applicazione WPF o Windows Form) di ospitare controlli WinUI in qualsiasi elemento dell'interfaccia utente associato a un handle di finestra (HWND).

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DesktopWindowXamlSource : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DesktopWindowXamlSource : System.IDisposable
Public Class DesktopWindowXamlSource
Implements IDisposable
Ereditarietà
Object IInspectable DesktopWindowXamlSource
Attributi
Implementazioni

Commenti

DesktopWindowXamlSource è la classe primaria nell'API di hosting XAML Windows App SDK. Questa API consente alle applicazioni desktop non WASDK di ospitare qualsiasi controllo che deriva da Microsoft.UI.Xaml.UIElement in un elemento dell'interfaccia utente associato a un handle di finestra (HWND). Questa API può essere usata dalle applicazioni desktop create usando WPF, Windows Form e l'API Windows (Win32).

Se si crea un oggetto DesktopWindowXamlSource prima di creare gli oggetti UIElement che saranno ospitati, il framework per l'hosting di contenuto UIElement garantisce che tutti gli oggetti vengano inizializzati nello stesso thread. Se crei gli oggetti UIElement prima di creare l'oggetto DesktopWindowXamlSource in cui verranno ospitati, devi chiamare Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread prima di creare un'istanza degli oggetti UIElement .

Poiché DesktopWindowXamlSource deriva da IClosable, è consigliabile Chiudi (Dispose in .NET) al termine dell'operazione.

Costruttori

DesktopWindowXamlSource()

Inizializza una nuova istanza della classe DesktopWindowXamlSource .

Proprietà

Content

Ottiene o imposta il oggetto Microsoft.UI.Xaml.UIElement che si desidera ospitare nell'applicazione desktop.

HasFocus

Ottiene un valore che indica se il DesktopWindowXamlSource attualmente ha lo stato attivo nell'applicazione desktop.

ShouldConstrainPopupsToWorkArea

Ottiene o imposta un valore che indica se i controlli con comportamento simile a popup devono essere vincolati all'area di lavoro.

SiteBridge

Ottiene il DesktopSiteBridge associato a questo oggetto DesktopWindowXamlSource .

SystemBackdrop

Ottiene o imposta lo sfondo del sistema utilizzato per eseguire il rendering di materiali come Mica e Acrilico.

Metodi

Close()

Chiude e rilascia tutte le risorse usate da questo DesktopWindowXamlSource.

Dispose()

Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.

Initialize(WindowId)

Inizializza una nuova istanza della classe DesktopWindowXamlSource .

NavigateFocus(XamlSourceFocusNavigationRequest)

Tenta di assegnare lo stato attivo a livello di codice al DesktopWindowXamlSource nell'applicazione desktop.

Eventi

GotFocus

Si verifica quando l'DesktopWindowXamlSource ottiene lo stato attivo nell'applicazione desktop, ad esempio quando l'utente preme il tasto tabulazione mentre lo stato attivo è sull'elemento appena prima del DesktopWindowXamlSource).

TakeFocusRequested

Si verifica quando l'applicazione desktop host riceve una richiesta che restituisce lo stato attivo dall'oggetto DesktopWindowXamlSource DesktopWindowXamlSource, ad esempio l'ultimo elemento attivabile nell'DesktopWindowXamlSource e preme Tab).

Si applica a

Vedi anche