RecognizerContext.Guide 속성

아티클
11/04/2008

업데이트: 2007년 11월

잉크 입력에 사용할 RecognizerGuide를 가져오거나 설정합니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Property Guide As RecognizerGuide
‘사용 방법
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)

속성 값

형식: Microsoft.Ink.RecognizerGuide
잉크 입력에 사용할 RecognizerGuide입니다.

설명

Strokes 속성이 nullNull 참조(Visual Basic의 경우 Nothing)인 경우에만 Guide 속성을 설정할 수 있습니다. Strokes 컬렉션을 RecognizerContext의 Strokes 속성에 연결하기 전에 Guide 속성을 설정하거나, Strokes 속성을 nullNull 참조(Visual Basic의 경우 Nothing)로 설정한 후에 Guide 속성을 설정해야 합니다.

참고

두 번째 메서드를 사용하는 경우 Strokes 컬렉션을 RecognizerContext의 Strokes 속성에 다시 연결해야 할 수 있습니다.

RecognizerCapabilities 열거형에는 FreeInput, LinedInput 및 BoxedInput 플래그가 포함됩니다. 이러한 플래그는 인식기의 기능을 지정하지만 읽기 전용이므로 Recognizer 또는 RecognizerContext 개체에서 이들 플래그를 직접 설정할 수는 없습니다. 인식기를 특정 모드로 설정하는 방법은 Guide 속성을 사용하여 인식 안내선을 설정하는 것뿐입니다.

Guide 속성을 설정하지 않으면 FreeInput 모드가 기본적으로 설정되며 인식기가 해당 모드를 사용할 수 있는 것으로 간주됩니다.

다음 표에서는 가능한 입력 모드 및 각 모드에서 Columns 및 Rows 속성에 설정할 값을 보여 줍니다.

입력 형식	Rows 속성에 설정할 값	Columns 속성에 설정할 값
자유 입력	0	0
1줄에 세로줄 입력	0	1
n개 줄에 세로줄 입력	0	n
1줄에 가로줄 입력	1	0
n개 줄에 가로줄 입력	n	0
상자 하나에 상자식 입력	1	1
상자 n개에 상자식 입력	n	1
x행 z열 크기의 상자 표에 상자식 입력	x	z

Recognizer 개체에 사용할 수 없는 모드로 설정하는 경우에는 ArgumentException 예외가 throw됩니다.

특정 인식기에서 사용할 수 있는 기능(모드)을 쿼리하려면 Recognizer 개체의 Capabilities 속성을 사용합니다. Windows Vista에서 라틴 문자 스크립트의 인식기는 자유 입력, 상자식 입력 및 가로줄 입력을 지원하고, 동아시아 문자의 인식기는 자유 입력과 상자식 입력을 지원하며, 제스처 인식기는 자유 입력만을 지원합니다.

예제

이 예제에서는 RecognizerContext 개체가 인스턴스화되고 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;
}