DesktopWindowXamlSource Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite que una aplicación de escritorio que no sea para UWP (por ejemplo, una aplicación wpF o Windows Forms) hospede controles para UWP en cualquier elemento de interfaz de usuario asociado a un identificador de ventana (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
- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
Familia de dispositivos |
Windows Desktop Extension SDK (se introdujo en la versión 10.0.17763.0)
|
API contract |
Windows.UI.Xaml.Hosting.HostingContract (se introdujo en la versión v3.0)
|
Comentarios
DesktopWindowXamlSource es la clase principal de la API de hospedaje XAML para UWP. Esta API permite que las aplicaciones de escritorio que no son para UWP hospeden cualquier control que derive de Windows.UI.Xaml.UIElement) en un elemento de interfaz de usuario asociado a un identificador de ventana (HWND). Las aplicaciones de escritorio creadas con WPF, Windows Forms y la API de Windows (Win32) pueden usar esta API de escritorio. Para obtener más información, consulta Uso de la API de hospedaje XAML para UWP en una aplicación de escritorio.
Si crea un objeto DesktopWindowXamlSource antes de crear los objetos Windows.UI.Xaml.UIElement que se hospedarán en él, el marco para hospedar contenido Windows.UI.Xaml.UIElement garantiza que todos los objetos se inicializan en el mismo subproceso. Si creas los objetos Windows.UI.Xaml.UIElement antes de crear el objeto DesktopWindowXamlSource en el que se hospedarán, debes llamar a WindowsXamlManager.InitializeForCurrentThread antes de crear instancias de los objetos Windows.UI.Xaml.UIElement .
Dado que DesktopWindowXamlSource deriva de IClosable, por lo que se recomienda cerrarlo (eliminarlo en .NET) cuando haya terminado con él.
Constructores
DesktopWindowXamlSource() |
Inicializa una nueva instancia de la clase DesktopWindowXamlSource . |
Propiedades
Content |
Obtiene o establece el objeto Windows.UI.Xaml.UIElement que desea hospedar en la aplicación de escritorio. |
HasFocus |
Obtiene un valor que indica si DesktopWindowXamlSource tiene actualmente el foco en la aplicación de escritorio. |
Métodos
Close() |
Cierra y libera los recursos usados por este DesktopWindowXamlSource. |
Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. |
NavigateFocus(XamlSourceFocusNavigationRequest) |
Intenta centrarse mediante programación en DesktopWindowXamlSource en la aplicación de escritorio. |
Eventos
GotFocus |
Se produce cuando DesktopWindowXamlSource se centra en la aplicación de escritorio (por ejemplo, el usuario presiona la tecla Tab mientras el foco está en el elemento justo antes de DesktopWindowXamlSource). |
TakeFocusRequested |
Se produce cuando la aplicación de escritorio host recibe una solicitud para recuperar el foco del objeto DesktopWindowXamlSource (por ejemplo, el usuario está en el último elemento que se puede centrar en DesktopWindowXamlSource y presiona Tab). |