Registro da tecnologia adaptativa de facilidade de Acesso

Este artigo explica como registrar um aplicativo de acessibilidade com a Central de Facilidade de Acesso. Ele também explica como personalizar seu aplicativo de acessibilidade para que ele funcione bem com a área de trabalho segura.

A Central de Facilidade de Acesso é um aplicativo Painel de Controle para Microsoft Windows reúne funcionalidades para acessibilidade e facilidade de uso. Usando a Central de Facilidade de Acesso, os usuários podem configurar seus computadores para atender às suas necessidades físicas e cognitivas.

Uma função da Central de Facilidade de Acesso é ajudar os usuários a iniciar aplicativos de acessibilidade, incluindo Narrador, Teclado Virtual e Lupa. Os aplicativos de terceiros registrados também aparecem na Central de Facilidade de Acesso e podem ser iniciados diretamente a partir daí.

Os aplicativos de acessibilidade precisam funcionar sem problemas com a área de trabalho segura. A área de trabalho segura é a interface do usuário que aparece quando o computador está bloqueado (no logon ou quando o usuário bloqueou a área de trabalho) e quando o usuário é solicitado a permitir uma ação potencialmente não segura. Por motivos de segurança, o Windows impõe limites ao software de terceiros em execução na área de trabalho segura. Se você quiser que seu aplicativo de acessibilidade seja executado na área de trabalho segura, será necessário registrar o aplicativo na Central de Facilidade de Acesso.

Registrando-se com a Central de Facilidade de Acesso

Os aplicativos de acessibilidade se registram na Central de Facilidade de Acesso criando uma ou mais chaves do Registro quando o aplicativo é instalado. A tabela a seguir lista as informações contidas nas chaves do Registro.

Localização

Os valores do Registro de Nome do Aplicativo e Descrição precisam ser localizáveis para dar suporte à MUI (Interface do Usuário Multilíngue).

Essas cadeias de caracteres estão no formato a seguir, em que colchetes angulares significam elementos necessários e colchetes significam um elemento opcional.

@<ResDllPath\ResDLLFilename>,-<resID>[;< comentário>]

<ResDllPath\ResDLLFilename> é o caminho para a DLL do recurso. O caminho pode conter variáveis ambientais.

<resID> é a ID do recurso para a cadeia de caracteres.

[comentário] contém comentários opcionais.

Veja um exemplo:

@%SystemRoot%\system32\anyAT.dll,-5020

Para obter mais informações sobre MUI, consulte Centro de Conhecimento MUI do Windows.

Perfil HCI

O perfil HCI (Human Computer Interaction) é uma maneira de determinar quais acomodações fornecer com base nas necessidades do usuário. Os aplicativos de acessibilidade devem registrar informações sobre o tipo de deficiência que o aplicativo ajuda a acomodar.

O valor do Registro de perfil contém XML que descreve o tipo de deficiência direcionada pelo aplicativo de acessibilidade. Esse XML tem o seguinte formato:

<HCIModel>
<Accommodation type="disability"/>
</HCIModel>

Os valores válidos para o atributo Tipo de acomodação são os seguintes:

• visão leve
• visão severa
• cognitivo leve
• cognitivo grave
• destreza leve
• destreza grave
• audição leve
• audição severa
• fala suave
• fala severa

Se um aplicativo de acessibilidade der suporte a várias acomodações, o valor do Registro de perfil deverá incluir um atributo tipo acomodação para cada acomodação.

Detalhes do Registro de Facilidade de Acesso

Para registrar seu aplicativo de acessibilidade, você precisa criar uma chave para seu aplicativo no local do Registro a seguir e preenchê-la com pares nome-valor.

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\

Nomeie a chave do Registro do aplicativo usando o seguinte formato:

"CompanyName_ProductName_v#"

Por exemplo, "Contoso_Magnifier_v2.0".

Para adicionar valores de registro, seu programa de instalação deve estar em execução com privilégios elevados.

Acomodação segura da área de trabalho

A chave do Registro SecureDesktopAccommodation permite especificar como seu aplicativo de acessibilidade responde à área de trabalho segura. Por padrão, a Central de Facilidade de Acesso iniciará seu aplicativo na área de trabalho segura se ele já estiver em execução na área de trabalho normal ou se ele estiver configurado para ser executado na área de trabalho de logon. Usando a chave SecureDesktopAccommodation , você pode:

• Especifique uma versão alternativa do aplicativo para uso na área de trabalho segura. Por exemplo, você pode ter uma versão alternativa que desabilita recursos não seguros ou é otimizado para usar menos memória e iniciar mais rapidamente.

  Para especificar a versão alternativa, defina a chave SecureDesktopAccommodation como o nome da versão alternativa. Por exemplo, se você registrou seu aplicativo na chave Contoso_Screen Reader_v1.0, poderá registrar a versão alternativa em Contoso_Screen ReaderSecure_v1.0. Em seguida, defina a chave SecureDesktopAccommodation de Contoso_Screen Reader_v1.0 como "Contoso_Screen ReaderSecure_v1.0".

