DesktopWindowXamlSource Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Atributos
- Implementações
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). |