InputPane 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 receba notificações quando o teclado virtual encaixado ou o SIP (Painel de Entrada Flexível) está prestes a ser exibido ou oculto e para determinar qual parte da janela do aplicativo está obscurecida pelo painel de entrada.
Observação
As APIs InputPane fornecem informações precisas de oclusão somente para um painel encaixado. Para o Windows 10 Creators Fall Update e versões mais recentes, recomendamos usar as SEGUINTEs APIs para lidar com a oclusão por painéis de entrada encaixados, desencaixados, moveveis e transitórios, como SIP (Painéis de Entrada Suaves), janelas candidatas do IME (Editor de Método de Entrada), barras de ferramentas flutuantes e assim por diante.
public ref class InputPane sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPanePublic NotInheritable Class InputPane- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
O painel de entrada é exibido quando o usuário executa uma ação que exige que ele insira informações, como selecionar um campo de entrada de texto. Por padrão, o Windows manipula os eventos do painel de entrada e reposiciona o conteúdo para que os usuários possam ver onde estão digitando. Se você definir CoreTextEditContext.InputPaneDisplayPolicy como Manual em seu aplicativo, será responsável por mostrar e ocultar o painel de entrada usando TryShow e TryHide. Use essa classe para substituir o comportamento padrão e personalizar o painel de entrada.
Em alguns casos, a interface do usuário de sobreposição, como um InputPane, não tem suporte total. Isso inclui:
- aplicativos no modo de tela inteira, como jogos.
- Aplicativos holográficos do Windows na exibição holográfica.
Chame GetForCurrentView para obter um objeto InputPane.
Depois que você se registra para receber notificações do painel de entrada, o sistema chama o delegado de eventos sempre que o painel de entrada é mostrado ou oculto para a janela que estava visível quando você chamou o método GetForCurrentView .
Observação
Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e o comportamento de marshaling. Para obter mais informações, consulte Threading e marshaling (C++/CX).
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1903 | 18362 | GetForUIContext |
Propriedades
| OccludedRect |
Obtém a região da janela do aplicativo obscurecida pelo painel de entrada. |
| Visible |
Obtém ou define um valor que indica se o painel de entrada é mostrado. Importante Válido somente para a família de dispositivos Xbox. Para aplicativos universais, a propriedade OccludedRect indica a região da janela do aplicativo obstruída pelo painel de entrada. |
Métodos
| GetForCurrentView() |
Obtém o objeto InputPane associado à janela do aplicativo que está visível no momento. |
| GetForUIContext(UIContext) |
Obtém o objeto InputPane associado à exibição com o identificador de contexto especificado. |
| TryHide() |
Tenta ocultar o InputPane, se estiver visível. |
| TryShow() |
Tenta mostrar o InputPane, se ele estiver oculto. Esse método é um "melhor esforço" e garante apenas que o usuário tenha uma maneira de inserir texto no controle focalizado. O teclado virtual ou o SIP (Painel de Entrada Flexível) só será mostrado se um teclado de hardware não estiver disponível. |
Eventos
| Hiding |
Ocorre quando o painel de entrada começa a deslizar para fora da exibição. |
| Showing |
Ocorre quando o painel de entrada começa a deslizar para a exibição. |