Proprietà RecognizerContext.Guide

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta l'oggetto RecognizerGuide da utilizzare per l'input penna.

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

Sintassi

'Dichiarazione
Public Property Guide As RecognizerGuide
'Utilizzo
Dim instance As RecognizerContext
Dim value As RecognizerGuide

value = instance.Guide

instance.Guide = value

public RecognizerGuide Guide { get; set; }

public:
property RecognizerGuide Guide {
    RecognizerGuide get ();
    void set (RecognizerGuide value);
}

/** @property */
public RecognizerGuide get_Guide()
/** @property */
public  void set_Guide(RecognizerGuide value)

public function get Guide () : RecognizerGuide
public function set Guide (value : RecognizerGuide)

Valore proprietà

Tipo: Microsoft.Ink.RecognizerGuide
RecognizerGuide da utilizzare per l'input penna.

Note

L'impostazione della proprietà Guide ha esito positivo solo se la proprietà Strokes è nullriferimento null (Nothing in Visual Basic). È necessario impostare la proprietà Guide prima di associare un insieme Strokes alla proprietà Strokes dell'oggetto RecognizerContext oppure è necessario impostare la proprietà Strokes su nullriferimento null (Nothing in Visual Basic) e successivamente impostare la proprietà Guide.

Nota

Se si utilizza quest'ultimo metodo, potrebbe essere necessario riassociare l'insieme Strokes alla proprietà Strokes dell'oggetto RecognizerContext.

L'enumerazione RecognizerCapabilities contiene i flag FreeInput, LinedInput e BoxedInput. Questi flag specificano le funzionalità di un sistema di riconoscimento, ma poiché sono di sola lettura, non è possibile impostarle direttamente su un oggetto Recognizer o RecognizerContext. L'unico modo per impostare un sistema di riconoscimento su una modalità specifica consiste nell'impostare la guida di riconoscimento tramite la proprietà Guide.

Se non si imposta la proprietà Guide, il valore predefinito è la modalità FreeInput, presupponendo che sia supportata dal sistema di riconoscimento.

Nella tabella seguente sono elencate le potenziali modalità di input e i valori in base ai quali impostare le proprietà Columns e Rows per ogni modalità.

Per questo tipo di input	Impostare la proprietà Rows su	Inoltre, impostare la proprietà Columns su
Input libero	0	0
Input allineato verticale con 1 riga	0	1
Input allineato verticale con n righe	0	n
Input allineato orizzontale con 1 riga	1	0
Input allineato orizzontale con n righe	n	0
Input boxed con 1 casella	1	1
Input boxed con n caselle	n	1
Input boxed in una griglia di caselle di X righe e Z colonne	X	Z

Se la modalità impostata non è quella disponibile per un oggetto Recognizer, viene generata un'eccezione ArgumentException.

Per eseguire una query per conoscere le funzionalità, o le modalità, disponibili in un sistema di riconoscimento specifico, utilizzare la proprietà Capabilities dell'oggetto Recognizer. In Windows Vista, i sistemi di riconoscimento dei caratteri latini supportano l'input libero, l'input boxed e l'input allineato orizzontale; i sistemi di riconoscimento dei caratteri dell'Asia orientale supportano l'input libero e l'input boxed; il sistema dei riconoscimento dei movimenti supporta solo l'input libero.

Esempi

In questo esempio viene creata un'istanza di un oggetto RecognizerContext e viene assegnata la proprietà Guide.

' create a new RecognizerContext object
mRecognizerContext = New RecognizerContext()
' if the Recognizer supports LinedInput, set the Guide
If (mRecognizerContext.Recognizer.Capabilities And RecognizerCapabilities.LinedInput) <> 0 Then
    ' get the lower right corner in pixel units
    Dim lowerRight As Point = New Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height)
    ' convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(Me.CreateGraphics(), lowerRight)
    ' create Rectangles
    Dim writingBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    Dim drawnBox As Rectangle = New Rectangle(0, 0, lowerRight.X, lowerRight.Y)
    ' shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100)
    ' create Guide with 8 rows, zero columns, and no midline
    Dim guide As RecognizerGuide = New RecognizerGuide(8, 0, 0, writingBox, drawnBox)
    mRecognizerContext.Guide = guide
End If

// create a new RecognizerContext object
mRecognizerContext = new RecognizerContext();
// if the Recognizer supports LinedInput, set the Guide
if ((mRecognizerContext.Recognizer.Capabilities & RecognizerCapabilities.LinedInput) != 0)
{
    // get the lower right corner in pixel units
    Point lowerRight = new Point(mInkOverlay.AttachedControl.Width, mInkOverlay.AttachedControl.Height);
    // convert to ink space units
    mInkOverlay.Renderer.PixelToInkSpace(this.CreateGraphics(), ref lowerRight);
    // create Rectangles
    Rectangle writingBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    Rectangle drawnBox = new Rectangle(0, 0, lowerRight.X, lowerRight.Y);
    // shrink drawn box relative to writing box
    drawnBox.Inflate(-100, -100);
    // create Guide with 8 rows, zero columns, and no midline
    RecognizerGuide guide = new RecognizerGuide(8, 0, 0, writingBox, drawnBox);
    mRecognizerContext.Guide = guide;
}

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.