Classe InkEdit

Articolo
10/29/2008

Aggiornamento: novembre 2007

Il controllo InkEdit consente di raccogliere l'input penna, di riconoscerlo e di visualizzarlo come testo. Questo controllo consente di attivare form intelligenti che migliorano l'accuratezza dell'input di testo.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkEdit _
    Inherits RichTextBox
'Utilizzo
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

Note

Questo controllo è un superset del controllo RichTextBox. Amplia il controllo RichTextBox con la funzionalità di acquisire, riconoscere e visualizzare l'input penna.

Se un'enumerazione, un evento, un metodo o una proprietà del controllo RichTextBox non viene documentato qui di seguito, significa che non ne viene eseguito l'override nel controllo InkEdit e che può essere utilizzato esattamente come descritto nella documentazione del controllo RichTextBox. In particolare, i valori e i parametri definiti validi solo con un controllo RichTextBox, ad esempio il campo di enumerazione RichNoOleObjs, funzionano in modo identico con il controllo InkEdit poiché si tratta di un controllo RichTextBox.

Avviso

Per evitare una perdita di memoria, è necessario chiamare in modo esplicito il metodo Dispose su qualsiasi oggetto InkEdit a cui è stato associato un gestore eventi, prima che l'oggetto esca dall'ambito.

Con Windows Vista è possibile utilizzare il controllo InkEdit. Non è possibile utilizzare il controllo InkEdit per eseguire il rendering dell'input penna in Microsoft Windows 2000, Windows Server 2003 e qualsiasi edizione di Windows XP diversa da Windows XP Tablet PC Edition. È possibile immettere input penna, accettare movimenti o riconoscere la grafia solo nelle condizioni seguenti:

L'input penna può essere immesso e riconosciuto solo se è installato Windows XP Tablet PC Edition.
I movimenti possono essere riconosciuti solo se è installato Windows XP Tablet PC Edition.
La grafia può essere riconosciuta come testo se ha avuto origine altrove e se sono presenti i sistemi di riconoscimento.

In caso di utilizzo di Windows 2000, Windows Server 2003 o qualsiasi altra edizione di Windows XP diversa da Tablet PC Edition, è possibile assegnare valori alle proprietà di ambiente del controllo InkEdit, nonché copiare e incollare l'input penna in altre applicazioni, tuttavia il valore della proprietà InkMode è Disabled.

L'inserimento intelligente di spazi è disponibile solo se è installato Windows XP Tablet PC Edition.

I file con gli oggetti Ink incorporati possono essere caricati e visualizzati in qualsiasi edizione di Windows XP (incluso Windows XP Tablet PC Edition) e sui sistemi in cui è stato installato solo Tablet PC SDK. Tuttavia, gli oggetti Ink incorporati possono essere convertiti in testo solo se è installato Windows XP Tablet PC Edition.

Per ulteriori informazioni sui controlli dell'input penna, vedere Ink Controls.

Per informazioni sui thread che generano eventi particolari, vedere Threads on Which an Event Can Fire.

Per migliorare le prestazioni dell'applicazione, eliminare manualmente un controllo InkEdit quando non è più necessario.

Nota sulla sicurezza:
Se utilizzati in attendibilità parziale, questa classe e tutti i relativi metodi richiedono l'autorizzazione SafeTopLevelWindows. Per ulteriori informazioni, vedere Security and Trust.

La versione gestita del controllo InkEdit esegue il wrapping del controllo InkEdit COM. Il costruttore del controllo InkEdit gestito, il metodo Divide, le proprietà LineHeight, RecognizerContext e Strokes genereranno tutti un'eccezione Marshal.ThrowExceptionForHR se il controllo InkEdit COM restituisce un errore. Per informazioni sugli errori che possono essere restituiti, vedere gli argomenti in InkEdit Control Reference.

Gerarchia di ereditarietà

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

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.