DrawnBox Property

Returns or sets the box that is physically drawn on the tablet's screen and in which writing takes place.

Declaration

[C++]

[propput] HRESULT put_DrawnBox ([in] InkRectangle* DrawnBox);
[propget] HRESULT get_DrawnBox ([out, retval] InkRectangle** DrawnBox);

[Microsoft® Visual Basic® 6.0]

Public Property Get DrawnBox() As InkRectangle
Public Property Let DrawnBox(ByVal theBox As InkRectangle)

Property Value

InkRectangle Returns or sets a rectangle that is relative to the top left of the writing box.

This property is read/write.

Return Value

Remarks

The lines of the drawn box are visual cues that specify where writing can take place. The user normally writes within the boundaries of the lines.

Another box, the writing box, is the invisible box in which writing can actually take place. It is larger than the drawn box and provides a margin of error to users if they draw ink outside the lines of the drawn box. You can use the WritingBox property to set the writing box.

The writing box specifies the boundaries of the ink to the recognizer. The drawn box is drawn using ink space units, relative to the top left of the writing box.

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

• InkRecognizerGuide Class

Related Topics

• InkRecognizerGuide::WritingBox Property