RecognizerGuide.Columns 屬性

發行項
10/29/2008

取得或設定辨識輔助線方塊中的欄數。

命名空間： 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 都大於零時，會使用方塊式輸入。下表列出可能的輸入模式，以及針對每種模式的 Columns 和 Rows 屬性設定的值。

針對此輸入類型	將 Rows 屬性設定為	並將 Columns 屬性設定為
自由輸入	0	0
包含 1 行的垂直線式輸入	0	1
包含 n 行的垂直線式輸入	0	n
包含 1 行的水平線式輸入	1	0
包含 n 行的水平線式輸入	n	0
包含 1 個方塊的方塊式輸入	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;
}