RecognizerGuide.Columns Property

Article
12/12/2007

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

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in microsoft.ink.dll)

Syntax

'Declaration
Public Property Columns As Integer
'Usage
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)

Not applicable.

Property Value

The number of columns in the guide box.

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 properties 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 1 column of n boxes	1	n
Boxed input in a grid of boxes x rows by z columns	x	z

Example

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;
}

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

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

Share via