RecognizerGuide.Columns 속성

아티클
11/04/2008

업데이트: 2007년 11월

인식 안내선 상자에서 열의 수를 가져오거나 설정합니다.

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

구문

‘선언
Public Property Columns As Integer
‘사용 방법
Dim instance As RecognizerGuide
Dim value As Integer

value = instance.Columns

instance.Columns = value

public int Columns { get; set; }

public:
property int Columns {
    int get ();
    void set (int value);
}

/** @property */
public int get_Columns()
/** @property */
public  void set_Columns(int value)

public function get Columns () : int
public function set Columns (value : int)

속성 값

형식: System.Int32
안내선 상자의 열 수입니다.

설명

열 너비는 그려진 상자의 크기에 따라 결정됩니다. 그려진 상자를 가져오거나 설정하려면 DrawnBox 속성을 사용합니다.

사용하는 인식 입력 종류를 제어하려면 Columns 및 Rows 속성의 값을 사용합니다. Columns와 Rows가 모두 0보다 크면 상자식 입력이 사용됩니다. 다음 표에서는 가능한 입력 모드 및 각 모드에서 Columns 및 Rows 속성에 설정할 값을 보여 줍니다.

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

예제

이 예제에서는 RecognizerContext 개체를 인스턴스화하고 새 RecognizerGuide 개체를 만들어 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;
}