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.
| VALUE | TYPE | MASK | INFORMATION 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.