Share via

Rows Property

  • Article

Rows Property

Gets or sets the number of rows in the recognition guide.

Declaration

[C++]

[propput] HRESULT put_Rows ([in] long Rows);
[propget] HRESULT get_Rows ([out, retval] long* Rows);

[Microsoft® Visual Basic® 6.0]

Public Property Get Rows() As Long
Public Property Let Rows(ByVal theRows As Long)

Property Value

long The number of rows in the recognition guide.

This property is read/write.

Return Value

This property returns a signed 32-bit integer that specifies the number of rows in the recognizer guide.

HRESULT value Description
S_OK Success.
E_POINTER The context is invalid or the parameter is an invalid pointer.
E_INK_EXCEPTION An exception occurred inside the method.

Remarks

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

Use the values of the Columns and Rows properties to control the kind of recognition input that you use. When the Columns and Rows properties 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 Rows equal to Set Columns equal 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 y columns x z

Example

[Visual Basic 6.0]

This Visual Basic 6.0 example sets all of the values in the guide simultaneously.

Private Sub ResetGuideSettings( _
ByRef theRecognizerGuide As InkRecognizerGuide, _
ByVal columns As Integer, _
ByVal rows As Integer, _
ByVal midline As Integer, _
ByVal drawnBox As InkRectangle, _
ByVal writingBox As InkRectangle)
    theRecognizerGuide.columns = columns
    theRecognizerGuide.rows = rows
    theRecognizerGuide.midline = midline
    theRecognizerGuide.drawnBox = drawnBox
    theRecognizerGuide.writingBox = writingBox
End Sub

Applies To