Classe InkRecognizerGuide
Aggiornamento: novembre 2007
Rappresenta l'area utilizzata dall'oggetto InkRecognizer in cui è possibile disegnare l'input penna. Quest'area è nota come recognizer guide.
Spazio dei nomi: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)
Sintassi
'Dichiarazione
Public Class InkRecognizerGuide
'Utilizzo
Dim instance As InkRecognizerGuide
public class InkRecognizerGuide
public ref class InkRecognizerGuide
public class InkRecognizerGuide
public class InkRecognizerGuide
Note
L'oggetto InkRecognizerGuide può essere costituito da righe e colonne e offre al sistema di riconoscimento un contesto migliore nel quale eseguire il riconoscimento. Ad esempio, è possibile disegnare righe orizzontali sullo schermo di un utente, quasi come fosse un foglio a righe, per indicare dove deve essere eseguito l'input penna (questo tipo di guida sarebbe costituito solo da righe senza colonne). Se un utente scrive sulle righe anziché utilizzare arbitrariamente lo spazio, l'accuratezza del riconoscimento risulta migliorata. Ad esempio, lettere come "t" e "I" vengono riconosciute più facilmente quando viene utilizzata una guida per fornire il contesto all'input penna.
L'oggetto InkRecognizerGuide specifica i limiti entro cui può essere disegnato l'input penna definendo due rettangoli: la drawn box e la writing box. I limiti della casella disegnata sono indizi visivi mentre i limiti della casella di scrittura sono invisibili. Questi limiti specificano dove è possibile scrivere. L'utente di norma scrive entro i limiti delle righe visibili della casella disegnata. La casella disegnata viene specificata dalle proprietà DrawnBoxTop, DrawnBoxLeft, DrawnBoxBottom e DrawnBoxRight. Queste proprietà sono destinate solo all'utilizzo per il sistema di riconoscimento. La sola impostazione di questi elementi non disegna indizi visivi sullo schermo. È necessario disegnare gli indizi visivi tramite l'applicazione o il controllo.
La casella di scrittura è più grande della casella disegnata e fornisce agli utenti un margine di errore se disegnano l'input penna all'esterno delle righe della casella disegnata. La casella di scrittura viene specificata dalle proprietà WritingBoxTop, WritingBoxLeft, WritingBoxBottom e WritingBoxRight.
Oltre a disegnare righe sullo schermo per indicare agli utenti dove è possibile scrivere, è anche possibile disegnare celle in cui vengono scritti caratteri o parole. Questa operazione si chiama boxed input ed è utile per alcune lingue dell'Asia orientale. Per determinare se il sistema di riconoscimento supporta l'input boxed, chiamare la proprietà Capabilities dell'oggetto InkRecognizer.
Per impostazione predefinita tutti i valori di proprietà della guida sono impostati su 0 e quindi non è prevista alcuna guida. Per impostare la guida è necessario utilizzare le proprietà dell'oggetto InkRecognizerGuide.
Esempi
Con il codice seguente vengono impostati contemporaneamente tutti i valori nell'oggetto InkRecognizerGuide.
Dim guideBoxTop As Double = 0
Dim guideBoxBottom As Double = 50
Dim guideBoxLeft As Double = 0
Dim guideBoxRight As Double = 600
Dim WRITINGBOXMARGIN As Integer = 10
' Find the midline of the guide box.
Dim midline As Double = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop
theGuide.Rows = 1
theGuide.Columns = 0
theGuide.Midline = midline
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN
theGuide.DrawnBoxLeft = guideBoxLeft
theGuide.DrawnBoxTop = guideBoxTop
theGuide.DrawnBoxRight = guideBoxRight
theGuide.DrawnBoxBottom = guideBoxBottom
double guideBoxTop = 0;
double guideBoxBottom = 50;
double guideBoxLeft = 0;
double guideBoxRight = 600;
const int WRITINGBOXMARGIN = 10;
// Find the midline of the guide box.
double midline = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop;
theGuide.Rows = 1;
theGuide.Columns = 0;
theGuide.Midline = midline;
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN;
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN;
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN;
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN;
theGuide.DrawnBoxLeft = guideBoxLeft;
theGuide.DrawnBoxTop = guideBoxTop;
theGuide.DrawnBoxRight = guideBoxRight;
theGuide.DrawnBoxBottom = guideBoxBottom;
Gerarchia di ereditarietà
System.Object
System.Windows.Ink.InkRecognizerGuide
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.
Informazioni sulla versione
.NET Framework
Supportato in: 3.0
Vedere anche
Riferimenti
Spazio dei nomi System.Windows.Ink
Recognizer
RecognizerContext