RecognizerGuide.Columns Property

  • Article

RecognizerGuide.Columns Property

Gets or sets the number of columns in the guide box.

Definition

Visual Basic .NET Public Property Columns As Integer
C# public int Columns { get; set; }
Managed C++ public: __property int* get_Columns();
public: __property void set_Columns(int*);

Property Value

System.Int32. The number of columns in the guide box.

This property is read/write. This property has no default value.

Remarks

Column width is determined by the size of the drawn box. To get or set the drawn box, use the DrawnBox property.

Use the values of Columns and Rows to control the kind of recognition input that you use. When Columns and Rows are both greater than zero, boxed input is used. The following table lists potential input modes and which values to set the Columns and Rows properties for each mode.

For this type of input Set the Rows property to And set the Columns property to
Free input 0 0
Vertical Lined input with 1 line 0 1
Vertical Lined input with n lines 0 n
Horizontal Lined input with 1 line 1 0
Horizontal Lined input with n lines n 0
Boxed input with 1 box 1 1
Boxed input with n boxes n 1
Boxed input in a grid of boxes x rows by z columns x z

Examples

[C#]

This C# example sets all of the values in the guide simultaneously.

private void ResetGuideSettings(
    ref RecognizerGuide theRecognizerGuide,
    int columns,
    int rows,
    int midline,
    Rectangle drawnBox,
    Rectangle writingBox)
{
    theRecognizerGuide.Columns = columns;
    theRecognizerGuide.Rows = rows;
    theRecognizerGuide.Midline = midline;
    theRecognizerGuide.DrawnBox = drawnBox;
    theRecognizerGuide.WritingBox = writingBox;
}

[Visual Basic .NET]

This Microsoft® Visual Basic® .NET example sets all of the values in the guide simultaneously.

Private Sub ResetGuideSettings( _
ByRef theRecognizerGuide As RecognizerGuide, _
ByVal columns As Integer, _
ByVal rows As Integer, _
ByVal midline As Integer, _
ByVal drawnBox As Rectangle, _
ByVal writingBox As Rectangle)
    theRecognizerGuide.Columns = columns
    theRecognizerGuide.Rows = rows
    theRecognizerGuide.Midline = midline
    theRecognizerGuide.DrawnBox = drawnBox
    theRecognizerGuide.WritingBox = writingBox
End Sub

See Also