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 identificador de janela (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

Herança

Object IInspectable DesktopWindowXamlSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Comentários

DesktopWindowXamlSource é a classe primária no SDK do Aplicativo Windows API de hospedagem XAML. Essa API permite que aplicativos da área de trabalho não WASDK hospedem qualquer controle derivado 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, 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 o 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, chame Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread antes de instanciar os objetos UIElement .

Como DesktopWindowXamlSource deriva de IClosable, é recomendável fechá-lo (descartá-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 associado a DesktopSiteBridge este objeto DesktopWindowXamlSource .
SystemBackdrop	Obtém ou define o pano de fundo 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()	Realiza tarefas definidas pelo aplicativo associadas à 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 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 C++ (Win32)