Export (0) Print
Expand All

Snipping Tool Support in Windows Vista

This topic describes how your application can specify what URL the Tablet PC Snipping Tool should obtain when capturing your application.

Specifying the URL via Registry Key

Snipping Tool allows users to capture a snip (screen shot) of any object on the screen and then annotate, save, or share the image. When the data is saved in HTML format, or when it is sent to an email client that supports inline HTML, Snipping Tool can add a URL to the snip if the application provides information on how to obtain the URL.

Snipping Tool obtains the URL via accessibility objects. Applications should specify the necessary information under the following registry keys:

HKLM\Software\Microsoft\Windows\TabletPC\Snipping Tool\LinkFingerprints,

And should create a subkey whose name is the same as the window class from which the link should be obtained. The window class name should be the topmost window of the application.

HKLM\Software\Microsoft\Windows\TabletPC\Snipping Tool\LinkFingerprints\<Window Class Name>

Window Class Key Details

Under the window class key, the appropriate values should be set in order to indicate Snipping Tool should detect the correct accessibility object.

VALUETYPEMASKINFORMATION STORED

Mask

REG_DWORD

Indicates which of the following fields to check

Name

REG_SZ

0x02

Accessibility name

Description

REG_SZ

0x04

Accessibility description

Role

REG_DWORD

0x08

Accessibility role

ParentName

REG_SZ

0x10

Accessibility name of parent

ParentValue

REG_SZ

0x20

Accessibility value of parent

ParentRole

REG_DWORD

0x40

Accessibility role of parent

ParentDescription

REG_SZ

0x80

Accessibility description of parent

 

Additionally, if the mask bit value 0x1 is set, then the URL should be taken from the accessibility name; otherwise, the URL should be taken from the accessibility value.

If the application uses localized strings for the REG_SZ values above, the string should be provided as an indirect string by using the following format:

@filename,resource

The string is extracted from the file named, using the resource value as a locator. If the resource value is zero or greater, the number becomes the index of the string in the binary file. If the number is negative, it becomes a resource identifier (ID).

Note  Role constants can be found in oleacc.h in the Windows SDK. The registry values described are specific to Windows Vista.

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2014 Microsoft