CoreInputView Clase

Definición

Espacio de nombres:

Windows.UI.ViewManagement.Core

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

Herencia

Object Platform::Object IInspectable CoreInputView

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Consulte también

• CoreFrameworkInputView