InputPane Classe

Definição

Namespace:

Windows.UI.ViewManagement

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.

• CoreInputView
• CoreInputViewOcclusion
• CoreInputViewOcclusionKind

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 InputPane

Public NotInheritable Class InputPane

Herança

Object Platform::Object IInspectable InputPane

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

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.

Confira também

• Responder à presença do teclado virtual