InputPane 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í.
Permite a una aplicación recibir notificaciones cuando el teclado táctil acoplado o el Panel de entrada temporal (SIP) está a punto de mostrarse u ocultarse, y para determinar qué parte de la ventana de la aplicación está oculta por el panel de entrada.
Nota
Las API InputPane proporcionan información precisa de oclusión solo para un panel acoplado. Para Windows 10 Creators Fall Update y versiones más recientes, se recomienda usar las siguientes API para controlar la oclusión mediante paneles de entrada acoplados, no acoplados, desplazables y transitorios, como paneles de entrada suaves (SIP), ventanas candidatas del Editor de métodos de entrada (IME), barras de herramientas flotantes, etc.
public ref class InputPane sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPanePublic NotInheritable Class InputPane- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
El panel de entrada aparece cuando el usuario realiza una acción que requiere que escriban información, como seleccionar un campo de entrada 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 dónde están escribiendo. Si estableces CoreTextEditContext.InputPaneDisplayPolicy en Manual en tu aplicación, eres responsable de mostrar y ocultar el panel de entrada mediante TryShow y TryHide. Use esta clase para invalidar el comportamiento predeterminado y personalizar el panel de entrada.
En algunos casos, la interfaz de usuario de superposición como inputPane no es totalmente compatible. Esto incluye:
- aplicaciones en modo de pantalla completa, como juegos.
- Aplicaciones de Windows Holographic en la vista holográfica.
Llame a GetForCurrentView para obtener un objeto InputPane.
Después de registrarse para recibir notificaciones de panel de entrada, el sistema llama al delegado de eventos cada vez que se muestra u oculta el panel de entrada para la ventana que estaba visible cuando llamó 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 |
|---|---|---|
| 1903 | 18362 | GetForUIContext |
Propiedades
| OccludedRect |
Obtiene la región de la ventana de la aplicación oculta por el panel de entrada. |
| Visible |
Obtiene o establece un valor que indica si se muestra el panel de entrada. Importante Válido solo para la familia de dispositivos Xbox. En el caso de las aplicaciones universales, la propiedad OccludedRect indica la región de la ventana de la aplicación obstruida por el panel de entrada. |
Métodos
| GetForCurrentView() |
Obtiene el objeto InputPane asociado a la ventana de la aplicación que está visible actualmente. |
| GetForUIContext(UIContext) |
Obtiene el objeto InputPane asociado a la vista con el identificador de contexto especificado. |
| TryHide() |
Intenta ocultar el panel de entrada, si está visible. |
| TryShow() |
Intenta mostrar el Panel de entrada, si está oculto. Este método es un "mejor esfuerzo" y garantiza solo que el usuario tiene una manera de escribir texto en el control centrado. El teclado táctil o el Panel de entrada temporal (SIP) solo se muestra si un teclado de hardware no está disponible. |
Eventos
| Hiding |
Se produce cuando el panel de entrada comienza a deslizarse fuera de la vista. |
| Showing |
Se produce cuando el panel de entrada comienza a deslizarse en la vista. |