CoreFrameworkInputView Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- 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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de