Note: This sample is part of a large collection of UWP feature samples. If you are unfamiliar with Git and GitHub, you can download the entire collection as a ZIP file, but be sure to unzip everything to access shared dependencies. For more info on working with the ZIP file, the samples collection, and GitHub, see Get the UWP samples from GitHub. For more samples, see the Samples portal on the Windows Dev Center.
Specifically, this sample covers using the Windows.UI.Input.Inking APIs to:
- Render ink strokes
- Save and load ink strokes
- Copy and paste ink strokes
- Select ink strokes
- Delete ink strokes
- Recognize handwriting from ink strokes
- Search for a string within recognition results
- Obtain the InkPresenter for a canvas
Note Read the following instructions before using the app.
Draw ink strokes with a tablet pen.
The toolbar contains color pickers, line selectors, and other functions.
In Erase mode, a stroke deletes all strokes that it touches. If the pen has an eraser, it erases strokes (switching back to the pen tip exits erase mode).
In Select mode, a stroke selects all strokes that it encompasses. Exit Select mode by choosing another function on the toolbar.
Note Ink color or width is applied to all selected strokes and highlight color or width is applied to all selected highlights.
In Recognition mode, all (or only selected) strokes are processed through handwriting recognition. After recognition has completed:
- View the primary text candidate(s) at the bottom of the app.
- Tap on a word to show all text candidates for that word.
- Use Find to search for a string within the recognition results.
Delete all strokes (or only selected strokes) by pressing the Erase button.
Additional commands include:
- Use Copy to copy selected strokes onto the clipboard.
- Use Paste to paste strokes from the clipboard.
- Use Save and Load to read and write Ink Serialized Format (ISF) files to the Libraries or Pictures folder or both.
All buttons and menu choices can be activated with mouse, pen, or touch.
To obtain information about Windows 10 development, go to the Windows Dev Center
To obtain information about Microsoft Visual Studio and the tools for developing Windows apps, go to Visual Studio
Operating system requirements
Client: Windows 10
Server: Windows Server 2016 Technical Preview
Phone: Windows 10
Build the sample
- If you download the samples ZIP, be sure to unzip the entire archive, not just the folder with the sample you want to build.
- Start Microsoft Visual Studio 2017 and select File > Open > Project/Solution.
- Press Ctrl+Shift+B, or select Build > Build Solution.
Run the sample
To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.