DesktopWindowXamlSource Classe

Definição

Namespace:

Microsoft.UI.Xaml.Hosting

Permite que um aplicativo da área de trabalho (por exemplo, um aplicativo WPF ou Windows Forms) hospede controles WinUI em qualquer elemento de interface do usuário associado a um HWND (identificador de janela).

/// [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

Herança

Object IInspectable DesktopWindowXamlSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Comentários

DesktopWindowXamlSource é a classe primária no API de hospedagem XAML do SDK do Aplicativo Windows. Essa API permite que aplicativos de área de trabalho não WASDK hospedem qualquer controle que deriva de Microsoft.UI.Xaml.UIElement em um elemento de interface do usuário associado a um HWND (identificador de janela). Essa API pode ser usada por aplicativos da área de trabalho criados usando o WPF, o Windows Forms e a API do Windows (Win32).

Se você criar um objeto DesktopWindowXamlSource antes de criar os objetos UIElement que serão hospedados nele, a estrutura para hospedar conteúdo UIElement garantirá que todos os objetos sejam inicializados para o mesmo thread. Se você criar os objetos UIElement antes de criar o objeto DesktopWindowXamlSource no qual eles serão hospedados, você deverá chamar Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread antes de instanciar os objetos UIElement.

Como DesktopWindowXamlSource deriva de IClosable, é recomendável que você Fechar ele (Descartar-lo no .NET) quando terminar de usá-lo.

Construtores

DesktopWindowXamlSource()

Inicializa uma nova instância da classe DesktopWindowXamlSource.

Propriedades

Content	Obtém ou define o objeto Microsoft.UI.Xaml.UIElement que você deseja hospedar no aplicativo da área de trabalho.
HasFocus	Obtém um valor que indica se o DesktopWindowXamlSource atualmente tem foco no aplicativo da área de trabalho.
ShouldConstrainPopupsToWorkArea	Obtém ou define um valor que indica se os controles com comportamento semelhante a pop-up devem ser restritos à área de trabalho.
SiteBridge	Obtém o desktopSiteBridge associado a este objeto DesktopWindowXamlSource .
SystemBackdrop	Obtém ou define o cenário do sistema usado para renderizar materiais como Mica e Acrílico.

Métodos

Close()	Fecha e libera todos os recursos usados por este DesktopWindowXamlSource.
Dispose()	Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.
Initialize(WindowId)	Inicializa uma nova instância da classe DesktopWindowXamlSource.
NavigateFocus(XamlSourceFocusNavigationRequest)	Tenta dar foco programaticamente ao desktopWindowXamlSource no aplicativo da área de trabalho.

Eventos

GotFocus	Ocorre quando o DesktopWindowXamlSource obtém o foco no aplicativo da área de trabalho (como quando o usuário pressiona a tecla Tab enquanto o foco está no elemento pouco antes do DesktopWindowXamlSource).
TakeFocusRequested	Ocorre quando o aplicativo da área de trabalho do host recebe uma solicitação para retomar o foco do objeto DesktopWindowXamlSource (por exemplo, o usuário está no último elemento focalizável no DesktopWindowXamlSource e pressiona Tab).

Confira também

• Usando a API de hospedagem XAML do WinRT em um aplicativo da área de trabalho do C++ (Win32)