CoreFrameworkInputView Clase

Definición

Proporciona marcos de interfaz de usuario con la capacidad de controlar eventos PrimaryViewAnimationStarting y OcclusionsChanged después de los eventos CoreInputViewPrimaryViewAnimationStarting y OcclusionsChanged correspondientes .

Esto permite a un marco controlar la visualizació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 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
Herencia
Object Platform::Object IInspectable CoreFrameworkInputView
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 11 (se introdujo en la versión 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v14.0)

Comentarios

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

El marco de trabajo puede usar la información expuesta por este objeto para ajustar y refluir la interfaz de usuario para tener en cuenta cualquier oclusión.

Las API CoreFrameworkInputView 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 sí 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.

Llame a CoreFrameworkInputView.GetForCurrentView para obtener un objeto CoreFrameworkInputView.

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 de primer plano cuando se llama al método CoreFrameworkInputView.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).

Métodos

GetForCurrentView()

Recupera el objeto CoreFrameworkInputView asociado a la ventana actual.

GetForUIContext(UIContext)

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

Eventos

OcclusionsChanged

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

PrimaryViewAnimationStarting

Animaciones de la aplicación que se producen en respuesta a la presentación u ocultación del panel de entrada asociado a CoreFrameworkInputView.

Se aplica a

Consulte también