InkPicture Control

InkPicture Control

Reference topic for InkPicture control for the Tablet PC.

The InkPicture control allows you to easily place an image (.jpg, .bmp, .png, or .gif format) in an application that users can add ink to. It is intended for scenarios in which ink does not need to be recognized as text, but are stored as ink.

Users add ink to a transparent layer using a pen. Users can re-size an InkPicture window without losing any ink information, even if the ink is cropped when re-sizing.

The InkPicture control includes basic printing support; however, it is up to you to implement print preview or other advanced printing capabilities.

The .NET implementation of InkPicture inherits from the PictureBox Leave Site class.

By default, ink is colored black if not in high-contrast mode; otherwise, it is set to the current Color.WindowText Leave Site (COLOR_WINDOWTEXT) value. Also by default FitToCurve is False.

Within the InkPicture control, use the Ink object to load and save ink.

Note: When EditingMode = Delete or EditingMode = Select, other events (such as InkAdded, InkDeleted, and Stroke) are triggered. These events are useful if you want to implement your own delete or select modes.

For detailed reference information about the InkPicture control, see InkPicture Control Reference.

The following sections detail the use of the InkPicture control: