Compartilhar via


CoreFrameworkInputView Classe

Definição

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

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.

Nota

Não há 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

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 Reversível) encaixado, como o teclado Touch e o painel de manuscrito – normalmente, a interface do usuário do aplicativo é refluxoada.
  • Barra de ferramentas flutuante ou SIP – normalmente, a interface do usuário do aplicativo não é refluxo.
  • Painéis de sobreposição, como janelas inline Ink ou IME candidate, normalmente, a interface do usuário do aplicativo não é refluxo para o controle de edição, mas é refluxado 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 de 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 que você se registrar para receber notificações do painel de entrada, o sistema chamará seu representante de eventos sempre que o painel for mostrado ou oculto para a janela de primeiro plano quando você chamou o método CoreFrameworkInputView.GetForCurrentView.

Nota

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 de 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 aoCoreFrameworkInputView.

Aplica-se a

Confira também