IInkRecognizerGuide::get_Columns method (msinkaut.h)

Article
02/22/2024

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

This property is read/write.

Syntax

HRESULT get_Columns(
  long *Units
);

Parameters

Units

Return value

None

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

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	msinkaut.h
Library	InkObj.dll