DesktopWindowXamlSource Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Hosting

Habilita una aplicación de escritorio (por ejemplo, una aplicación WPF o Windows Forms) para hospedar controles WinUI en cualquier elemento de interfaz de usuario asociado a un identificador de ventana (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

Herencia

Object IInspectable DesktopWindowXamlSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

Comentarios

DesktopWindowXamlSource es la clase principal de la API de hospedaje XAML de SDK de Aplicaciones para Windows. Esta API permite que las aplicaciones de escritorio que no son WASDK hospeden cualquier control que derive de Microsoft.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.

Si crea un objeto DesktopWindowXamlSource antes de crear los objetos UIElement que se hospedarán en él, el marco para hospedar contenido UIElement garantiza que todos los objetos se inicialicen en el mismo subproceso. Si creas los objetos UIElement antes de crear el objeto DesktopWindowXamlSource en el que se hospedarán, debes llamar a Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread antes de crear una instancia de los objetos UIElement .

Dado que DesktopWindowXamlSource deriva de IClosable, 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 Microsoft.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.
ShouldConstrainPopupsToWorkArea	Obtiene o establece un valor que indica si los controles con comportamiento similar al elemento emergente deben restringirse al área de trabajo.
SiteBridge	Obtiene el asociado DesktopSiteBridge a este objeto DesktopWindowXamlSource .
SystemBackdrop	Obtiene o establece el fondo del sistema utilizado para representar materiales como Mica y Acrílico.

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.
Initialize(WindowId)	Inicializa una nueva instancia de la clase DesktopWindowXamlSource .
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, cuando 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).

Consulte también

• Uso de la API de hospedaje XAML de WinRT en una aplicación de C++ de escritorio (Win32)