InputPane Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.ViewManagement
Editar

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 InputPane
Public NotInheritable Class InputPane
Herencia
Object Platform::Object IInspectable InputPane
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

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:

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.

Se aplica a

Consulte también