Programación del panel de entrada mediante la clase PenInputPanel

  • Artículo

[PenInputPanel se ha reemplazado por Microsoft.Ink.TextInput. Consulte Programación del Panel de entrada de texto.]

Descripción del uso del objeto PenInputPanel para programar el panel de entrada del pc tablet de nivel de sistema.

Panel de entrada frente al objeto PenInputPanel

En la versión 1.0 de Microsoft Windows XP Tablet PC Edition, el Panel de entrada de pc tablet de nivel del sistema proporciona un mecanismo universal para realizar la entrada de texto en la plataforma Windows, pero no proporciona acceso mediante programación. En windows XP Tablet PC Edition Software Development Kit (SDK) versión 1.5 y posteriores, el objeto PenInputPanel permite integrar herramientas de entrada de texto directamente en las aplicaciones y proporcionar un nivel de control no disponible anteriormente. A partir de Windows XP Tablet PC Edition 2005, el Panel de entrada de nivel de sistema se ha actualizado para incluir la funcionalidad de entrada local proporcionada por el objeto PenInputPanel y mucho más.

En el gráfico siguiente se muestra el Panel de entrada que se muestra sobre el ejemplo de ejemplo de formulario de notificaciones automáticas .

panel de entrada que se muestra sobre un formulario usado para las notificaciones de automóviles

El Panel de entrada sustituye el PenInputPanel proporcionando la misma funcionalidad de entrada local a cualquier aplicación que se ejecute en Windows XP Tablet PC Edition 2005 o posterior sin necesidad de código adicional. Este artículo sobre el uso del objeto PenInputPanel se proporciona para la compatibilidad con versiones anteriores. Las aplicaciones que ya usan el objeto PenInputPanel funcionarán igual, excepto que el Panel de entrada se mostrará en lugar de PenInputPanel cuando la aplicación se ejecute en Windows XP Tablet PC Edition 2005 o posterior.

Si está desarrollando una nueva aplicación para el pc tablet y desea tener una solución de entrada de usuario local, el Panel de entrada proporciona esto automáticamente en Windows XP Tablet PC Edition 2005 o posterior. No es necesario crear instancias del objeto PenInputPanel .

Deshabilitación del panel de entrada

Puede haber casos en los que quiera deshabilitar el Panel de entrada. Hay dos maneras de lograrlo. Puede hacerlo mediante programación o estableciendo una entrada del Registro que deshabilite el Panel de entrada para toda la aplicación.

Deshabilitar el panel de entrada mediante programación

Para deshabilitar el Panel de entrada mediante programación, cree una instancia de PenInputPanel y establezca su propiedad AutoShow en False.

using Microsoft.Ink;

// ...

private PenInputPanel theInputPanel;

// ...

private void Form1_Load(object sender, System.EventArgs e)
{
// Attach the Input Panel to a specific TextBox control.
theInputPanel = new PenInputPanel(textBox1);

// Disable the Input Panel for the TextBox.
theInputPanel.AutoShow = false;
}

Para deshabilitar el Panel de entrada para varios controles de una sola aplicación, cree una instancia de un objeto PenInputPanel para cada control y establezca la propiedad AutoShowen False para cada uno o cree una instancia de un único PenInputPanel y muévalo del control a medida que cambia el foco de entrada. Para obtener más información sobre estas dos técnicas, vea el tema PenInputPanel Sample .

Deshabilitar el panel de entrada a través del Registro

Puede establecer una entrada del Registro para deshabilitar el Panel de entrada para toda la aplicación. Sin embargo, esto también lo deshabilitará para cuadros de diálogo comunes, como el cuadro de diálogo Abrir archivo , el cuadro de diálogo Imprimir y el cuadro de diálogo Guardar archivo . Esto puede hacer que la experiencia del usuario en la aplicación sea incoherente con otras aplicaciones tablet PC.

Establecer la DisableInPlace clave del Registro en cero impide que la interfaz de usuario (UI) del Panel de entrada aparezca en una aplicación. Debe colocar la clave del DisableInPlace Registro en HKEY_LOCAL_MACHINE\Software\Microsoft\TabletTip\. A continuación, agregue un nuevo valor del Registro mediante la ruta de acceso completa de la aplicación en la que desea deshabilitar el Panel de entrada. En la entrada del Registro de ejemplo siguiente se deshabilita el Panel de entrada en una aplicación denominada MyApp:

[HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\WindowsNT\TabletTIP\DisableInPlace]``"C:\Program Files\My App\MyApp.exe"=dword:00000000

Si sigue viendo un problema en la aplicación después de deshabilitar la interfaz de usuario del Panel de entrada, puede que sea necesario deshabilitar el marco subyacente, que consulta la aplicación para la ubicación del símbolo de intercalación. Por ejemplo, el Panel de entrada puede exponer un error en el código de seguimiento de intercalación de la aplicación. Desactivar la consulta de seguimiento de intercalación también impide que aparezca la interfaz de usuario del Panel de entrada. Para deshabilitar el marco, establezca la clave del EnableCaretTracking Registro en cero. Busque esta clave en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WindowsNT\CurrentVersion\AppCompatFlags\CaretTracking\.

Nota

Las herramientas de accesibilidad y la tecnología de voz de Windows XP también usan este marco, por lo que deshabilitar la consulta también deshabilita estas características en la aplicación.

 

Panel de entrada y páginas web

Para usar una API en una página web, debe funcionar en un entorno de confianza parcial. Todos los miembros de la clase PenInputPanel requieren plena confianza, excepto lo siguiente:

Estas API funcionan en un entorno de confianza parcial, como una página web, lo que le permite crear instancias de un objeto PenInputPanel , adjuntarlo a un control y deshabilitar el Panel de entrada para ese control. Para obtener más información, vea Programar el panel de entrada mediante la clase PenInputPanel y la entrada de lápiz en la Web.

El objeto PenInputPanel

En el resto de este tema se describe cómo usar el objeto PenInputPanel en las aplicaciones habilitadas para tablet PC. Más concretamente, este tema hace referencia al objeto PenInputPanel al analizar el objeto de programación, el panel de entrada del lápiz al hacer referencia al elemento de la interfaz de usuario y el Panel de entrada de PC (o Panel de entrada) al hacer referencia al panel de entrada global que normalmente se encuentra en el lado de la pantalla tablet PC.

En las secciones siguientes se describe el objeto PenInputPanel y la interfaz de usuario.