RecognizerGuide.Columns 属性

项目
10/28/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
具有 1 列 n 个框的框式输入	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;
}