Compartilhar via


InputPane Classe

Definição

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 InputPane
Public NotInheritable Class InputPane
Herança
Object Platform::Object IInspectable InputPane
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:

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.

Aplica-se a

Confira também