InkEdit (Clase)

Artículo
11/26/2008

Actualización: noviembre 2007

El control InkEdit le permite recopilar entradas manuscritas, reconocerlas y mostrarlas como texto. Este control le permite habilitar formularios inteligentes, que mejoran la precisión de la entrada de texto.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkEdit _
    Inherits RichTextBox
'Uso
Dim instance As InkEdit

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkEdit : RichTextBox

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkEdit : public RichTextBox

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkEdit extends RichTextBox

public class InkEdit extends RichTextBox

Comentarios

Este control es un supraconjunto del control RichTextBox. Le proporciona al control RichTextBox la capacidad de capturar, reconocer y mostrar entradas manuscritas.

Si una enumeración, método o propiedad del control RichTextBox no se documenta a continuación, no se invalida en el control InkEdit y se puede usar tal y como se describe en la documentación del control RichTextBox. En concreto, los valores y parámetros descritos como válidos únicamente con un control RichTextBox, como el campo de enumeración RichNoOleObjs, funcionan del mismo modo con el control InkEdit porque es un control RichTextBox.

Advertencia

Para evitar una pérdida de memoria debe llamar explícitamente al método Dispose en cualquier objeto InkEdit al que se haya asociado un controlador de eventos antes de que el objeto o el control estén fuera de ámbito.

El control InkEdit se puede usar con Windows Vista. El control InkEdit no se puede usar para representar la entrada manuscrita en Microsoft Windows 2000, Windows Server 2003 ni en ninguna edición de Windows XP que no sea Windows XP Tablet Edition. Puede especificar entradas manuscritas, aceptar movimientos o reconocer la escritura a mano únicamente bajo las siguientes condiciones:

La entrada manuscrita se puede especificar solamente si Windows XP Tablet Edition está instalado.
Los movimientos se pueden reconocer solamente si Windows XP Tablet Edition está instalado.
La escritura a mano se puede reconocer como texto si la escritura a mano se realizó en otra parte y si los reconocedores están presentes.

Si usa Windows 2000, Windows Server 2003 o alguna edición de Windows XP que no sea Tablet PC Edition, puede asignar los valores a las propiedades de ambiente del control InkEdit y copiar y pegar la entrada manuscrita en otras aplicaciones, pero el valor de su propiedad InkMode es Disabled.

La inserción de espacios inteligente solamente está disponible cuando se instala Windows XP Tablet PC Edition.

Los archivos con objetos Ink incrustados se pueden cargar y mostrar en cualquier edición de Windows XP (incluida Windows XP Tablet Edition) y en los sistemas que únicamente tengan instalado el SDK de Tablet PC. Sin embargo, los objetos Ink incrustados se pueden convertir en texto cuando está instalado Windows XP Tablet PC Edition.

Para obtener más información sobre los controles de entrada manuscrita, vea Ink Controls.

Para obtener información sobre qué subprocesos provocan determinados eventos, vea Threads on Which an Event Can Fire.

Para mejorar el rendimiento de la aplicación, elimine manualmente un control InkEdit cuando ya no lo necesite.

Nota de seguridad:
Si se usa en entornos de confianza parcial, esta clase y sus métodos necesitan el permiso SafeTopLevelWindows. Vea Security and Trust para obtener más información.

La versión administrada del control InkEdit incluye al control COM InkEdit. El constructor del control administrado InkEdit, el método Divide, la propiedad LineHeight, la propiedad RecognizerContext y la propiedad Strokes provocan una excepción Marshal.ThrowExceptionForHR si el control COM InkEdit devuelve un error. Vea los temas InkEdit Control Reference para obtener detalles sobre los errores que se pueden devolver.

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.TextBoxBase
          System.Windows.Forms.RichTextBox
            Microsoft.Ink.InkEdit

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.