Compartir a través de


CoreFrameworkInputView Clase

Definición

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

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 se mueve, muestra u oculta el panel 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 suave acoplado (SIP) como el teclado táctil y el panel de escritura a mano, normalmente, los flujos de interfaz de usuario de la aplicación.
  • Barra de herramientas flotante o SIP: normalmente, la interfaz de usuario de la aplicación no cambia de flujo.
  • Paneles de superposición, como las 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 proporcione 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 del panel de entrada, el sistema llama al delegado de eventos cada vez que se muestra o oculta el panel para la ventana en 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 CoreInputViewOcclusion objetos cambian su posición o área de oclusión en respuesta a la reposición del panel de entrada asociado al CoreFrameworkInputView.

PrimaryViewAnimationStarting

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

Se aplica a

Consulte también