CoreInputView Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 CoreInputViewPublic NotInheritable Class CoreInputView- Herança
- 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. |