• Especifique um aplicativo de acessibilidade da Microsoft para usar na área de trabalho segura no lugar do aplicativo. Para essa opção, defina SecureDesktopAccommodation como o nome do aplicativo de acessibilidade da Microsoft específico: "osk", "lupa" ou "Narrador".

• Especifique que seu aplicativo não deve ser executado na área de trabalho segura e nenhum aplicativo alternativo deve ser executado. Para essa opção, defina SecureDesktopAccommodation como "none" (recomendação) ou o nome de um aplicativo inexistente.

Se a chave do Registro SecureDesktopAccommodation para seu aplicativo de acessibilidade especificar um aplicativo de acessibilidade da Microsoft a ser executado na área de trabalho segura no lugar do aplicativo, o Windows notificará o usuário sobre isso ao fazer a transição para a área de trabalho segura. Para notificar o usuário, o Windows exibe a cadeia de caracteres especificada na chave do Registro de Descrição do aplicativo. Por exemplo, se o aplicativo ScreenReader Deluxe 1.0 usar o Microsoft Narrador na área de trabalho segura, ele incluirá uma cadeia de caracteres de descrição, como "O Microsoft Narrador será usado nas áreas de trabalho bloqueadas, com logon e outras áreas de trabalho seguras no lugar do ScreenReader Deluxe 1.0".

Se a chave SecureDesktopAccommodation do aplicativo estiver definida como "nenhum", use a chave Descrição para informar ao usuário que seu aplicativo não está disponível na área de trabalho segura e nenhuma alternativa será fornecida.

O Windows exibe o texto Descrição nos locais relevantes na Central de Facilidade de Acesso.

Em execução na instalação e na área de trabalho de logon

Se você acrescentar o nome da chave registrada do aplicativo de acessibilidade à cadeia de caracteres no local do registro a seguir, o Windows iniciará seu aplicativo imediatamente após a instalação. Além disso, o Windows executará automaticamente seu aplicativo sempre que a área de trabalho de logon estiver ativa.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\Accessibility\Configuration

A chave de configuração é uma cadeia de caracteres delimitada por vírgulas. Para adicionar seu aplicativo, acrescente uma cadeia de caracteres igual à chave do Registro do aplicativo em HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\.

Em execução em um trabalho

Se a chave do Registro TerminateOnDesktopSwitch não estiver presente ou estiver definida como diferente de zero, o Windows executará o aplicativo no contexto de um trabalho, encerrando e reiniciando o aplicativo a cada transição da área de trabalho. A execução em um trabalho garante que apenas uma única instância do aplicativo esteja em execução em um determinado momento e libera o aplicativo de ter que monitorar o estado da área de trabalho. As desvantagens de executar em um trabalho incluem:

• O aplicativo incorre em um custo de inicialização com cada transição da área de trabalho.
• O aplicativo só pode ser iniciado por meio do Centro de Facilidade de Acesso.
• O aplicativo deve salvar continuamente suas configurações porque ele pode ser encerrado a qualquer momento por uma transição de área de trabalho.

Se a chave TerminateOnDesktopSwitch existir e estiver definida como 0, o Windows não executará o aplicativo de acessibilidade em um trabalho. Tem estas vantagens:

• Nenhum custo de inicialização está associado a transições de área de trabalho.
• O aplicativo pode ser iniciado fora do Centro de Facilidade de Acesso.

As desvantagens de não executar em um trabalho incluem:

• Como o aplicativo não é reiniciado em transições de área de trabalho, ele deve detectar quando a área de trabalho atual está inativa e responder adequadamente. Por exemplo, o aplicativo deve abrir mão do controle de hardware para que a versão da área de trabalho segura do aplicativo possa usá-lo e o aplicativo deve entrar no modo de suspensão para evitar o uso de recursos do processador.
• Se o aplicativo puder ser iniciado por meio do menu Iniciar, do Windows Explorer ou da linha de comando, a Central de Facilidade de Acesso precisará ser informada. Para obter mais informações, consulte Tecla do logotipo do Windows + U.
• Como várias cópias do aplicativo podem ser executadas simultaneamente em áreas de trabalho diferentes, o aplicativo deve ser gravado para dar suporte a várias cópias em execução.

Tecla do logotipo do Windows + U

Se o aplicativo de acessibilidade estiver configurado para ser executado em um trabalho, o código de inicialização do aplicativo deverá incluir uma chamada para a função IsProcessInJob para determinar se o aplicativo está começando em um trabalho. Se estiver, o aplicativo deverá iniciar a Central de Facilidade de Acesso e, em seguida, sair. O exemplo a seguir mostra como chamar IsProcessInJob.

BOOL fAlreadyInJob;
BOOL fSuccess = IsProcessInJob(GetCurrentProcess(), NULL, &fAlreadyInJob); 

Se o aplicativo de acessibilidade estiver configurado para ser executado fora de um trabalho, ele deverá notificar a Central de Facilidade de Acesso de que o aplicativo está iniciando e continuar normalmente.

