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 non UWP (ad esempio, un'applicazione WPF o Windows Forms) di ospitare controlli UWP in qualsiasi elemento dell'interfaccia utente associato a un handle di finestra (HWND).
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Xaml.Hosting.HostingContract, 196608)]
/// [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(Windows.UI.Xaml.Hosting.HostingContract), 196608)]
[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
Requisiti Windows
Famiglia di dispositivi |
Windows Desktop Extension SDK (è stato introdotto in 10.0.17763.0)
|
API contract |
Windows.UI.Xaml.Hosting.HostingContract (è stato introdotto in v3.0)
|
Commenti
DesktopWindowXamlSource è la classe principale nell'API di hosting XAML UWP. Questa API consente alle applicazioni desktop non UWP di ospitare qualsiasi controllo che deriva da Windows.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 con WPF, Windows Forms e l'API Windows (Win32). Per altre informazioni, vedere Uso dell'API di hosting XAML UWP in un'applicazione desktop.
Se crei un oggetto DesktopWindowXamlSource prima di creare gli oggetti Windows.UI.Xaml.UIElement che verranno ospitati, il framework per l'hosting del contenuto Windows.UI.Xaml.UIElement assicura che tutti gli oggetti vengano inizializzati nello stesso thread. Se crei gli oggetti Windows.UI.Xaml.UIElement prima di creare l'oggetto DesktopWindowXamlSource in cui verranno ospitati, devi chiamare WindowsXamlManager.InitializeForCurrentThread prima di creare un'istanza degli oggetti Windows.UI.Xaml.UIElement .
Poiché DesktopWindowXamlSource deriva da IClosable, quindi è consigliabile chiuderlo (disposerlo in .NET) al termine dell'operazione.
Costruttori
DesktopWindowXamlSource() |
Inizializza una nuova istanza della classe DesktopWindowXamlSource . |
Proprietà
Content |
Ottiene o imposta l'oggetto Windows.UI.Xaml.UIElement che vuoi ospitare nell'applicazione desktop. |
HasFocus |
Ottiene un valore che indica se DesktopWindowXamlSource ha attualmente lo stato attivo nell'applicazione desktop. |
Metodi
Close() |
Chiude e rilascia tutte le risorse usate da questo DesktopWindowXamlSource. |
Dispose() |
Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. |
NavigateFocus(XamlSourceFocusNavigationRequest) |
Tenta di assegnare lo stato attivo a livello di codice a DesktopWindowXamlSource nell'applicazione desktop. |
Eventi
GotFocus |
Si verifica quando DesktopWindowXamlSource ottiene lo stato attivo nell'applicazione desktop( ad esempio, l'utente preme il tasto Tab mentre lo stato attivo si trova sull'elemento appena prima di DesktopWindowXamlSource). |
TakeFocusRequested |
Si verifica quando l'applicazione desktop host riceve una richiesta di riattivare lo stato attivo dall'oggetto DesktopWindowXamlSource ( ad esempio, l'utente si trova sull'ultimo elemento attivabile in DesktopWindowXamlSource e preme Tab). |