Compartir a través de


CoreInputView Clase

Definición

Permite a una aplicación controlar la presentación de un panel de entrada acoplado, no acoplado, desplazable o transitorio (y interfaz de usuario asociada), recibir notificaciones cuando el panel se mueve, muestra u oculta, y para determinar qué parte de la ventana de la aplicación está oculta por el panel.

Nota:

No se admite en 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
Herencia
Object Platform::Object IInspectable CoreInputView
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Comentarios

La vista principal hace referencia a cualquiera de las vistas CoreInputViewKind.Keyboard o CoreInputViewKind.Handwriting , mientras que CoreInputView puede ser cualquiera de los valores de CoreInputViewKind.Handwriting.

Solo se usan en marcos (como XAML) o controles de texto personalizados.

La aplicación puede usar la información expuesta por este objeto para ajustar y refluir su interfaz de usuario para tener en cuenta cualquier oclusión.

Las API CoreInputView admiten los siguientes tipos de paneles de entrada.

  • Panel de entrada temporal acoplado (SIP), como el teclado táctil y el panel de escritura a mano , normalmente, la interfaz de usuario de la aplicación vuelve a flujos.
  • Barra de herramientas flotante o SIP: normalmente, la interfaz de usuario de la aplicación no se vuelve a flujo.
  • Paneles de superposición, como ventanas candidatas de entrada de lápiz o IME insertadas, normalmente, la interfaz de usuario de la aplicación no se vuelve a enviar para el control de edición, pero vuelve a aparecer para las sugerencias de texto o búsqueda.

El panel de entrada aparece cuando el usuario realiza una acción que requiere que proporcionen información, como escribir un campo de texto.

De forma predeterminada, Windows controla los eventos del panel de entrada y cambia la posición del contenido para que los usuarios puedan ver el control con foco. Si estableces CoreTextEditContext.InputPaneDisplayPolicy en Manual en tu aplicación, eres responsable de mostrar y ocultar el panel de entrada mediante TryShowPrimaryView y TryHidePrimaryView. Use esta clase para invalidar el comportamiento predeterminado y personalizar el panel de entrada.

Llame a GetForCurrentView para obtener un objeto CoreInputView.

Después de registrarse para recibir notificaciones de panel de entrada, el sistema llama al delegado de eventos cada vez que el panel se muestra u oculta para la ventana que estaba visible al llamar al método GetForCurrentView .

Nota:

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulta Subprocesos y serialización (C++/CX).

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
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 una referencia a cada panel de entrada que actualmente ocluye la aplicación.

GetForCurrentView()

Recupera el objeto CoreInputView asociado a la ventana actual.

GetForUIContext(UIContext)

Obtiene un objeto CoreInputView asociado a la vista que tiene el identificador de contexto especificado.

IsKindSupported(CoreInputViewKind)

Obtiene si se admite el tipo de CoreInputView especificado.

TryHide()

Intenta ocultar (si está visible) el panel de entrada asociado al panel CoreInputView .

TryHidePrimaryView()

Intenta ocultar (si está visible) el panel de entrada asociado a CoreInputView.

TryShow()

Intenta mostrar (si está oculto) el panel de entrada asociado a CoreInputView.

TryShow(CoreInputViewKind)

Intenta mostrar (si está oculto) el tipo de panel de entrada especificado asociado a CoreInputView.

TryShowPrimaryView()

Intenta mostrar (si está oculto) el panel CoreInputView .

Este método es un "mejor esfuerzo" y garantiza solo que el usuario tiene una manera de interactuar con el control centrado. Para un panel de entrada suave (SIP) acoplado, como el teclado táctil y el panel de escritura a mano, el panel solo se muestra si un teclado de hardware no está disponible.

TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)

Intenta mover el foco de la interfaz de usuario de la aplicación al panel de entrada.

Eventos

OcclusionsChanged

Se produce cuando uno o varios objetos CoreInputViewOcclusion cambian su posición o área de oclusión en respuesta a la reposición del panel de entrada asociado a CoreInputView.

PrimaryViewAnimationStarting

Animaciones de la aplicación que se producen en respuesta a la visualización u ocultación de la vista principal CoreInputView .

PrimaryViewHiding

Se produce antes de que el panel de entrada asociado a CoreInputView esté oculto (si está visible).

PrimaryViewShowing

Se produce antes de que se muestre el panel de entrada asociado a CoreInputView (si está oculto).

SupportedKindsChanged

Se produce cuando cambia la colección de vistas CoreInputViewKind admitidas para CoreInputView .

XYFocusTransferredToPrimaryView

Se produce cuando el foco se mueve al panel de entrada desde la interfaz de usuario de la aplicación.

XYFocusTransferringFromPrimaryView

Se produce antes de que el panel de entrada pierda el foco y antes de que un elemento de interfaz de usuario obtenga el foco.

Se aplica a

Consulte también