Independentemente de como o aplicativo está configurado, se ele fornecer uma maneira de sair de dentro do aplicativo, como um botão Fechar, o aplicativo deverá notificar a Central de Facilidade de Acesso que ele está saindo.

Um aplicativo notifica a Central de Facilidade de Acesso definindo uma chave temporária do Registro e, em seguida, injetando a combinação de teclas do Logotipo do Windows + U no fluxo de entrada.

O aplicativo deve criar a chave temporária no local a seguir.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\AccessibilityTemp

A chave temporária deve ter o mesmo nome que o nome do aplicativo registrado, como "Contoso_Screen Reader_v1.0". O valor da chave é um DWORD definido como 0x0003 quando está sendo iniciado ou 0x0002 quando o aplicativo está saindo.

INPUT input[4] = {0};

input[0].type = INPUT_KEYBOARD;
input[0].ki.wVk = VK_LWIN;
input[0].ki.dwFlags = 0;

input[1].type = INPUT_KEYBOARD;
input[1].ki.wVk = 0x55; // U key
input[1].ki.dwFlags = 0;

input[2].type = INPUT_KEYBOARD;
input[2].ki.wVk = 0x55; // U key
input[2].ki.dwFlags = KEYEVENTF_KEYUP;

input[3].type = INPUT_KEYBOARD;
input[3].ki.wVk = VK_LWIN;
input[3].ki.dwFlags = KEYEVENTF_KEYUP;

SendInput(ARRAYSIZE(input), input, sizeof(input[0]));

Tecla do logotipo do Windows + Aumento de Volume

Quando o usuário inicia seu aplicativo de acessibilidade pressionando a combinação de teclas do Logotipo do Windows + Tecla de Aumento de Volume (como em um dispositivo tablet), a Central de Facilidade de Acesso passa o seguinte argumento de linha de comando para o aplicativo:

/hardwarebuttonlaunch

Seu aplicativo pode usar esse argumento para determinar se deve iniciar normalmente ou ajustar o comportamento adequadamente.

Transferindo configurações de área de trabalho segura

Se o aplicativo de acessibilidade der suporte à área de trabalho segura, você poderá usar o Registro para copiar as configurações quando o aplicativo fizer a transição para a área de trabalho segura. Copiar configurações ajuda a fazer a transição para a área de trabalho segura mais perfeita para o usuário.

Para copiar as configurações, defina a chave do Registro CopySettingsToLockedDesktop do aplicativo como 1 e armazene as configurações no local do Registro a seguir.

HKCU\Software\Microsoft\Windows NT\CurrentVersion\Accessibility\ATConfig\<AT Key Name>

A Central de Facilidade de Acesso monitora esse local do Registro enquanto o aplicativo está em execução. Quando ocorre uma transição para a área de trabalho segura, a Central de Facilidade de Acesso copia as configurações para o mesmo local no hive HKCU da área de trabalho segura. Em seguida, o aplicativo pode ler as configurações e retomar seu estado.

Seu aplicativo de acessibilidade deve gravar suas configurações em intervalos regulares ou sempre que os valores forem alterados. A gravação de configurações na saída do aplicativo não funcionará. Se o aplicativo estiver em execução em um trabalho, ele será encerrado na transição para longe da área de trabalho segura, antes que o código de saída tenha a chance de ser executado. Se o aplicativo não estiver em execução em um trabalho, o aplicativo não será encerrado na transição para longe da área de trabalho segura.

Cuidado

Como as chaves do Registro descritas aqui são escritas no modo de usuário, elas não são seguras. Se o aplicativo de acessibilidade ler o conteúdo dessas chaves, ele deverá marcar cuidadosamente os dados e usá-los com cuidado. Especificamente, seu aplicativo deve fazer um limite marcar em valores DWORD, ter cuidado com comprimentos de cadeia de caracteres, não deve ler nomes de DLL de plug-in e não deve executar nenhum comando encontrado em cadeias de caracteres.

Exemplos do Registro

O exemplo a seguir mostra os possíveis valores do Registro para um produto fictício chamado Contoso ScreenReader versão 2.0, cujo nome localizado é armazenado como um recurso.

Os valores na tabela estão sob a seguinte chave:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Accessibility\ATs\Contoso_Screen Reader_v2.0

<HCIModel>
   <Accommodation type="low vision">
   <Accommodation type="severe vision">
   <Accommodation type="mild cognitive">
</HCIModel>

Se o aplicativo fornecer um leitor de tela e uma lupa de tela em um único executável, os valores do componente de leitor de tela poderão ter esta aparência:

<HCIModel>
   <Accommodation type="low vision">
   <Accommodation type="severe vision">
   <Accommodation type="mild cognitive">
</HCIModel>

Os valores para o componente de lupa estariam na seguinte chave:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Contosoibility\ATs\Contoso_Magnifier_v2.0

<HCIModel>
   <Accommodation type="mild vision">
</HCIModel>