Share via


Enabling Gestures Sample

This sample demonstrates how to enable and disable the Microsoft Windows XP Tablet PC Edition 2005 system-recognition of gestures.

To get samples and instructions for installing them

  • Do one or more of the following:

    • On the Help menu, click Samples.

      The Readme displays information about samples.

    • Visit the Visual Studio 2008 Samples Web site. The most recent versions of samples are available there.

    • Locate samples on the computer on which Visual Studio is installed. By default, samples and a Readme file are installed in drive:\Program Files\Microsoft Visual Studio 9.0\Samples\lcid. For Express editions of Visual Studio, all samples are located online.

For more information, see Visual Studio Samples.

Security noteSecurity Note:

This sample code is intended to illustrate a concept, and it shows only the code that is relevant to that concept. It may not meet the security requirements for a specific environment, and it should not be used exactly as shown. We recommend that you add security and error-handling code to make your projects more secure and robust. Microsoft provides this sample code "AS IS" with no warranties.

To view the sample documentation

  1. In Solution Explorer, double-click the Documentation folder.

  2. If you are using Visual Basic Express, right-click ReadMe.htm in the Documentation folder and then click View in Browser. If you are using another version of Visual Basic, double-click ReadMe.htm in the Documentation folder.

Demonstrates

Windows XP Tablet PC Edition 2005 provides system-level recognition of various traced gestures, ranging from basic geometric shapes (squares, circles, triangles, and so on) to proofreading symbols such as curlicues and chevrons. You can use the SetGestureStatus method of the InkOverlay class to enable or disable gesture recognition and fine-tune it.

This sample enumerates all the system gestures and populates a CheckedListBox with their names. When gestures are checked or unchecked, recognition of them is turned on or off. Some additional processing is required to handle the AllGestures and NoGestures commands.

The Gesture event is raised by InkOverlay as appropriate. The associated event arguments contain an array of Gestures together with their Id and Confidence levels.

Note

NoGesture is often passed with a higher Confidence than the hoped-for gesture. Therefore, you should use a loop similar to the one shown in this sample to iterate over the passed-in Gestures and confirm that the hoped-for gesture does in fact have a higher Confidence.

The array of returned Gestures is displayed in a Label.

This sample requires that the following be installed:

  • Visual Studio

  • Tablet PC Platform SDK

  • Windows XP Tablet PC Edition 2005

See Also

Reference

Programming the Tablet PC

Microsoft.Ink

Other Resources

Tablet PC Samples