Lingua

DesktopWindowXamlSource Classe

Definizione

Consente a un'applicazione desktop 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

Esempio

Questo esempio illustra come aggiungere un'isola WASDK con contenuto XAML a un'app Win32 (il runtime SDK per app di Windows deve essere installato per l'esecuzione dell'app).

Simple Island App

Commenti

DesktopWindowXamlSource è la classe primaria nell'API di hosting XAML SDK per app di Windows (WASDK). Questa API consente alle applicazioni desktop non WASDK di ospitare qualsiasi controllo che deriva da Microsoft. Interfaccia utente. 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 macchine virtuali Windows, Windows Forms e l'API Windows (Win32).

Se si crea un oggetto DesktopWindowXamlSource prima di creare gli oggetti UIElement che verranno ospitati, il framework per l'hosting del 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. Interfaccia utente. Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread prima di creare un'istanza degli oggetti UIElement.

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

Costruttori

Nome Descrizione
DesktopWindowXamlSource()

Inizializza una nuova istanza della classe DesktopWindowXamlSource .

Proprietà

Nome Descrizione
Content

Ottiene o imposta il Microsoft. UI. Oggetto Xaml.UIElement che vuoi ospitare nell'applicazione desktop.

HasFocus

Ottiene un valore che indica se DesktopWindowXamlSource ha attualmente 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

Nome Descrizione
Close()

Chiude e rilascia tutte le risorse usate da 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 a DesktopWindowXamlSource nell'applicazione desktop.

Eventi

Nome Descrizione
GotFocus

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

TakeFocusRequested

Si verifica quando l'applicazione desktop host riceve una richiesta che restituisce lo stato attivo dall'oggetto DesktopWindowXamlSource ( ad esempio, l'utente si trova sull'ultimo elemento attivabile in DesktopWindowXamlSource e preme TAB).

Si applica a

Vedi anche