CoreInputView Classe

Definição

Namespace:

Windows.UI.ViewManagement.Core

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)]
/// [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)]
[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

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Confira também

• CoreFrameworkInputView