CoreFrameworkInputView Classe

Definição

Namespace:

Windows.UI.ViewManagement.Core

Fornece estruturas de interface do usuário com a capacidade de manipular eventos PrimaryViewAnimationStarting e OcclusionsChanged após os eventos CoreInputViewPrimaryViewAnimationStarting e OcclusionsChanged correspondentes .

Isso permite que uma estrutura 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 CoreFrameworkInputView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreFrameworkInputView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreFrameworkInputView

Public NotInheritable Class CoreFrameworkInputView

Herança

Object Platform::Object IInspectable CoreFrameworkInputView

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 11 (introduzida na 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v14.0)

Comentários

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

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

As APIs CoreFrameworkInputView 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.

Chame CoreFrameworkInputView.GetForCurrentView para obter um objeto CoreFrameworkInputView.

Depois de se registrar para receber notificações do painel de entrada, o sistema chama o delegado de eventos sempre que o painel é mostrado ou oculto para a janela de primeiro plano quando você chama o método CoreFrameworkInputView.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).

Métodos

GetForCurrentView()	Recupera o objeto CoreFrameworkInputView associado à janela atual.
GetForUIContext(UIContext)	Obtém um objeto CoreFrameworkInputView associado à exibição que tem o identificador de contexto especificado.

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 CoreFrameworkInputView.
PrimaryViewAnimationStarting	Animações no aplicativo que ocorrem em resposta à exibição ou ocultação do painel de entrada associado ao CoreFrameworkInputView.

Confira também

• CoreInputView