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 não UWP (por exemplo, um aplicativo WPF ou Windows Forms) hospede controles UWP em qualquer elemento de interface do usuário associado a um HWND (identificador de janela).
/// [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.IDisposablePublic Class DesktopWindowXamlSource
Implements IDisposable- Herança
- Atributos
- Implementações
Requisitos do Windows
| Família de dispositivos |
Windows Desktop Extension SDK (introduzida na 10.0.17763.0)
|
| API contract |
Windows.UI.Xaml.Hosting.HostingContract (introduzida na v3.0)
|
Comentários
DesktopWindowXamlSource é a classe main na API de hospedagem XAML da UWP. Essa API permite que aplicativos da área de trabalho não UWP hospedem qualquer controle derivado de Windows.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). Para obter mais informações, consulte Usando a API de hospedagem XAML UWP em um aplicativo da área de trabalho.
Se você criar um objeto DesktopWindowXamlSource antes de criar os objetos Windows.UI.Xaml.UIElement que serão hospedados nele, a estrutura para hospedar o conteúdo Windows.UI.Xaml.UIElement garantirá que todos os objetos sejam inicializados para o mesmo thread. Se você criar os objetos Windows.UI.Xaml.UIElement antes de criar o objeto DesktopWindowXamlSource no qual eles serão hospedados, chame WindowsXamlManager.InitializeForCurrentThread antes de instanciar os objetos Windows.UI.Xaml.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 Windows.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. |
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. |
| 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 (por exemplo, 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). |