DesktopWindowXamlSource Classe

Definizione

Consente a un'applicazione desktop (ad esempio, un'applicazione WPF o Windows Forms) 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 SDK per app di Windows. Questa API consente alle applicazioni desktop non WASDK di ospitare qualsiasi controllo derivato 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 compilate con WPF, Windows Forms e l'API Windows (Win32).

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

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

Costruttori

DesktopWindowXamlSource()

Inizializza una nuova istanza della classe DesktopWindowXamlSource .

Proprietà

Content

Ottiene o imposta l'oggetto Microsoft.UI.Xaml.UIElement che si vuole 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 l'oggetto DesktopSiteBridge associato a questo oggetto DesktopWindowXamlSource .

SystemBackdrop

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

Metodi

Close()

Chiude e rilascia tutte le risorse usate da DesktopWindowXamlSource.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

Initialize(WindowId)

Inizializza una nuova istanza della classe DesktopWindowXamlSource .

NavigateFocus(XamlSourceFocusNavigationRequest)

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

Eventi

GotFocus

Si verifica quando 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 di DesktopWindowXamlSource.

TakeFocusRequested

Si verifica quando l'applicazione desktop host riceve una richiesta riprende lo stato attivo dall'oggetto DesktopWindowXamlSource , ad esempio l'utente si trova nell'ultimo elemento attivo in DesktopWindowXamlSource e preme tabulazione.

Si applica a

Vedi anche