Share via

WritingBox Property

  • Article

WritingBox Property

Gets or sets the invisible writing area of the recognition guide in which writing can actually take place.

Declaration

[C++]

[C++]
[propget] HRESULT get_WritingBox(
    [out, retval] IInkRectangle **Rectangle);
[propput] HRESULT put_WritingBox(
    [in] IInkRectangle *Rectangle);

[Microsoft® Visual Basic® 6.0]

[Visual Basic]
Public Property Get WritingBox() As InkRectangle
Public Property Let WritingBox( _
    Rectangle As InkRectangle)

Property Value

InkRectangle The rectangular writing area of the guide box in ink space coordinates.

This property is read/write.

Return Value

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

The writing box provides a margin of error to users who write outside the drawn box—the lines that are physically drawn on the tablet screen within which users write. You can use the DrawnBox property to set the drawn box.

Example

[Visual Basic 6.0]

This Visual Basic 6.0 example .

[Visual Basic]
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