Compartilhar via


CoreInputView Classe

Definição

Permite que um aplicativo controle a exibição de um painel de entrada encaixado, desencaixado, movevel ou transitório (e da interface do usuário associada), receba notificações quando o painel é movido, exibido ou oculto e para determinar qual parte da janela do aplicativo é obscurecida pelo painel.

Observação

Sem suporte no HoloLens.

public ref class CoreInputView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreInputView final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreInputView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreInputView
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView
Public NotInheritable Class CoreInputView
Herança
Object Platform::Object IInspectable CoreInputView
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Comentários

A exibição primária refere-se a uma das exibições CoreInputViewKind.Keyboard ou CoreInputViewKind.Handwriting , enquanto CoreInputView pode ser qualquer um dos valores de CoreInputViewKind.Handwriting.

Usado apenas por estruturas (como XAML) ou controles de texto personalizados.

Seu aplicativo pode usar as informações expostas por esse objeto para ajustar e refluxar sua interface do usuário para considerar qualquer oclusão.

As APIs CoreInputView dão suporte aos seguintes tipos de painéis de entrada.

  • SIP (Painel de Entrada Suave) encaixado, como o teclado virtual e o painel de manuscrito – normalmente, a interface do usuário do aplicativo é reflowada.
  • Barra de ferramentas flutuante ou SIP – normalmente, a interface do usuário do aplicativo não é refluxo.
  • Painéis de sobreposição, como tinta embutida ou janelas candidatas ao IME, normalmente, a interface do usuário do aplicativo não é refluxo para o controle de edição, mas é refluxo para as sugestões de texto/pesquisa.

O painel de entrada é exibido quando o usuário executa uma ação que exige que ele forneça informações, como inserir um campo de texto.

Por padrão, o Windows manipula eventos do painel de entrada e reposiciona o conteúdo para que os usuários possam ver o controle com foco. Se você definir CoreTextEditContext.InputPaneDisplayPolicy como Manual em seu aplicativo, será responsável por mostrar e ocultar o painel de entrada usando TryShowPrimaryView e TryHidePrimaryView. Use essa classe para substituir o comportamento padrão e personalizar o painel de entrada.

Chame GetForCurrentView para obter um objeto CoreInputView.

Depois que você se registrar para receber notificações do painel de entrada, o sistema chamará seu delegado de eventos sempre que o painel for 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 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
1803 17134 TryTransferXYFocusToPrimaryView
1803 17134 XYFocusTransferredToPrimaryView
1803 17134 XYFocusTransferringFromPrimaryView
1809 17763 TryHide
1809 17763 TryShow
1809 17763 TryShow(CoreInputViewKind)
1903 18362 GetForUIContext
2004 19041 PrimaryViewHiding
2004 19041 PrimaryViewShowing

Métodos

GetCoreInputViewOcclusions()

Recupera uma referência a cada painel de entrada que está ocluindo o aplicativo no momento.

GetForCurrentView()

Recupera o objeto CoreInputView associado à janela atual.

GetForUIContext(UIContext)

Obtém um objeto CoreInputView associado à exibição que tem o identificador de contexto especificado.

IsKindSupported(CoreInputViewKind)

Obtém se o tipo de CoreInputView especificado tem suporte.

TryHide()

Tenta ocultar (se visível) o painel de entrada associado ao painel CoreInputView .

TryHidePrimaryView()

Tenta ocultar (se visível) o painel de entrada associado ao CoreInputView.

TryShow()

Tenta mostrar (se oculto) o painel de entrada associado ao CoreInputView.

TryShow(CoreInputViewKind)

Tenta mostrar (se oculto) o tipo de painel de entrada especificado associado ao CoreInputView.

TryShowPrimaryView()

Tenta mostrar (se oculto) o painel CoreInputView .

Esse método é um "melhor esforço" e garante apenas que o usuário tenha uma maneira de interagir com o controle focado. Para um SIP (Painel de Entrada Suave) encaixado, como o teclado virtual e o painel de manuscrito, o painel será mostrado somente se um teclado de hardware não estiver disponível.

TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)

Tenta mover o foco da interface do usuário do aplicativo para o painel de entrada.

Eventos

OcclusionsChanged

Ocorre quando um ou mais objetos CoreInputViewOcclusion alteram sua posição ou área de oclusão em resposta ao reposicionamento do painel de entrada associado ao CoreInputView.

PrimaryViewAnimationStarting

Animações no aplicativo que ocorrem em resposta à exibição ou ocultação da exibição primária CoreInputView .

PrimaryViewHiding

Ocorre antes que o painel de entrada associado ao CoreInputView esteja oculto (se visível).

PrimaryViewShowing

Ocorre antes que o painel de entrada associado ao CoreInputView seja mostrado (se oculto).

SupportedKindsChanged

Ocorre quando a coleção de exibições CoreInputViewKind com suporte para CoreInputView é alterada.

XYFocusTransferredToPrimaryView

Ocorre quando o foco é movido para o painel de entrada da interface do usuário do aplicativo.

XYFocusTransferringFromPrimaryView

Ocorre antes que o painel de entrada perca o foco e antes que um elemento de interface do usuário obtenha o foco.

Aplica-se a

Confira também