DesktopWindowXamlSource Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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).
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). |