IInkRecognizerGuide::get_Columns method (msinkaut.h)
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 |