Customizing Contact Visualizations

The Microsoft Surface software uses generalized visual feedback called contact visualizations to subtly reinforce to users that they have successfully touched the Microsoft Surface screen. Contact visualizations make it clear to the user that their touch contact was received by the system. The following illustration shows two examples of contact visualizations. (The red lines are part of the Surface Simulator tool, not the contact visualizations.)

Example contact visualizations

For example, if a user tries to drag an object beyond a certain location, the Microsoft Surface software displays visualizations that are designed to inform the user that the system is aware that the user is trying to do something, instead of just ignoring additional attempts to move the object in that direction.

Certain default Microsoft Surface controls (such as buttons) include contact visualizations automatically. Developers can remove these default contact visualizations, change the colors of the visualizations, and implement contact visualizations in their Microsoft Surface applications. For more information, see the Microsoft Surface SDK Help documentation.

Disabling Contact Visualizations for Microsoft Surface Applications

On each Microsoft Surface unit, you can disable contact visualizations on an application-by-application basis.

To disable contact visualizations for a specific application on a Microsoft Surface unit

  1. Create a text file named ApplicationName.exe.config, where ApplicationName is the unique name of the application. (This name is the same name that is used as part of the application's XML registration file: ApplicationName.xml.)

    If an .exe.config file already exists for your application, add the SupportsContactVisualizations value that is described in this procedure to the existing .exe.config file instead of creating a new file.

  2. Add a key called SupportsContactVisualizations with a value of False to the file, as in the following code example.

              <add key="SupportsContactVisualizations" value="False" />
  3. Save the file and put it in the same directory as the executable file for the application.

    Contact visualizations are disabled the next time that the application is started.

You can activate and deactivate contact visualizations for this application by changing the value of the SupportsContactVisualizations key to True or False.

Did you find this information useful? Please send us your suggestions and comments.

© 2009 Microsoft Corporation. All rights reserved.

Community Additions