Suporte à ferramenta de captura no Windows Vista

Este tópico descreve como seu aplicativo pode especificar qual URL a Ferramenta de Captura de Tablet pc deve obter ao capturar seu aplicativo.

Especificando a URL por meio da Chave do Registro

A Ferramenta de Captura permite que os usuários capturem uma captura (captura de tela) de qualquer objeto na tela e, em seguida, anotem, salvem ou compartilhem a imagem. Quando os dados são salvos no formato HTML ou quando são enviados para um cliente de email que dá suporte a HTML embutido, a Ferramenta de Captura pode adicionar uma URL à captura se o aplicativo fornecer informações sobre como obter a URL.

A Ferramenta de Captura obtém a URL por meio de objetos de acessibilidade. Os aplicativos devem especificar as informações necessárias nas seguintes chaves do Registro:

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

E deve criar uma subchave cujo nome é o mesmo que a classe de janela da qual o link deve ser obtido. O nome da classe de janela deve ser a janela mais alta do aplicativo.

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

Detalhes da chave de classe de janela

Na chave de classe de janela, os valores apropriados devem ser definidos para indicar que a Ferramenta de Captura deve detectar o objeto de acessibilidade correto.

VALUE	TYPE	MÁSCARA	INFORMAÇÕES ARMAZENADAS
Mask	REG_DWORD		Indica quais dos campos a seguir marcar
Nome	REG_SZ	0x02	Nome da acessibilidade
Descrição	REG_SZ	0x04	Descrição da acessibilidade
Função	REG_DWORD	0x08	Função de acessibilidade
ParentName	REG_SZ	0x10	Nome de acessibilidade do pai
ParentValue	REG_SZ	0x20	Valor de acessibilidade do pai
ParentRole	REG_DWORD	0x40	Função de acessibilidade do pai
ParentDescription	REG_SZ	0x80	Descrição de acessibilidade do pai

 

Além disso, se o valor de bit de máscara 0x1 estiver definido, a URL deverá ser obtida do nome de acessibilidade; caso contrário, a URL deve ser obtida do valor de acessibilidade.

Se o aplicativo usar cadeias de caracteres localizadas para os valores de REG_SZ acima, a cadeia de caracteres deverá ser fornecida como uma cadeia de caracteres indireta usando o seguinte formato:

@filename,resource

A cadeia de caracteres é extraída do arquivo chamado , usando o valor do recurso como um localizador. Se o valor do recurso for zero ou maior, o número se tornará o índice da cadeia de caracteres no arquivo binário. Se o número for negativo, ele se tornará uma ID (identificador de recurso).

Observação

As constantes de função podem ser encontradas em oleacc.h no SDK do Windows. Os valores do Registro descritos são específicos do Windows Vista.