Extensão de comandos globais do NVDA - manual do usuário

Autor: paulber19 (paulber19@laposte.net)

URL: https://github.com/paulber19/NVDAExtensionGlobalPlugin.git

Download:

Compatibilidade:

Tradutor: Edilberto Fonseca, com auxílio do ChatGPT.

Índice

1. Introdução

1.1. Geral

Este add-on adiciona aos comandos globais do NVDA:

1.2. Menu de configuração do add-on

No submenu "Preferências" do NVDA, foi adicionado o submenu "ADDON\_SUMMARY" que oferece as seguintes opções, dependendo do caso:- sistematicamente o submenu "Configurações Globais" que abre uma caixa de diálogo semelhante à caixa de diálogo de "parâmetros" do NVDA e que apresenta as seguintes categorias:

Exceto pelo último menu, cada um está associado a um script sem gesto de entrada que permite ativá-lo. Com a caixa de diálogo "gestos de comandos" do NVDA, é possível atribuir um gesto a eles.

São os seguintes scripts com seus comandos de intérprete:

Esta configuração é salva de duas formas dependendo da funcionalidade ou opção envolvida:

O NVDA oferece a opção "Salvar configuração ao sair" (ver manual do usuário do NVDA) que permite salvar automaticamente a configuração do NVDA ao sair ou reiniciar o NVDA. Se esta opção não estiver marcada, a configuração só será salva mediante ação do usuário ou ao modificar um parâmetro que exige reiniciar o NVDA.

Este add-on segue esse modo de operação.

Algumas alterações nas configurações do add-on exigem salvar a configuração e reiniciar o NVDA. Neste caso, o usuário é convidado a salvar e reiniciar imediatamente, como o NVDA faz quando há mudança de idioma.

Ao desinstalar o add-on, seu arquivo de configuração é excluído e a configuração do add-on é removida de todos os perfis de configuração.

Ao desinstalar uma funcionalidade, sua configuração, se houver, é completamente excluída.

No caso de uma atualização, a instalação do add-on oferece a possibilidade de manter (na medida do possível) ou não a configuração anterior.

Usando o submenu "Redefinir configuração", é possível restaurar a configuração ao mesmo estado em que estava quando o add-on foi instalado pela primeira vez, incluindo aquela salva nos perfis de configuração.

Isso permite recomeçar do zero sem precisar desinstalar e reinstalar o add-on em caso de eventuais problemas.

1.3. Ajuda contextual

Na maioria das caixas de diálogo do add-on, é possível, usando a tecla "F1", abrir o manual do usuário do add-on no capítulo mais apropriado.

1.4. atualização

A atualização do add-on é, por padrão, realizada automaticamente pouco tempo após o início do NVDA (entre 20 e 600 segundos) e no máximo uma vez por dia. É possível desativar essa atualização desmarcando a opção "verificar atualizações automaticamente" da categoria "Atualização" nas configurações do add-on.

A versão do add-on pode ser:

Por padrão, a versão estável é atualizada com uma versão estável mais recente (número de versão superior). Mas é possível atualizar a versão estável em execução para uma versão de desenvolvimento da próxima versão estável. Basta marcar a opção "Atualizar também a versão estável para versões de desenvolvimento", localizada na categoria "Atualização" das configurações do add-on.

Uma versão de desenvolvimento é atualizada:

O botão "Procurar atualização", localizado nas configurações do add-on, item de menu "Atualização", permite buscar imediatamente uma atualização.

O botão "Ver histórico", localizado nesta mesma categoria, permite exibir o histórico da versão atual no navegador.

No caso de uma atualização automática e se uma nova versão for detectada, a caixa de diálogo "Atualização" será exibida para sugerir:

No caso de uma atualização para uma versão estável, o botão "O que há de novo" oferece a possibilidade de abrir, no navegador, o histórico do add-on e assim conhecer as novidades da versão proposta.

1.5. Modo de operação em modo de segurança

Neste modo, o funcionamento do add-on é degradado.

Assim como o NVDA, não é possível salvar alterações de configuração.

Algumas funcionalidades deixam de estar disponíveis, como:

1.6. Compatibilidade

A configuração da funcionalidade "Alternância de perfil de voz" foi alterada e, por isso, é excluída durante uma atualização a partir de uma versão do add-on anterior à 9.0. Todos os seletores são liberados e os perfis de voz associados são excluídos.

1.7. Histórico

O histórico de versões deste add-on encontra-se no arquivo "changes.html"

2. Funcionalidades

2.1. Preâmbulo

2.1.1. Instalação de uma funcionalidade

Este add-on permite instalar ou não uma funcionalidade específica. O estado de instalação de cada funcionalidade do add-on é apresentado na categoria "instalação de funcionalidades" da caixa de diálogo "Configurações".

Este estado pode ser:

Por padrão, este add-on não instala todas as funcionalidades.

2.1.2. Ativação de scripts

Em geral, cada script pode ser ativado de duas formas:

Na caixa de diálogo "Gestos de entrada" do NVDA, os scripts fornecidos pelo add-on são colocados em sua própria categoria.

A grande maioria dos scripts encontra-se nas categorias: "Extensão de comandos globais do NVDA", "Alternância de perfil de voz", "Configuração", "Ferramentas" e "Fala".

Para os scripts que podem ser iniciados por um comando do interpretador, esse comando é indicado após a descrição do script.

Dependendo da escolha de instalação de uma funcionalidade ("Instalar" ou "Instalar sem gesto de entrada"), os gestos de entrada fornecidos por padrão são ou não atribuídos aos scripts dessa funcionalidade.

Por padrão, a grande maioria dos scripts que podem ser iniciados pelo interpretador de comandos não está atribuída a nenhum gesto de entrada.

2.1.3. Interpretador de comandos

Ele é iniciado usando o gesto de entrada "NVDA+j". Um bipe será emitido em seguida.

É então possível ativar os scripts das funcionalidades usando comandos. Atualmente, esses comandos não podem ser modificados.

O comando "h" do interpretador lista todos os scripts das funcionalidades instaladas acessíveis por um comando do interpretador. Nessa lista, é possível iniciar o script selecionado pressionando a tecla "Enter".

O comando "g" do interpretador abre o guia do usuário do add-on.

O interpretador de comandos é encerrado:

2.2. Exibição da lista de ícones na área de notificação e da lista de janelas de aplicativos em execução

Esta funcionalidade é, por padrão, instalada com gestos de entrada.

Ela adiciona os seguintes scripts:

Esses scripts estão localizados na categoria "Extensão de comandos globais do NVDA" da caixa de diálogo "Gestos de entrada" do NVDA.

2.2.1. Exibição da lista de ícones na área de notificação

Este script, inicialmente criado por Yannick Maillot e Daniel Poiraud, era instalado por meio do add-on independente "ListIconesZoneNotification_v1.2.nvda-addon", o qual deve, portanto, ser desinstalado.

Sua descrição é: "Mostra a lista de botões da Bandeja do Sistema"

Ele é iniciado pelo comando "F11" do interpretador de comandos. É o equivalente ao script do JAWS "Insert + F11".

Nenhum gesto de entrada é atribuído a ele por padrão.

Ele exibe uma caixa de diálogo que contém:

A navegação na caixa de diálogo é feita por "Tab" ou Shift + Tab e, na lista, pelas setas para cima e para baixo.

Pressionar a tecla "Esc" fecha a caixa de diálogo.

Na lista de ícones, pressionar "Enter" ativa o botão "Clique esquerdo simples".

2.2.2. Lista de janelas de aplicativos em execução

A descrição deste script é: "Exibe a lista de janelas de aplicativos em execução com a possibilidade de colocar uma delas em primeiro plano ou fechá-la".

É o equivalente ao script do JAWS "Insert + F10".

Ele é iniciado pelo comando "F10" do interpretador de comandos.

Nenhum gesto de entrada é atribuído a ele por padrão.

Ele exibe uma caixa de diálogo que contém:

A navegação na caixa de diálogo é feita por "Tab" ou Shift + Tab e, na lista, pelas setas para cima e para baixo.

Na lista, é possível selecionar digitando o início do título da janela desejada.

Pressionar a tecla "Esc" fecha a caixa de diálogo.

Na lista, as janelas são marcadas como maximizadas ou minimizadas.

Pressionar o botão "Alternar para" ou a tecla "Enter" quando estiver na lista de janelas fecha a caixa de diálogo e traz a janela da aplicação selecionada para o primeiro plano, dando-lhe o foco.

Pressionar o botão "Fechar" encerra a janela da aplicação selecionada e retorna o foco para a lista atualizada de janelas de aplicativos.

Pressionar o botão "Fechar todas" encerra todas as janelas e fecha a caixa de diálogo.

2.2.3. Exibição da lista de ícones da área de notificação ou das janelas dos aplicativos lançados

A descrição deste script é: "Mostra a lista de botões na bandeja do sistema. Com dois toques, exibe a lista de janelas de aplicativos em execução com a possibilidade de colocar uma delas em primeiro plano".

Por padrão, o gesto de entrada "Main_Key_icons_List" é atribuído.

Nenhum comando do interpretador é atribuído a ele.

Um toque simples no gesto de entrada inicia o script "Exibição da lista de ícones na área de notificação" (ver acima).

Pressionar duas vezes inicia o script "Exibição da lista de janelas dos aplicativos lançados" (ver acima).

2.3. Ajuda para a composição de símbolos complexos

Este recurso é, por padrão, instalado sem gesto de entrada.

Ele adiciona os dois scripts a seguir:

Esses scripts são armazenados na seção "Extensão de comandos globais do NVDA" da caixa de diálogo "Gestos de entrada" do NVDA.

2.3.1. Script Compor um símbolo complexo, como uma vogal acentuada, um símbolo matemático

Este script é iniciado:

Ele exibe a caixa de diálogo "Ajuda para a composição de símbolos complexos", composta por:

Navega-se na caixa de diálogo usando "Tab" ou "Shift + Tab".

Pressionar a tecla "Esc" fecha a caixa de diálogo.

Quando estiver na lista de categorias, pressionar "Enter" ou "Tab" leva o foco para a lista de símbolos da categoria selecionada.

Esses símbolos são listados na ordem do arquivo "symbolCategories.dic" (ver abaixo).

Por outro lado, se estiver na lista de símbolos e um símbolo estiver selecionado, pressionar "Enter" ativa o botão "Colar".

Posicionado em um símbolo, pressionar "Espaço" faz com que o código do símbolo seja vocalizado na forma: código decimal seguido do código hexadecimal soletrado. Isso pode ser útil se quiser compor manualmente o símbolo usando o comando do Windows "Alt + 0" seguido do código decimal no teclado numérico.

Pressionar um dos três botões fecha a caixa de diálogo.

O botão "Gerenciar seus símbolos" apresenta a caixa de diálogo que oferece a possibilidade de completar as categorias básicas do complemento com seus próprios símbolos.

Essa caixa de diálogo exibe:entrada" do NVDA.É

As categorias e símbolos adicionados são armazenados no arquivo de configuração do complemento (NVDAExtensionGlobalPluginAddon.ini, localizado na pasta de configuração do usuário do NVDA), na seção "Categories & Symbols" e na subseção correspondente ao idioma do NVDA no qual as alterações foram feitas.

Cada categoria é uma seção definida como:

As categorias básicas do complemento, com seus símbolos, são definidas em um arquivo "symbolCategories.dic" específico para cada idioma, localizado na pasta "xxx" da pasta "local" do complemento (xxx sendo o identificador do idioma, por exemplo, "pt" para português).

Você pode personalizar este complemento e criar suas próprias categorias básicas.

Para isso, basta criar, na pasta userConfig, um arquivo "symbolCategories-xxx.dic", salvo com codificação "utf-8" (xxx é o código do idioma). Neste arquivo, o nome das categorias será definido entre colchetes e cada símbolo da seguinte forma:

Linhas vazias ou de comentário (começando com "#") são aceitas.

Esses arquivos são preservados durante uma atualização do complemento, mesmo que o usuário peça para não manter suas próprias configurações.

A instalação do complemento adiciona, para cada idioma, a pronúncia de certos símbolos encontrados nas categorias básicas e que o NVDA não possui. O arquivo "symbols-xx.dic", na pasta userConfig, é criado ou modificado para adicionar as novas pronúncias.

2.3.2. Script Exibir a lista dos últimos símbolos complexos compostos

Este complemento armazena os últimos 20 símbolos digitados para o perfil de configuração atual.

Este script permite exibi-los e recompor um símbolo comumente utilizado. Isso evita ter que procurá-lo na sua categoria com o script anterior.

Este script é iniciado pelo comando control+f4 do interpretador de comandos. Nenhum gesto de entrada está atribuído a ele por padrão.

Ele apresenta o mesmo tipo de caixa de diálogo que o script anterior, mas sem o botão para gerenciar seus próprios símbolos.

O número máximo de últimos símbolos pode ser configurado com a opção "Número máximo de símbolos compostos recentemente gravados", localizada na categoria "Avançado" da caixa de diálogo "Configurações" do complemento.

2.4. Informações sobre o aplicativo em foco

Este recurso é instalado por padrão sem gesto de entrada.

Ele instala, conforme seu estado de instalação, os seguintes scripts:

E, em qualquer caso, os scripts:

Esses scripts são armazenados na seção "Ferramentas" da caixa de diálogo "Gestos de entrada" do NVDA.

2.4.1. Anúncio do nome do arquivo do aplicativo, o nome do appModule python carregado e o nome e status do perfil de configuração

A descrição deste script é: "Fala o nome do arquivo do aplicativo ativo junto com o nome do arquivo appModule python atualmente carregado. Pressionar esta tecla duas vezes, fala o nome e o estado do perfil de configuração atual".

Por padrão, o gesto de entrada "NVDA+control+F1" está atribuído a ele. Um único pressionamento do gesto de entrada aciona o script básico do NVDA que anuncia o nome do arquivo do aplicativo e, se houver, o nome do appModule python carregado.

Pressionar duas vezes anuncia o nome do perfil de configuração e seu status.

2.4.2. Anúncio do número da versão do aplicativo em foco

A descrição deste script é: "Anuncia o nome e o número da versão do aplicativo em foco".

Por padrão, o gesto de entrada "NVDA+shift+f1" está atribuído a ele.

O gesto de entrada aciona o anúncio do nome e do número da versão do aplicativo que está em foco.

A descrição deste script é: "Exibir informações sobre o aplicativo em foco".

Ele é iniciado com o comando "a" do interpretador.

Por padrão, nenhum gesto de entrada está atribuído a ele.

Ele exibe a caixa de diálogo "Extensão de comandos globais do NVDA - Informação", que apresenta as seguintes informações:

2.4.3. Exibição do nome e número da versão do complemento

A descrição deste script é: "Anunciar o nome e o número da versão do complemento ativado para o aplicativo em foco".

Por padrão, nenhum gesto de entrada está atribuído a ele, nem qualquer comando do interpretador.

2.5. Aprimoramento de recursos do buffer virtual

Este recurso é instalado por padrão.

Ele se aplica aos navegadores Mozilla Firefox, Microsoft Internet Explorer, Google Chrome, Microsoft Edge (parcialmente) e fornece:

2.5.1. Novos comandos de navegação

Este complemento adiciona os seguintes comandos para o modo de navegação:

Exceto pelos quatro primeiros, esses comandos não são implementados no navegador Microsoft Edge.

2.5.2. Novos tipos de elementos para o script "NVDA + f7"

Basicamente, o script integrado ao NVDA e ativado pelo gesto de entrada "NVDA + f7" permite exibir a caixa de diálogo "Lista de elementos", apresentando a lista de certos elementos encontrados em uma página da Web. Este complemento aumenta o número de tipos de itens que podem ser escolhidos e exibidos no título da caixa de diálogo, conforme o tipo selecionado.

A lista desses tipos torna-se:

Tipos básicos:

Tipos adicionados pelo complemento:

Esses tipos são apresentados como uma lista em vez de botões de opção (na versão básica).

Um tipo pode ser acessado digitando a primeira letra do seu rótulo.

A cada mudança de tipo, o número de elementos encontrados é anunciado ou, se nenhum elemento for encontrado, a indicação de voz "nenhum elemento" é emitida.

Um som de bip repetitivo é ouvido durante a busca por itens.

O status "marcado" ou "não marcado" é sinalizado para as caixas de seleção.

O tipo "edição" fornece a lista das zonas de edição do documento, e cada elemento é apresentado vocalmente da seguinte forma:

Da mesma forma, cada campo de formulário é apresentado vocalmente de acordo com seu tipo.

2.5.3. Scripts para tabelas

Para os navegadores Microsoft Internet Explorer, Microsoft Edge, Mozilla Firefox e Google Chrome, é possível, quando o cursor está sobre uma célula da tabela:

Os quatro últimos scripts foram removidos da extensão para versões iguais ou superiores a 2022.2, pois agora são fornecidos pelo NVDA.

Todos esses scripts estão armazenados na categoria "Tabela" na árvore de visualização da caixa de diálogo "Gestos de entrada" do NVDA.

Este complemento também move scripts base do NVDA que anteriormente estavam na categoria "Diversos" para esta categoria. São eles:

2.5.4. Anúncio do endereço do documento

O gesto de entrada "NVDA+a" (computador desktop) ou "NVDA+shift+a" (laptop), pressionado nos navegadores Mozilla Firefox, Microsoft Internet Explorer, Microsoft Edge ou Google Chrome, anuncia o endereço (URL) do documento. Com um duplo pressionamento, esse endereço é copiado para a área de transferência.

2.5.5. Navegação em loop

No modo de navegação, a busca pelo próximo ou anterior item para ao chegar ao fim ou ao início do documento.

Este complemento adiciona, como opção, a possibilidade de navegar ciclicamente pelo documento, ou seja:

A passagem pelo início ou fim do documento é sinalizada por um som e uma mensagem de voz.

A opção "Navegação em loop" na categoria "Complementos do NVDA" da caixa de diálogo "Configurações" do complemento permite ativar ou desativar essa funcionalidade.

Essa opção só é exibida se o recurso "Estender a funcionalidade do buffer virtual" estiver instalado.

Por padrão, essa opção não está marcada. O funcionamento básico do NVDA é mantido.

2.6. scripts para clicar na posição atual do objeto do navegador

Esses scripts permitem realizar, com o botão esquerdo ou direito do mouse, um clique simples ou duplo na posição atual do objeto do navegador.

Eles encadeiam na prática dois tipos de scripts do NVDA:

Os gestos de entrada desses scripts são:

Esses gestos de entrada podem ser modificados e estão na categoria "mouse" da caixa de diálogo "Gestos de entrada" do NVDA.

2.7. Anúncio da função associada aos comandos de edição do tipo "copiar", "colar"

Esse recurso é instalado por padrão.

As funções ativadas pelos atalhos "Control + V", "Control + C", "Control + X", "Control + Z" não são vocalizadas pelo NVDA; este complemento se encarrega disso.

Nenhuma verificação do resultado da função é realizada.

No entanto:

É fortemente recomendado não instalar complementos que forneçam o mesmo tipo de funcionalidade.

2.8. complementos para a área de transferência

Os seguintes scripts são instalados sistematicamente pela extensão:

2.8.1. Adicionar texto selecionado à área de transferência

Esse recurso adiciona o script que permite adicionar o texto selecionado à área de transferência.

Esse script é instalado sem gesto de entrada, mas é possível atribuir um utilizando a caixa de diálogo "Gestos de entrada" do NVDA. Sua descrição é "Adicionar texto selecionado à área de transferência" e está na categoria "Extensão de comandos globais do NVDA".

Todos os parâmetros usados para o script estão localizados no grupo "Área de transferência" da categoria "Teclado" da caixa de diálogo do complemento, que apresenta as configurações do perfil de configuração atual.

Ele é iniciado usando o comando do interpretador "x".

Após o comando, o texto selecionado é adicionado ao conteúdo da área de transferência, seja depois ou antes do conteúdo existente, dependendo do estado da caixa de seleção "Adicionar antes à área de transferência".

É possível colocar um texto separador entre os blocos de texto. Esse texto pode ser configurado usando o campo de edição de texto usado como separador entre os conteúdos adicionados à área de transferência.

Uma solicitação de confirmação será exibida antes de prosseguir com a adição, se a caixa de seleção "Pedir confirmação antes de adicionar à área de transferência" estiver marcada.

Nota: esse script foi retirado do complemento "ClipContentsDesigner" (Autores: Noelia, Abdel), que também fornece outros recursos interessantes relacionados à área de transferência. Ele foi incluído neste complemento a pedido de usuários que desejavam ao mesmo tempo o anúncio das funções "copiar" e "colar".

2.8.2. Relatar texto da área de transferência do Windows

Este script substitui o script padrão do NVDA ("NVDA+c") para complementá-lo, informando ao usuário que executou o comando que:

O número de caracteres lidos não está mais limitado a 1024.

Esse número máximo pode ser configurado usando a opção "Máximo de caracteres relatados" no grupo "Área de transferência" da categoria "Melhorias do NVDA".

2.8.3. Esvaziar a área de transferência

Este script é instalado sem gesto de entrada, mas é possível atribuir um usando a caixa de diálogo "Gestos de entrada" do NVDA.

Sua descrição é "Esvaziar a área de transferência" e está sob a categoria "Status do sistema".

Sua função é apagar completamente o conteúdo da área de transferência do Windows. Atenção: isso não afeta o histórico da área de transferência do Windows.

Ele é iniciado usando o comando do interpretador "control+x".

2.8.4. Exibir o texto contido na área de transferência em uma janela de informações

Este script é instalado sem gesto de entrada, mas é possível atribuir um usando a caixa de diálogo "Gestos de entrada" do NVDA.

Sua descrição é "Exibir texto da área de transferência em uma janela de informações" e está na categoria "Status do sistema".

Sua função é apresentar o texto contido na área de transferência em uma caixa de diálogo. Ele se comporta como o script que anuncia esse texto ("NVDA+c").

Ele é iniciado usando o comando do interpretador "shift+x".

2.9. Anúncio da pasta selecionada nas caixas de diálogo do tipo "Abrir", "Salvar", "Salvar como"

Esse recurso é instalado por padrão, sem gesto de entrada.

Ele adiciona, para as caixas de diálogo do tipo "Abrir", "Salvar", "Salvar como", "Localizar em", scripts que permitem conhecer o nome e o caminho da pasta que está selecionada para definir o local onde o arquivo será procurado ou salvo.

Esses scripts estão localizados na categoria "Extensão de comandos globais do NVDA" da caixa de diálogo "Gestos de entrada" do NVDA.

São eles:

Nenhum gesto de entrada está associado aos dois últimos scripts, mas é possível associar um usando a caixa de diálogo "Gestos de entrada" do NVDA.

Atenção: esses scripts só funcionam em caixas de diálogo que seguem o padrão do Windows.

2.10. Registros do NVDA

Esse recurso é instalado por padrão, sem gesto de entrada.

Ele adiciona os scripts:

Esses scripts estão armazenados na categoria "Ferramentas" da caixa de diálogo "Gestos de entrada" do NVDA.

2.10.1. Gerenciamento dos registros do NVDA

A descrição deste script é: "Abrir uma caixa de diálogo para gerenciar os registros do NVDA".

Ele é iniciado usando o comando do interpretador "j". Nenhum gesto de entrada está atribuído a ele por padrão.

Este script exibe a caixa de diálogo "Gerenciamento de registros do NVDA", apresentando:

O registro não é aberto diretamente. Ele é copiado para um arquivo temporário que, em seguida, é aberto no WordPad. O log não é aberto diretamente. Ele é previamente copiado para um arquivo temporário chamado "NVDALog.txt" ou "oldNVDALog.txt".

2.10.2. Abertura dos registros do NVDA

A descrição deste script é: "Abrir o arquivo de log atual do NVDA. Pressione esta tecla duas vezes para abrir o log antigo. Pressione três vezes para copiar o caminho do log atual para a área de transferência".

Ele é iniciado usando o gesto de entrada "NVDA+shift+j", que é atribuído a ele por padrão.

O log não é aberto diretamente. Ele é previamente copiado para um arquivo temporário chamado "NVDALog.txt". Esse arquivo temporário é então aberto no programa associado à extensão .txt. Por padrão, é o Bloco de Notas.

2.11. Histórico de fala

Esse recurso é instalado por padrão sem gesto de entrada.

Para poder ouvir novamente anúncios de voz que foram mal compreendidos ou ouvidos, este complemento grava um histórico limitado das mensagens de fala enviadas ao sintetizador. O número de registros é limitado a 200.

Para ouvir novamente essas gravações, os seguintes scripts, localizados na categoria "Fala" da caixa de diálogo "Gestos de entrada" do NVDA, são fornecidos por esta funcionalidade:

2.11.1. Anúncio da gravação anterior

Este script é iniciado usando o gesto de entrada "NVDA+control+f8", atribuído por padrão.

O gesto de entrada aciona o anúncio da gravação anterior em relação à última anunciada.

2.11.2. Anúncio da próxima gravação

Este script é iniciado usando o gesto de entrada "NVDA+control+f10", atribuído por padrão.

O gesto de entrada aciona o anúncio da próxima gravação em relação à última anunciada.

2.11.3. Reanunciar a última gravação anunciada

A descrição deste script é: "Anunciar o registro atual do histórico de fala e copiá-lo para a área de transferência. Duas vezes: exibir histórico de fala".

Este script é iniciado usando o gesto de entrada "NVDA+control+f9", atribuído por padrão.

Um pressionamento simples aciona o anúncio da última gravação.

Um duplo pressionamento aciona a cópia da gravação para a área de transferência.

Um triplo pressionamento exibe todo o histórico.

2.11.4. Exibir histórico de fala

A descrição deste script é: "Exibir os registros do histórico de fala".

Este script é iniciado usando o comando do interpretador "f9". Nenhum gesto de controle é atribuído a ele por padrão.

Ele apresenta a caixa de diálogo "Histórico de fala", que lista essas gravações em ordem decrescente de antiguidade. Um botão permite copiar a gravação selecionada para a área de transferência.

Por padrão:

2.11.5. Detalhes técnicos

Para realizar essa funcionalidade, as funções "speak" e "speakSpelling" do módulo "speech.speech.py" do NVDA foram substituídas. As funções de substituição são comuns com a funcionalidade "Dispositivo de saída de áudio temporário".

Isso pode causar problemas se outros complementos também fizerem essa substituição.

Para que outros complementos funcionem corretamente, é necessário desinstalar essas duas funcionalidades.

2.12. Renomear teclas do teclado

Essa funcionalidade é instalada por padrão.

Ela permite renomear certas teclas do teclado, como "Caps Lock" ou "Num Lock", por meio de uma caixa de diálogo que apresenta:

Quando um rótulo de substituição é definido para a tecla selecionada, a caixa de edição somente leitura, acessível com "Tab", exibe esse rótulo. Esse rótulo é anunciado quando a tecla está em foco.

O botão "Excluir" permite apagar esse rótulo de substituição.

Também é possível apagar esse rótulo digitando uma string vazia ou completa na caixa de entrada.

O botão "Excluir tudo" permite apagar todos os rótulos de substituição e retornar aos rótulos padrão fornecidos pelo NVDA.

O botão "OK" aplica as substituições e salva as teclas do teclado e seus rótulos de substituição no arquivo de configuração do complemento, na seção "RedefinedKeyLabels" e na subseção de idioma correspondente do NVDA ("fr", por exemplo, para francês). Assim, é possível ter renomeações de teclas para diferentes idiomas.

Para exibir esta caixa de diálogo, há três possibilidades:

É possível não instalar esta funcionalidade selecionando, na categoria "Funcionalidades instaladas", para a funcionalidade "Renomear teclas do teclado", o status "Não instalar".

2.13. Anúncio seletivo de teclas de comando

Essa funcionalidade é instalada por padrão.

O NVDA permite que as teclas de comando sejam anunciadas por voz usando a opção "Falar teclas de comando", localizada na categoria "Teclado" da caixa de diálogo "Configurações" do NVDA, ou pelo gesto de entrada "NVDA + 4".

Essa funcionalidade fornece, por configuração e por meio de uma caixa de diálogo, a possibilidade de:

Para exibir essa caixa de diálogo, há três possibilidades:

A caixa de diálogo apresenta:

Pressionar a barra de espaço marca ou desmarca a tecla ou combinação selecionada.

Se a caixa "Falar teclas de comando" da caixa de diálogo não estiver marcada, marcar uma tecla fará com que ela seja anunciada mesmo quando o NVDA estiver configurado para não anunciá-las.

A lista de combinações de teclas modificadoras torna-se acessível e todos os elementos dessa lista são marcados por padrão.

Para impedir que uma tecla seja anunciada com uma determinada combinação, basta desmarcar essa combinação.

Se o item "nenhuma" da lista de combinações estiver marcado, a tecla será anunciada mesmo quando pressionada sem combinação modificadora.

Por outro lado, se a caixa "Falar teclas de comando" estiver marcada, marcar uma tecla impede que ela seja anunciada quando o NVDA estiver configurado para anunciá-las.

A lista de combinações de teclas modificadoras torna-se acessível e todos os elementos dessa lista são marcados por padrão. Isso significa que a tecla, pressionada com ou sem combinação, não será anunciada.

A ação de desmarcar uma combinação permite anunciar a tecla com essa combinação.

O item "nenhuma" da lista de combinações permite não anunciar a tecla pressionada sozinha.

Os botões "Desmarcar tudo" e "Marcar tudo" permitem desmarcar ou marcar todos os elementos da lista de combinações de teclas modificadoras.

O primeiro item "qualquer tecla com combinação de modificador" na lista de teclas permite, sem indicar uma tecla específica, selecionar um conjunto de combinações modificadoras. Qualquer tecla pressionada com uma dessas combinações será anunciada ou não, conforme o modo de configuração escolhido.

O botão "OK" salva as escolhas feitas para o perfil de configuração atual, enquanto o botão "Cancelar" descarta as alterações.

Nas listas, a tecla "F2" e a combinação "Shift + F2" permitem mover-se, respectivamente, para o próximo ou anterior item marcado.

É possível não instalar essa funcionalidade selecionando, na categoria "Funcionalidades instaladas", para a funcionalidade "Anúncio seletivo de teclas de comando", o status "Não instalar".

2.13.1. Detalhes técnicos

Para alcançar essa funcionalidade, a função "executeGesture" do "inputCore.manager" foi substituída. Essa alteração é comum com o recurso “NVDA e a permanência das teclas modificadoras”.

Se essa mudança causar conflito com outros add-ons, ambas as funcionalidades devem ser desinstaladas.

2.14. Temporizador de minutos

Esse recurso é instalado por padrão.

Ele permite iniciar um temporizador com duração programável.

Quando o temporizador expira, uma caixa de diálogo aparece exibindo um anúncio programável e a emissão de um toque.

Ele instala um script que inicia:

Se o temporizador estiver parado, o script exibe a caixa de diálogo "Iniciar temporizador" que apresenta:

A duração, o anúncio e o tempo para aviso antes da expiração do temporizador são registrados cada vez que o temporizador é iniciado e exibidos por padrão na próxima vez que o temporizador for iniciado.

Se o temporizador estiver em andamento, o script então exibe a caixa de diálogo "Temporizador em andamento" permitindo saber a duração restante do temporizador e, possivelmente, pará-lo.

A duração é atualizada a cada 5 segundos e é anunciada quando o foco está na zona de edição (somente leitura) que a exibe.

Essa caixa de diálogo fecha automaticamente quando o temporizador expira.

2.15. Reinício do NVDA

Esse recurso não é instalado por padrão.

Ele instala um script que permite reiniciar o NVDA no nível de log de depuração sem modificar a configuração do NVDA.

A descrição desse script é: "Reiniciar NVDA. Duas vezes: reiniciar com nível de log ajustado para debug".

Ele está colocado na categoria "Diversos" do diálogo "gestos de entrada" do NVDA.

O gesto de entrada "NVDA+control+f4" é atribuído a ele por padrão.

Um simples toque nesse gesto aciona o reinício do NVDA com o nível de log configurado nas preferências gerais.

O duplo toque nesse gesto reinicia o NVDA com o nível de log em debug sem alterar o nível configurado nas preferências gerais do NVDA.

2.16. Exibição dos elementos visíveis do objeto em primeiro plano

Por padrão, esse recurso é instalado com gesto de entrada.

Ele instala dois scripts armazenados na categoria "Foco do sistema" do diálogo "gestos de entrada" do NVDA:

2.16.1. Exibição dos elementos visíveis do objeto em foco

A descrição desse script é: "Exibir os itens visíveis da lista que compõem o objeto em primeiro plano atual".

Ele é iniciado usando o comando "b" do interpretador.

Nenhum gesto de entrada está atribuído a ele.

O script começa a procurar esses itens. Isso pode levar bastante tempo. Um sinal audível a cada dois segundos é emitido durante essa busca.

Para limitar esse tempo de busca, limites são aplicados para certos tipos de elementos:

Quando a busca é concluída, os elementos são exibidos na caixa de diálogo "Lista de elementos visíveis que compõem o objeto em primeiro plano", de acordo com seu tipo.

Essa caixa de diálogo apresenta:

Na lista de elementos, é possível alterar o tipo de objetos para listar sem sair da lista:

Também nessa lista, é possível alcançar um elemento digitando as primeiras letras do seu rótulo.

Para um elemento do tipo:

2.16.2. Anúncio ou exibição dos elementos visíveis do objeto em foco

A descrição deste script é: "Lê todos os controles na janela ativa. Se pressionado duas vezes: exibe a lista dos itens visíveis que a compõem".

É iniciado usando o gesto de entrada "NVDA+b", que lhe é atribuído por padrão.

Uma única pressão executa o script básico do NVDA que anuncia todos os objetos do objeto em primeiro plano.

Pressionar duas vezes executa o script anterior "Exibição dos elementos visíveis do objeto em primeiro plano".

2.17. Troca rápida de perfil de voz

Este recurso é instalado por padrão, sem gesto de entrada.

Permite trocar rapidamente o perfil de voz dando a possibilidade de memorizar até 8 perfis de voz e selecionar rapidamente um deles.

Um perfil de voz é definido por:

Instala os seguintes scripts na categoria "Troca de perfil de voz" do diálogo "Gestos de entrada" do NVDA:

2.17.1. Gerenciamento dos seletores de perfil de voz

A descrição deste script é: "Exibe o diálogo para gerenciar seletores de perfil de voz".

Pode ser ativado por:

Este script exibe a caixa de diálogo "Gerenciamento dos seletores de perfil de voz do perfil de configuração ProfileName" (onde ProfileName é o nome do perfil de configuração acionado).

Esta caixa é usada para gerenciar a associação seletor-perfil de voz e apresenta:

A lista "Seletores" mostra a lista de seletores livres ou aqueles associados a um perfil de voz. Os seletores associados são:

Quando o seletor está indicado como "livre", o botão "Associar perfil de voz" permite associar o perfil de voz atual a este seletor. Este botão exibe uma caixa de diálogo para dar um nome a este perfil de voz. Um nome padrão é sugerido. O botão "Padrão" permite retornar a essa sugestão.

Quando um seletor já está associado a um perfil de voz, então é possível:

Se o seletor selecionado for um seletor associado sob o perfil de configuração normal, então não é possível liberá-lo, mas pode ser associado ao perfil atual.

Apenas seletores associados ao perfil de configuração atual podem ser liberados.

Para trocar rapidamente o perfil de voz, o modo "Troca de perfil de voz" é ativado.

Para ativar ou desativar este modo, deve-se digitar o comando "p" do interpretador.

Com este modo ativado, as setas direita ou esquerda são usadas para mover ao primeiro seletor seguinte ou anterior associado a um perfil de voz e assim definir o perfil de voz associado a este seletor como o perfil de voz atual.

Os seletores considerados são os da lista "Seletores" que estão associados a um perfil de voz.

2.17.2. Modo "Troca de perfil de voz"

Para trocar rapidamente o perfil de voz, o modo "Troca de perfil de voz" é ativado e um script é usado para ativar ou desativar este modo.

A descrição deste script é: "Ativa ou desativa o modo Troca de perfil de voz".

Para executar este script, existem duas possibilidades:

Quando este modo está ativado, as setas direita ou esquerda são usadas para mover ao primeiro seletor seguinte ou anterior associado a um perfil de voz e assim definir o perfil de voz associado a este seletor como o perfil de voz atual.

Os seletores considerados são os da lista "Seletores" que estão associados a um perfil de voz.

2.17.3. Escolha do seletor de perfil de voz anterior

A descrição deste script é: "Retroceder ao primeiro seletor associado a um perfil de voz e definir esse perfil de voz como o atual".

É iniciado usando o gesto de entrada "nvda+shift+control+seta para esquerda" atribuído por padrão.

O script busca na lista "Seletores" o primeiro seletor anterior ao seletor atual que está associado a um perfil de voz. Então define esse perfil de voz como o perfil atual.

2.17.4. Escolha do próximo seletor de perfil de voz

A descrição deste script é: "Avançar ao primeiro seletor associado a um perfil de voz e definir esse perfil de voz como o atual".

É iniciado usando o gesto de entrada "nvda+shift+control+seta para direita" atribuído por padrão.

O script busca na lista "Seletores" o primeiro seletor seguinte ao seletor atual que está associado a um perfil de voz. Então define esse perfil de voz como o perfil atual.

2.17.5. Escolha do seletor de perfil de voz por número

São instalados 8 scripts. A descrição desses scripts é: "Define o seletor x como seletor atual e, se possível, define o perfil de voz associado a ele como perfil de voz atual" (onde x é o número do seletor).

Cada script é iniciado usando o gesto de entrada "nvda+shift+control+número do seletor" atribuído por padrão.

O script seleciona o seletor x e, se associado a um perfil de voz, define esse perfil de voz como o perfil de voz atual.

2.17.6. Relatório ou exibição das configurações atuais de fala

Os 3 scripts a seguir permitem conhecer as configurações atuais de fala sem precisar usar o menu "Fala" do NVDA.

Eles estão armazenados na categoria "Fala" do diálogo "Gestos de Entrada" do NVDA e são instalados mesmo se o recurso "Troca de perfil de voz" não estiver instalado.

Nenhum gesto de entrada está associado a eles, mas é possível atribuir um a cada um.

Suas descrições são:

2.17.7. Salvamento automático das configurações de voz ao alternar perfis

As configurações de voz atuais podem ser salvas automaticamente para o seletor atual ao alternar perfis de voz.

O objetivo disso é evitar ter que reassociar manualmente o perfil de voz ao mesmo seletor caso os parâmetros vocais tenham sido modificados, como por exemplo a taxa, o volume, e para não perder essas modificações ao mudar para outro perfil vocal se isso não for feito.

Obviamente, o seletor atual deve estar associado a um perfil de voz. Caso contrário, não haverá salvamento.

Esse recurso é configurável e não está ativado por padrão.

Para ativá-lo, marque a opção "Salvar automaticamente as configurações de voz atuais para o seletor atual antes de alternar", que se encontra na categoria "Avançado" das configurações globais do complemento.

2.18. Persistência das teclas modificadoras e da tecla NVDA

Esse recurso não está instalado por padrão.

Ele permite tornar persistentes as teclas NVDA ("Insert" do teclado numérico normal ou estendido, tecla "Caps Lock") e as teclas modificadoras ("Shift", "Control", "Alt esquerdo", "Control direito", "Alt direito", "Windows").

O objetivo é poder usar apenas um dedo, por exemplo, para compor um gesto de entrada que exija o pressionamento de várias teclas.

É adicionado um agrupamento chamado "Persistência de teclas" na categoria "Teclado" da caixa de diálogo "Configurações" do complemento.

Para ativar ou desativar a persistência das teclas, basta pressionar uma das seguintes sequências de teclas:

A persistência das teclas pode ser ativada automaticamente na inicialização do NVDA marcando a caixa de seleção "Ativar persistência na inicialização do NVDA", no agrupamento "Persistência de teclas". A ativação ou desativação é anunciada por voz.

Quando a persistência está ativada, pressionar uma das teclas NVDA ou modificadoras inicia um tempo de espera e a tecla é memorizada. Esse tempo pode ser configurado através da lista suspensa "Atraso de persistência (em milissegundos)", no agrupamento "Persistência de teclas".

Também é possível limitar a persistência apenas à tecla "NVDA", marcando a caixa "Apenas tecla NVDA na persistência", localizada no mesmo agrupamento. Por padrão, essa opção não está marcada, e todas as teclas modificadoras são persistentes.

O início e o fim da persistência são sinalizados por um bipe, que pode ser desativado pelas seguintes caixas de seleção na categoria "Persistência de teclas":

Essas caixas estão marcadas por padrão.

Durante esse tempo, qualquer nova tecla pressionada reinicia o tempo e também é memorizada, mas nenhum bipe é emitido.

Pressionar qualquer outra tecla do teclado executa o gesto de entrada composto pela combinação de todas as teclas memorizadas com essa última tecla.

Cada vez que essa última tecla for pressionada novamente dentro do tempo de espera, o gesto será executado novamente.

Se essa tecla for pressionada fora do tempo de espera, ela será executada sozinha e as teclas memorizadas serão esquecidas.

Aviso: É necessário esperar o fim da persistência para que qualquer nova tecla seja tratada individualmente. Por exemplo: pressionar "Alt" para exibir um menu e navegar entre os itens.

Entretanto, é possível interromper a persistência antes do fim do tempo de espera, pressionando novamente a última tecla em persistência.

2.18.1. Persistência específica para o site gmail.com

Essa persistência é configurada especificamente para o site gmail.com e só está ativa na página "https://mail.google.com/mail/#i".

Ela não está ativa por padrão. Uma caixa de seleção "Persistência especial para Gmail.com" está disponível no agrupamento "Persistência de teclas".

Nessa página, é possível digitar atalhos para lançar comandos, mas alguns deles combinam duas letras. Em particular, as letras "g", "h", "*" devem ser seguidas por outra letra. Essa sequência deve ser rápida o suficiente para acionar o comando associado. Isso é problemático para pessoas com pouca destreza.

O objetivo dessa persistência é reter a primeira letra enquanto aguarda a segunda.

Quando a primeira letra é pressionada, inicia-se um tempo de espera (um bipe grave é emitido) e a letra é armazenada.

Digitar a segunda letra dentro do tempo de persistência configurado enviará ambas ao navegador e o tempo será cancelado. Se nenhuma nova letra for digitada, a primeira letra será enviada ao navegador no fim do tempo (um bipe agudo é audível).

Para que o NVDA envie as letras ao navegador, é necessário estar em modo de formulários.

2.19. Desligamento do computador

Esse recurso não pode ser desinstalado.

Ele instala um script cuja descrição é: "Exibir o diálogo para desligar, reiniciar ou hibernar".

É iniciado pelo comando do interpretador "r". Esse script exibe uma caixa de diálogo composta pelos seguintes elementos:

Esse recurso também instala os scripts correspondentes às funções dos três botões, com o seguinte comportamento:

Se um tempo de espera diferente de zero for configurado, uma caixa de diálogo apresenta o tempo restante antes de hibernar, desligar ou reiniciar.

O botão "Cancelar" ou a tecla "Escape" interrompe a solicitação.

A leitura do tempo restante respeita a opção "Acompanhar barras de progresso" do NVDA.

O botão "Anunciar tempo restante" permite ler o tempo restante exibido na caixa de diálogo.

Todos os scripts são colocados na categoria "Extensão de comandos globais do NVDA" da caixa de diálogo "Gestos de entrada" do NVDA, mas nenhum gesto está atribuído a eles.

2.20. Gerenciamento dos gestos de entrada do usuário

Este recurso não pode ser desinstalado.

Basicamente, o NVDA permite adicionar ou remover gestos de entrada por meio da caixa de diálogo "Gestos de entrada". Mas não há nenhuma maneira de saber quais gestos foram adicionados ou removidos pelo usuário.

É isso que esta funcionalidade pretende atender.

Para isso, ela adiciona o script cuja descrição é "Exibe a caixa de diálogo para gerenciar os gestos de entrada configurados pelo usuário", e que é colocado na categoria "Extensão de comandos globais do NVDA" da caixa de diálogo "Gestos de entrada" do NVDA.

Ele é iniciado por meio do comando do interpretador "u". Nenhum gesto de controle é atribuído a ele por padrão.

Este script exibe uma caixa de diálogo no estilo "Gestos de entrada" do NVDA, selecionando apenas os gestos de entrada excluídos ou modificados pelo usuário.

A caixa de diálogo apresenta:

Os gestos de entrada removidos de uma categoria são exibidos com a descrição: "gestos de entrada removidos".

Como não é possível saber a categoria e a descrição de um gesto de entrada excluído ou de um gesto de entrada adicionado associado a um script de um complemento que não está ativado ou instalado no momento da exibição da caixa de diálogo, esse gesto é apresentado da seguinte forma:

Assim como na caixa de diálogo clássica "Gestos de entrada", somente ao pressionar o botão "OK" todas as exclusões de gestos serão levadas em consideração.

O cancelamento de todas as alterações usando o botão "Excluir tudo" está sujeito a confirmação. Ao aceitar, todas as alterações são canceladas e a caixa de diálogo é fechada.

2.21. Controle de volume

Por padrão, este recurso é instalado sem gesto de entrada.

Ele só pode funcionar sob o sistema operacional Windows 10.

Se estiver instalado com ou sem um gesto de entrada, ele adiciona o agrupamento "Controle de volume" na categoria "Computador" da caixa de diálogo de configurações do complemento.

Ele instala os seguintes scripts armazenados sob a categoria "Controle de volume" na caixa de diálogo "Gestos de entrada" do NVDA:

2.21.1. Definir manualmente o volume principal e o fluxo de áudio do NVDA

Este script é iniciado:

Ele define os volumes do dispositivo de saída de áudio que o NVDA utiliza e também o do fluxo de áudio do próprio NVDA, forçando os níveis de cada um para os valores de restauração configurados no grupo "Controle de som", da categoria "Computador", nas configurações do complemento.

2.21.2. Silenciar ou definir o volume do fluxo de áudio do aplicativo em foco

Este script é executado:

Este comando silencia o volume do fluxo de áudio do aplicativo em foco, se estiver ativo, ou o restaura, se estiver silenciado.

2.21.3. Modificar o volume do fluxo de áudio do aplicativo em foco

Estes scripts são usados para aumentar, diminuir ou definir o volume do fluxo de áudio do aplicativo em foco.

Eles são instalados sem gestos de entrada, mas ainda é possível atribuí-los através do diálogo "Gestos de entrada".

Eles são iniciados com os seguintes comandos do interpretador:

2.22. Exemplo de comando para aumentar o volume

KEY\_APP\_VOLUME\_UP

Estes comandos, ao contrário de outros comandos do interpretador, podem ser repetidos sem reiniciar o interpretador. O interpretador permanece ativo. Assim que o nível de volume desejado for alcançado, pressione a tecla "Escape" para sair do interpretador.

O aumento ou diminuição do volume ocorre em etapas. É possível ajustar o tamanho dessas etapas nas configurações do complemento, na categoria "Computador", grupo "Controle de volume", escolhendo o tamanho da etapa.

O tamanho 1 corresponde à menor etapa; o tamanho 20, à maior. O valor padrão é 5.

Por padrão, o volume do aplicativo não pode ultrapassar o volume principal. No entanto, essa limitação pode ser desativada se a opção "Aumentar o volume das caixas de som se necessário" estiver marcada. Essa opção está disponível no grupo "Modificação de volume" da categoria "Computador" nas configurações globais do complemento.

2.22.1. Modificar o volume do NVDA

Estes scripts permitem aumentar, diminuir ou definir o volume do NVDA.

Eles são instalados sem gestos de entrada, mas ainda é possível atribuí-los através do diálogo "Gestos de entrada".

São iniciados com os seguintes comandos do interpretador:

2.23. Exemplo para definir o volume do NVDA para 30%

SHIFT+3

Assim como os comandos anteriores, estes também podem ser repetidos sem reiniciar o interpretador, que permanece ativo.

Pressione "Escape" para sair do interpretador quando o nível de volume for alcançado.

O aumento ou diminuição do volume é feito em etapas. É possível configurar o tamanho dessas etapas nas opções do complemento, na categoria "Computador", grupo "Controle de som", escolhendo o tamanho da etapa.

Tamanho 1 é o menor; tamanho 20 é o maior. Por padrão, o tamanho é definido como 5, o que corresponde a 5 etapas de variação no mixer do Windows.

O volume do NVDA não pode cair abaixo do limite de recuperação configurado.

Por padrão, ele também não pode ultrapassar o volume principal. No entanto, essa restrição pode ser desativada se a opção "Aumentar o volume das caixas de som se necessário" estiver marcada.

2.23.1. Modificar volume principal

Estes scripts permitem aumentar, diminuir ou definir o volume principal do dispositivo de saída de áudio usado pelo aplicativo em foco (incluindo o NVDA), ou o padrão do Windows, caso o aplicativo não use um dispositivo específico.

Eles são instalados sem gestos de entrada, mas ainda é possível atribuí-los via "Gestos de entrada".

São iniciados com os seguintes comandos do interpretador:

2.24. Exemplo para definir volume principal em 60%

CTRL+6

Esses comandos, como os anteriores, podem ser repetidos continuamente com o interpretador ativo. Pressione "Escape" para sair quando atingir o nível desejado.

O volume é ajustado por etapas, cujo tamanho pode ser configurado nas opções do complemento, na categoria "Computador", grupo "Controle de som".

Tamanho 1 é o menor passo, 20 é o maior. O padrão é 5.

O volume principal não pode ficar abaixo do nível de recuperação definido.

2.24.1. Retornar ao nível anterior

Ao utilizar os comandos anteriores, o nível de volume é salvo antes da execução de cada comando, tanto para o dispositivo de áudio, quanto para o NVDA e para cada aplicativo.

Para retornar ao nível salvo, estão disponíveis os seguintes comandos:

2.25. Exemplo para restaurar volume anterior do aplicativo

KEY\_APP\_VOLUME\_PREVIOUS\_LEVEL

O nível anterior também é salvo ao executar estes comandos. Esses registros não são mantidos após reiniciar o NVDA.

2.25.1. Anúncio de alterações de volume

As alterações de volume são anunciadas por padrão. O nome do dispositivo de saída de áudio também é anunciado na primeira alteração de volume para esse dispositivo.

No entanto, é possível desativar esse anúncio usando a opção "Anunciar alterações de volume" no grupo "Modificação de volume" da categoria "Computador".

2.25.2. Restaurar automaticamente som principal e do NVDA ao carregar o complemento

Esta função permite restaurar, ao carregar o complemento, o volume da fonte de áudio do NVDA e o do dispositivo de saída de áudio utilizado, ajustando o nível de cada um para um valor configurado, caso esteja abaixo do limite mínimo definido.

No grupo "Controle de som" da categoria "Computador" no diálogo de configurações do complemento, estão disponíveis os seguintes elementos:

2.26. Ativar restauração automática de volume

Marcar a opção "Ajustar automaticamente o som ao carregar o complemento"

Quando a caixa "Ajustar automaticamente o som ao carregar o complemento" está marcada, o complemento verifica, no momento da inicialização, se os volumes estão acima dos limites configurados. Caso não estejam, os volumes são ajustados para os valores definidos nas configurações.

Durante a instalação, os volumes atuais do NVDA e do dispositivo de saída de áudio usado são usados para definir os valores de restauração.

Por padrão, o complemento coloca o NVDA em ambos os canais e no mesmo nível de volume. O volume fixado será o maior valor entre os dois canais.

É possível desativar essa funcionalidade desmarcando a caixa "Ao iniciar, colocar o NVDA nos dois canais".

Para versões do NVDA superiores à 2024.2, essa funcionalidade será desativada automaticamente caso o modo de separação de som do NVDA esteja ativado, independentemente do estado da caixa.

2.27. suplementos relativos à data e hora

Este recurso é instalado por padrão sem gesto de entrada.

Atenção: se instalado com gesto de entrada, este recurso pode entrar em conflito com a extensão "Clock", pois o gesto de entrada "NVDA+F12" é compartilhado.

Este recurso oferece:

2.27.1. Copiar data e hora para a área de transferência

A descrição deste script é: "Copiar data e hora para a área de transferência". Este script está armazenado na categoria "Estado do sistema" da caixa de diálogo "Gestos de entrada" do NVDA.

Ele é executado usando o comando "d" do interpretador. Nenhum gesto de entrada está atribuído a ele.

Como a descrição indica, ele permite copiar a data e a hora para a área de transferência.

2.27.2. Script para substituir o script base "NVDA + f12"

O complemento instala um script com a seguinte descrição: "Anuncia a hora atual. Com dois toques, anuncia a data atual. No terceiro: copia data e hora para a área de transferência".

Este script está armazenado na categoria "Estado do sistema" da caixa de diálogo "Gestos de entrada" do NVDA.

Nenhum comando do interpretador está associado a ele.

Se o status de instalação do complemento for "Instalar", este script substitui o script do NVDA e é iniciado com o gesto de entrada "NVDA + f12".

Caso contrário, nenhum gesto de entrada é atribuído a ele, mas ainda é possível atribuí-lo através da caixa de diálogo "Gestos de entrada" do NVDA.

Este script permite:

Ele também oferece:

2.27.2.1. Anúncio da hora independente do nível de pontuação

O gesto de entrada padrão "NVDA + f12" fornece a hora com um único toque, mas o horário não é anunciado da mesma forma dependendo do nível de pontuação e símbolos selecionado nos parâmetros de voz.

Este script corrige essa pequena falha, forçando o nível de pontuação e símbolos para "Nenhum" ao anunciar a hora, sem modificar o nível definido na categoria "Fala".

2.27.2.2. Anúncio da hora com segundos

Por padrão, o gesto de entrada "NVDA + f12" do NVDA anuncia a hora sem os segundos.

Este script oferece a possibilidade de anunciar a hora com os segundos.

Basta marcar a caixa de seleção "Relatar hora do relógio do Windows com segundos" na categoria "Computador" da caixa de diálogo de configurações do complemento. Esta opção não vem marcada por padrão.

Esta opção não está presente se o status de instalação do recurso for "Não instalar".

2.28. Emulação da tecla "Aplicações"

Para compensar a ausência da tecla "Aplicações" em alguns computadores, e considerando que o atalho "Shift + F10" pode não ter a mesma função, o complemento instala um script sem gesto de entrada na categoria "Teclas emuladas do sistema", com a descrição "Emular pressionamento da tecla: aplicações".

Para usá-lo, basta atribuir um gesto de entrada ou uma tecla pouco usada, como a tecla "Print Screen" ou "Pause".

2.29. Fechar todas as janelas

O complemento instala um script para fechar todas as janelas abertas.

Este script está na categoria de scripts do complemento, com a descrição "Fechar todas as janelas abertas".

Ele é iniciado com o comando "k" do interpretador de comandos. Nenhum gesto de controle está atribuído por padrão.

2.30. Lista de complementos em execução

O gerenciador de complementos ou a Loja de Complementos exibe a lista de complementos instalados e seus status: ativado ou desativado.

Mas, mesmo ativado, um complemento pode não estar carregado pelo NVDA. Em princípio, o log do NVDA relata esse fato, mas nada é exibido no gerenciador de complementos, nem na Loja de Complementos.

Pode ser interessante, em determinado momento, saber quais complementos estão realmente em execução.

Para isso, o complemento instala um script com a descrição "Exibir lista de complementos em execução" na categoria de complementos da caixa de diálogo "Gestos de entrada".

Este script é iniciado com o comando "e" do interpretador de comandos. Nenhum gesto de controle está atribuído a ele.

Os complementos são listados por tipo:

2.31. Ferramentas de desenvolvimento

Este recurso não é instalado por padrão.

Ele instala o script com a descrição "Exibir caixa de ferramentas para desenvolvimento de complementos".

Este script está armazenado na categoria "Ferramentas" da caixa de diálogo "Gestos de entrada" do NVDA.

Este script é iniciado com o comando "t" do interpretador. Nenhum gesto de controle está atribuído a ele.

Ao ativá-lo, surge uma caixa de diálogo com:

2.31.1. Noções

Para empacotar um complemento (criar o arquivo de instalação do complemento), recomenda-se usar o "modelo nvda addon scons".

Esse modelo utiliza um arquivo "buildVars.py" que define, para um complemento, todas as informações necessárias, como: nome interno, versão, nome e descrição traduzíveis para cada idioma suportado.

Este modelo também é usado para permitir a tradução das strings do complemento com o sistema de tradução mantido pela comunidade "NVDA-addon.org".

O objetivo desse modelo é, após desenvolver o complemento, com um simples comando e após preencher o arquivo "buildVars.py":

Ao criar um complemento, não há nada ainda. É necessário criar o arquivo "manifest.ini" manualmente, possivelmente o arquivo de localização e o arquivo de documentação. O objetivo dessas ferramentas é, nessa situação:

2.31.2. Criação do arquivo buildVars.py

O primeiro passo é criar o arquivo "buildVars.py" com base nas informações do "manifest.ini" que criamos para o desenvolvimento do complemento.

O botão "Criar o arquivo buildVars.py" inicia essa operação.

É apenas esse arquivo que modificaremos posteriormente para atualizar o "manifest.ini" (como alteração de versão ou descrição).

Para usá-lo com o "modelo scons", será necessário preenchê-lo com informações que não estão presentes no arquivo "manifest.ini".

2.31.3. Atualização da versão do complemento

O botão "Atualizar a versão do complemento" permite modificar a versão definida no arquivo buildVars.py do complemento selecionado.

Ele apresenta uma caixa de diálogo com uma área de edição preenchida com a versão atual.

Ao pressionar o botão "OK", a nova versão é salva no arquivo.

2.31.4. Atualização do manifest.ini

O arquivo "manifest.ini" deve ser atualizado sempre que o arquivo "buildVars.py" for modificado.

Use o botão "Atualizar o arquivo manifest.ini" para isso.

2.31.5. Criação do arquivo de localização manifest.ini

Qualquer modificação nas informações "addon_summary" ou "addon_description" do arquivo "buildVars.py" exige a tradução dessa descrição para cada idioma suportado pelo complemento (consideradas no nvda.po e compilação do arquivo).

Para que o Gerenciador de Complementos apresente essa informação ao usuário no idioma escolhido para o NVDA, é necessário criar ou atualizar o arquivo de localização "manifest.ini" para aquele idioma.

O botão "Criar o arquivo de localização manifest.ini" permite isso. É possível atualizar o arquivo para o idioma selecionado ou para todos os idiomas.

2.31.6. Criar documentação HTML

Os arquivos de documentação do complemento podem estar nos formatos "markdown" (.md) ou "txt2tags" (.t2t).

Para serem apresentados ao usuário em um navegador, esses arquivos precisam ser convertidos para HTML.

Isso pode ser feito simplesmente usando o botão "Criar arquivos de documentação HTML" após selecionar o complemento na lista de complementos e escolher um idioma ou todos os idiomas da lista.

Quando abertos no navegador, esses arquivos HTML precisam dos arquivos de estilo (style.css para arquivos Markdown e style_t2t.css para arquivos txt2tags) colocados na pasta "doc" do complemento.

2.31.7. Criação do arquivo de catálogo

O botão "Criar arquivo POT" é usado para criar o arquivo de catálogo para o complemento selecionado.

Uma vez criado, esse arquivo é colocado na pasta "locale\en" do complemento e é nomeado como "versão-nome.pot", onde "nome" é o nome do complemento e "versão" é a sua versão.

2.31.8. Preparação do complemento

O botão "Preparar complemento" executa, para o complemento selecionado, as seguintes ações:

2.31.9. Exploração do complemento

O botão "Explorar pasta do complemento" abre o Explorador do Windows na pasta do complemento selecionado.

2.32. Gerenciamento de configurações do usuário

2.32.1. Apresentação

O objetivo desta funcionalidade é permitir que o usuário reinicie o NVDA com a configuração de usuário de sua escolha.

Para isso, ela se baseia na possibilidade que o NVDA oferece ao usuário de indicar o caminho do diretório de configuração na linha de comando que inicia o NVDA.

Todos os parâmetros de configuração são salvos em uma pasta específica no disco rígido e, por padrão, essa pasta está localizada:

Mas essa pasta de configuração pode ter outro nome e estar localizada em outro lugar no disco rígido ou numa unidade USB.

Para pedir ao NVDA que a utilize, basta indicá-la ao iniciar o NVDA com a linha de comando:

Se o diretório não existir, o NVDA o cria ao ser iniciado e o inicializa como se fosse a primeira inicialização após a instalação.

Caso contrário, o NVDA é iniciado usando as configurações presentes nessa pasta de configuração.

É portanto possível ter várias configurações de usuário com o mesmo NVDA.

Isso permite, por exemplo, ter além da configuração básica, uma configuração de teste para experimentar novos complementos, ou uma configuração com ajustes muito específicos para uma determinada situação.

Essa funcionalidade oferece então os meios para:

2.32.2. Gerenciar pastas de configuração do usuário

Antes de tudo, é necessário definir as configurações que serão utilizadas.

Para isso, o complemento instala o script "Exibir o diálogo para gerenciar configurações do usuário", que é executado usando o comando do interpretador "n".

Nenhum gesto de entrada é atribuído a esse comando, mas ainda é possível fazê-lo por meio do diálogo "Gestos de entrada" do NVDA.

Esse comando é usado para exibir o diálogo "Gerenciamento de configurações do usuário", que apresenta:

A lista contém todas as pastas adicionadas pelo usuário e aquelas adicionadas automaticamente pelo complemento.

A pasta de configuração ativa é sinalizada por voz e pelo símbolo de "marcado" (checked) na frente de seu nome.

Quando este diálogo é exibido pela primeira vez, o complemento a insere automaticamente na lista e a salva.

Para essa pasta, os botões "Excluir esta pasta" e "Esvaziar esta pasta" não estão presentes.

Uma pasta recém-adicionada que ainda não é uma pasta de configuração é marcada com um ponto de interrogação.

Uma pasta de configuração do NVDA é caracterizada por seu conteúdo. Ela deve conter, em particular, os seguintes elementos:

O botão "modificar esta pasta" não está presente se a pasta selecionada for a pasta de configuração ativa.

2.32.2.1. Adicionando uma pasta

Os botões "Adicionar uma nova pasta" e "Adicionar uma pasta existente" permitem adicionar uma pasta à lista de pastas de configuração.

Pressionar o primeiro botão exibe o diálogo "Adicionar uma nova pasta", que mostra:

O identificador da pasta é usado para nomeá-la da seguinte forma: "nvdaUserConfig-identificador".

É com esse nome que a pasta aparece na lista e no disco rígido ou na unidade USB.

Pressionar o segundo botão exibe o diálogo "Adicionar uma pasta existente", que apresenta:

2.32.2.2. Exclusão de pasta

O botão "Excluir esta pasta" permite remover a pasta selecionada da lista e apagá-la do disco.

Esse botão não está disponível se a pasta for a pasta da configuração ativa.

Será solicitada uma confirmação para a exclusão dessa pasta.

2.32.2.3. Preparação ou modificação da pasta

Dependendo se a pasta é uma pasta de configuração ou não, o diálogo exibirá, respectivamente:

Esses botões têm como objetivo fornecer ferramentas para importar configurações de outra pasta de configuração.

Ao ativar esses botões, cada um exibe seu próprio diálogo, que se diferencia apenas pelo título.

Nesses diálogos, encontramos:

O nome da pasta que será modificada é indicado no título dos diálogos.

A ação de cada botão se refere ao conteúdo da pasta selecionada na lista.

Para a importação de complementos, é possível importar todos ou apenas alguns dos complementos da pasta selecionada, bem como escolher manter ou não os complementos já incluídos na pasta que será modificada. O mesmo se aplica à importação de perfis.

A importação de toda a configuração permite duplicar completamente a pasta selecionada e, assim, ter uma cópia idêntica da configuração dessa pasta.

2.32.2.4. Reiniciando o NVDA com outra configuração

O botão "Reiniciar o NVDA com esta pasta" permite reiniciar o NVDA com a configuração da pasta selecionada.

Essa pasta pode ser:

Para que essa outra configuração também possa ser reiniciada dessa forma, este complemento deve estar instalado nela também.

Nesse caso, não será necessário refazer a adição da pasta de configuração. O complemento retomará as pastas previamente salvas.

Esse registro é feito no arquivo "NVDAExtensionGlobalPlugin-userConfigs.ini" armazenado em:

2.32.2.5. Exploração da pasta de configuração

O botão "Explorar esta pasta" abre a pasta de configuração selecionada no explorador.

2.32.3. Exemplos de uso

2.32.3.1. Iniciar o NVDA com uma nova configuração em branco

NVDA reinicia e inicializa a configuração como após uma instalação.

2.32.3.2. Iniciar NVDA com configuração idêntica

Após os 5 passos anteriores:

2.32.3.3. Iniciar NVDA com uma configuração existente

Combinando os dois exemplos e usando um pendrive, é possível usar a mesma configuração em diferentes máquinas.

2.32.3.4. Transferência ativa de configuração de um computador para outro via pendrive

No computador destino, conecte o pendrive e veja a letra da unidade.

Agora vamos iniciar o NVDA do computador destino com essa pasta de configuração.

Duas opções:

Para usar essa opção:

Agora o NVDA carrega a configuração da pasta do pendrive. É possível, antes de substituir a configuração anterior, realizar testes para conferir funcionamento.

Para instalar essa configuração:

Só resta iniciar o NVDA instalado, seja pelo ícone na área de trabalho, seja pressionando "Alt+Control+N".

2.33. Análise de texto

Essa funcionalidade está atualmente em fase de testes.

Ao editar ou revisar um documento usando apenas voz, inconsistências como parênteses não casados, mudanças de formatação não intencionais, espaços extras e pontuações espúrias ou sem espaçamento podem ser frequentemente ignoradas.

O recurso "Análise de texto" instala uma ferramenta (analisador) que sinaliza essas irregularidades, usando mensagem de voz ou arquivo WAV ao refazer por palavra ou por linha.

É possível configurar o analisador para anunciar essas irregularidades por número, descrição ou som.

A análise é dividida em três grupos de pesquisa:

É possível desativar um grupo de pesquisa inteiro ou, individualmente, cada verificação dentro de um grupo.

Para isso, adiciona-se a categoria "Text analysis" no diálogo de configurações do add-on.

As configurações nessa categoria são específicas para o perfil ativo, anunciado ao selecionar a categoria.

2.33.1. Ativação / desativação do analisador

O analisador pode ser ativado ou desativado de três formas:

Ativar ou desativar o analisador afeta apenas o perfil de configuração atual.

A caixa "Activate the text analyzer when starting the add-on" na categoria "Text analysis" define, para cada perfil, se o analisador inicia ativado ou não quando o add-on é carregado.

Com o analisador ativo, ele analisa automaticamente cada vez que o cursor se move de palavra em palavra ou de linha em linha nas zonas de edição de texto.

O resultado da análise é indicado conforme a configuração escolhida, por:

Para configurar os alertas, veja o grupo "Alert" na categoria "Text analysis".

2.33.2. Configuração da análise

2.33.2.1. Verificação de incompatibilidade de símbolos

Esse item vem ativado por padrão.

Símbolos como parênteses, colchetes, chaves geralmente aparecem aos pares: abertura e fechamento.

Essa pesquisa verifica essa correspondência.

Os símbolos possíveis estão listados na lista "symbols" do grupo "Symbol concordand" na categoria "Text analysis".

Cada símbolo pode ser incluído ou excluído da análise marcando ou desmarcando-o na lista.

Os símbolos listados dependem do idioma selecionado no NVDA e são definidos no arquivo "textAnalyzer.ini" dentro da pasta de idioma do "locale".

2.33.2.2. Detecção de anomalias

Esse item vem ativado por padrão.

A lista de anomalias a detectar está no grupo "Anomalies" da categoria "Text analysis".

Essas anomalias incluem:

Na lista, essas são caixas de seleção. Por padrão, todas estão marcadas. Ao desmarcar uma caixa, a verificação relacionada a ela não será feita.

Para as anomalias relacionadas aos espaços ao redor de um símbolo, os símbolos envolvidos são indicados como marcados na lista que contém todos os símbolos disponíveis. Conforme necessário, é possível marcar ou desmarcar um símbolo específico. Os símbolos marcados por padrão são definidos para cada idioma do NVDA que exija isso, no arquivo "textAnalysis.ini" localizado na pasta de idioma dentro da pasta "locale".

2.33.2.3. Pesquisa por alteração de formatação

Está desativada por padrão. As alterações de formatação podem ser sinalizadas pelo analisador, dependendo do estado da caixa "Reportar alterações" no grupo "Formatação" da categoria "Análise de texto".

As alterações de formatação dizem respeito a:

Esses itens podem ser incluídos ou excluídos individualmente da pesquisa, marcando-os ou desmarcando-os na lista "Tipos" do mesmo grupo.

2.33.2.4. Verificação de erros ortográficos

Essa pesquisa vem ativada por padrão.

2.33.3. Análise sob demanda

O complemento instala scripts para analisar o texto sob o cursor mediante solicitação.

Esses scripts são:

2.33.4. Mover o cursor para a próxima/anterior irregularidade

Os seguintes scripts permitem mover o cursor para a próxima ou anterior irregularidade:

A busca por irregularidades é realizada em um intervalo de 100 linhas. Se nenhuma irregularidade for encontrada nesse intervalo, uma solicitação é feita ao usuário para continuar a busca em um novo intervalo.

Esses dois scripts não possuem gestos de entrada atribuídos por padrão, mas isso pode ser feito através do diálogo "Gestos de entrada" do NVDA. Eles estão localizados na categoria "Extensão de comandos globais do NVDA".

2.34. Anúncio da posição do cursor em caixas de edição

O script "Alternar anúncio da posição atual do cursor na caixa de edição" permite ativar ou desativar o anúncio da posição do cursor quando ele está em uma zona de edição.

Essa posição é relativa ao início da linha na qual o cursor está localizado.

A ativação ou desativação desse anúncio é específica para o perfil de configuração atual.

O script é instalado sem gesto de entrada e com o comando do interpretador "f7".

Se desejar, é possível atribuir um gesto de entrada a ele através do diálogo "Gestos de entrada" do NVDA.

2.35. Dispositivo de saída de áudio temporário

Este recurso é instalado por padrão.

Ele permite alterar temporariamente o dispositivo de saída de áudio atual para outro dispositivo de áudio, sem afetar a configuração do NVDA em todos os perfis de configuração.

Cada perfil manterá suas próprias configurações da categoria "Fala" utilizadas pelo NVDA, incluindo o dispositivo de saída de áudio.

Chamaremos esse dispositivo de "Dispositivo de Áudio Temporário".

Quando um dispositivo de áudio temporário está ativo, todos os sons (mensagens de voz e sinais sonoros) emitidos pelo NVDA serão enviados para esse dispositivo, independentemente do dispositivo configurado no perfil ativo.

Sons emitidos pelo sistema continuam sendo enviados ao dispositivo de saída de áudio selecionado nas configurações do Windows.

Como nenhuma configuração é alterada no NVDA, o registro automático ou manual do NVDA não mantém nenhum traço desse dispositivo.

Para retornar ao funcionamento normal, ou seja, uso dos dispositivos de áudio dos perfis de configuração, basta abandonar o dispositivo de áudio temporário.

Para que isso seja possível, o complemento instala vários scripts.

2.35.1. Gerenciador de dispositivo de áudio temporário

Este script tem a descrição "Exibir o gerenciador de dispositivo de áudio temporário" e está colocado na categoria "Fala" do diálogo "Gestos de entrada" do NVDA.

Nenhum gesto de entrada é atribuído por padrão, mas ainda é possível fazê-lo nesse diálogo.

É iniciado usando o comando "c" do interpretador de comandos.

Em resposta a esse comando, a caixa de diálogo "Gerenciador de dispositivo de áudio temporário" é exibida, apresentando:

Na lista, a movimentação é feita com as setas "para cima" e "para baixo".

Ao selecionar um periférico, ouvem-se dois bipes ao sair dele para permitir checar se funciona corretamente ou está devidamente conectado, assim evitando ativá-lo por engano.

A troca para o dispositivo selecionado é feita pressionando o botão padrão ou, se o foco estiver na lista, pressionando a tecla "Enter".

Esse dispositivo torna-se o dispositivo de áudio temporário e o áudio do NVDA passa a ser enviado para ele.

Para evitar ficar sem som, o complemento pergunta se o usuário confirma o uso desse dispositivo. Esse pedido aparece após a falha na troca e expira após um tempo.

Essa confirmação pode ser removida desmarcando a opção "Solicitar confirmação" no grupo "Dispositivo de áudio temporário" da categoria "Computador" nas configurações globais do complemento.

O pedido de confirmação exibe uma caixa por tempo limitado solicitando que o usuário confirme o uso do novo dispositivo.

O tempo de exibição dessa caixa também pode ser ajustado usando a lista "Tempo máximo de espera por confirmação" no mesmo grupo.

Pressionar "OK" ou "Enter" confirma. Ao extrapolar o tempo, sem confirmação, o dispositivo antigo é restaurado automaticamente.

Para voltar ao modo normal (sem uso de dispositivo temporário), execute outro script ou reinicie abruptamente o NVDA.

Na lista de dispositivos, é possível marcar alguns deles. Dispositivos marcados serão usados pelo script "Definir como dispositivo de áudio temporário o próximo dispositivo da lista de dispositivos marcados no gerenciador de dispositivo temporário" (ver abaixo).

2.35.2. Troca de dispositivo de áudio temporário

Existem duas formas de trocar de dispositivo:

Esse script é descrito como "Definir, como dispositivo de áudio temporário, o próximo dispositivo na lista de dispositivos marcados no gerenciador de dispositivo temporário" e está na categoria "Fala" do diálogo "Gestos de entrada".

Nenhum gesto padrão é atribuído, mas pode ser adicionado via diálogo.

É executado com o comando "shift+c" no interpretador.

Cada vez que esse script é executado, um novo dispositivo é definido como temporário, escolhido entre os marcados na lista do gerenciador. O próximo dispositivo na sequência é selecionado. Após a troca, não é solicitado confirmação.

2.35.3. Abandonar o dispositivo de áudio temporário

Esse script é descrito como "Abandonar dispositivo de áudio temporário" e está na categoria "Fala" do diálogo "Gestos de entrada".

Nenhum gesto padrão atribuído, mas pode ser adicionado via diálogo.

É executado com o comando "control+c".

Se não houver dispositivo temporário ativo, o script não faz nada. Caso haja, o áudio do NVDA passa a ser direcionado novamente ao dispositivo configurado no perfil ativo.

2.35.4. Alternar entre definir e abandonar dispositivo temporário

Esse script combina os dois anteriores. Primeiro toque: define o próximo dispositivo da lista marcada como temporário. Segundo toque (rápido): abandona o dispositivo temporário.

Não possui gesto ou comando vinculados por padrão, mas pode ser atribuído via diálogo.

2.35.5. Detalhes técnicos

Para implementar isso, as funções "speak" e "speakSpelling" do módulo "speech.speech.py" do NVDA foram substituídas, assim como ocorreu com o recurso "Histórico de fala". Isso pode gerar conflito com outros complementos. Para resolver, é necessário desinstalar ambos os recursos em conflito.

Também foi alterada a função "playWaveFile" do módulo nvwave.py (conflito com o recurso "Alteração de ganho de arquivos de som do NVDA"). Para evitar problemas, desative ambos.

Além disso, foram modificadas funções nos módulos e classes envolvendo "tones", "synthDriverHandler" e "synthDrivers.oneCore". Caso haja conflitos, é necessário remover essa funcionalidade.

2.36. Orientação do áudio de saída do NVDA

Esse recurso permite separar o áudio do NVDA do áudio de outras fontes, permitindo ouvir em um ouvido o NVDA e no outro o áudio de outros aplicativos.

Funciona somente com fontes de áudio estéreo usando o mesmo dispositivo de saída.

Permite também ajustar volumes nos canais esquerdo e direito, controlar tons do NVDA (em versões anteriores à 2025.1) e alterar o ganho de arquivos de som do NVDA e do complemento.

É instalado por padrão.

O direcionamento do áudio é feito zerando o volume do canal oposto e mantendo o volume mais alto entre os canais.

Como o NVDA é mono, o mesmo áudio é tocado em ambos os canais, sem perda ao zerar um canal — ao contrário das aplicações estéreo.

Para orientar o som, o complemento instala scripts (sem gestos padrão) na categoria "Controle de som" em "Gestos de entrada":

2.36.1. Gerenciador de fontes de áudio

No diálogo "Gerenciador de fontes de áudio" é possível:

Ele inclui:

Ao focar na lista, é possível ⬆️ e ⬇️ para navegar e usar comandos já disponíveis no NVDA para operar os potenciômetros.

Essa lista é atualizada automaticamente ao receber foco.

As mudanças de canal ou de volume são aplicadas imediatamente após cada comando. Por padrão, o volume da fonte de áudio não pode exceder o volume principal. Mas a opção "Aumentar volume principal, se necessário" pode desativar essa restrição. Ela está no grupo "Alteração de volume" da categoria "Computador" nas configurações do add‑on.

Por padrão e quando o Wasapi não é usado, o nível de tom do NVDA está em 50, valor base interno do NVDA.

Há uma proteção que impede zerar simultaneamente o volume dos canais do NVDA se ele ficar abaixo do limite de restauração configurado.

Ao selecionar uma fonte de áudio, o estado de balanceamento e o status de mudo são anunciados.

⚠️ Atenção: NVDA e as fontes de áudio devem usar o mesmo dispositivo de saída (como o sound mapper) para funcionamento correto. Esse recurso só faz sentido nesse cenário.

Quando a lista de dispositivos de saída tem foco, selecionar um dispositivo reproduz um tom nele. É possível desativar esse tom desmarcando a opção "Tocar tom no dispositivo de áudio" no grupo "Gerenciador de fontes de áudio" da categoria "Avançado" nas configurações globais do add‑on.

Na lista, os seguintes comandos também são válidos:

2.36.1.1. Alteração de ganho de arquivos de som do NVDA e do complemento

Quando a fonte NVDA está selecionada, o botão "Alterar ganho de arquivos de som" é ativado.

Pressioná-lo abre o diálogo "Modificar ganho dos arquivos de som do NVDA", que apresenta:

Os sons do NVDA aparecem com descrição traduzível. Os sons do complemento aparecem com prefixo "_" seguido do nome do arquivo, indicando a origem do som: NVDAExtensionGlobalPluginSounds ou NVDAExtensionGlobalPluginSoundsTextAnalyzerAlerts.

Se o ganho estiver em zero, os botões "Testar", "Aplicar ganho" e "Aplicar a todos" não aparecem.

"Aplicar ganho" salva o som modificado em outro arquivo, usado posteriormente. "Redefinir som" apaga esse arquivo e recupera o original.

Sons modificados são marcados como "modificado" na lista. São salvos na pasta "NVDAExtensionGlobalPlugin-NVDAWaves" no diretório de configuração do usuário. Essa pasta só é criada se houver sons modificados.

Se o som selecionado não foi modificado, o botão "Redefinir som" não aparece. Se não houver sons modificados, "Redefinir todos os sons" não aparece.

O som de inicialização do NVDA não pode ser alterado — ele é executado antes do carregamento do complemento. É possível desativar a modificação de ganho desmarcando "Permitir modificação de ganho de sons do NVDA" em "Avançado". Essa opção é marcada por padrão.

Para versões acima de 2024.2, essa funcionalidade é desativada automaticamente se o modo de áudio dividido do NVDA estiver ativo, independentemente da opção “Permitir...”. Nesse caso, o próprio NVDA gerencia os canais ao iniciar.

2.36.2. Detalhes técnicos

Para permitir o ajuste do volume das tonalidades do NVDA quando o Wasapi não é usado, o complemento modifica o funcionamento da função "beep" do módulo "tones" do NVDA. Isso pode gerar conflitos se outro complemento também tiver alterado essa função.

Para evitar esse tipo de problema, o complemento oferece a opção de não ativar esse recurso. Para isso, basta desmarcar a opção "Permitir ajuste de volume das tonalidades", localizada na categoria "Avançado" das configurações do complemento. Nesse caso, a função "beep" do NVDA não será modificada pelo complemento.

Se o Wasapi estiver em uso, essa opção não aparece, pois o ajuste de sons e tonalidades do NVDA será feito pelo próprio NVDA.

Por padrão, essa opção vem marcada.

Para que os arquivos de som modificados sejam executados em vez dos originais, a função `playWaveFile` do módulo `nvwave.py` do NVDA foi substituída. Esse mesmo recurso é utilizado pela funcionalidade "Dispositivo de Áudio Temporário".

Se a modificação dessa função for um problema, é necessário desmarcar a opção "Permitir modificação de ganho" e também desinstalar a funcionalidade "Dispositivo de Áudio Temporário".

2.37. Ativação ou desativação rápida de complementos

Para ativar ou desativar complementos, o NVDA oferece nativamente o gerenciador de complementos ou, desde o NVDA 2023.2, a Loja de Complementos.

Entretanto, em alguns casos pode ser necessário desativar alguns ou todos os complementos, deixando apenas alguns ativados. Com o gerenciador de complementos ou a Loja de Complementos, é preciso revisar cada complemento para ativá-lo ou desativá-lo.

Este complemento tenta tornar essa manipulação mais rápida e, para isso, oferece um script que exibe a caixa de diálogo "Ativação rápida de complementos".

Este script é iniciado usando o comando "q" do interpretador de comandos. Nenhum gesto de entrada está associado a ele, mas é possível configurá-lo usando a caixa de diálogo "Gestos de Entrada" do NVDA. Ele pode ser encontrado na categoria "Extensão de comandos globais do NVDA" com a descrição "Ativar diálogo de ativação rápida de complementos".

Esta caixa de diálogo apresenta:

Se o complemento estiver instalado em uma versão do NVDA anterior à 2023.2, a lista mostra apenas os complementos compatíveis.

Apenas complementos em estado estável são listados. Complementos em estado intermediário, ou seja, pendentes de ativação ou desativação, ou pendentes de instalação ou remoção, são excluídos. Desde o NVDA 2023.2, complementos incompatíveis também são incluídos na lista e podem ser ativados ou desativados.

Eles são indicados pela palavra "(incompatível)" após seu identificador.

Quando a caixa de diálogo é exibida, os complementos ativados são marcados.

A lista é atualizada cada vez que a janela da caixa de diálogo é ativada para considerar possíveis mudanças no estado dos complementos. Para alterar o estado de ativação de um complemento, basta marcá-lo para ativar ou desmarcá-lo para desativar.

As alterações só serão aplicadas quando o botão "Salvar e reiniciar NVDA" for pressionado.

3. Opções

3.1. Remoção do anúncio da descrição dos objetos nas fitas do Windows

Nas fitas do Windows, o NVDA é desnecessariamente muito falante. Por padrão, este complemento impede o anúncio da descrição, que parece bastante desnecessário.

Mas isso pode ser desativado usando a opção "Sem descrição do objeto nas fitas do Windows" encontrada na categoria "Computador" da caixa de diálogo "Configurações do complemento".

Será necessário reiniciar o NVDA para que a opção seja considerada.

3.2. Maximização automática de janelas

Esta opção maximiza automaticamente as janelas que são trazidas para o primeiro plano.

Por padrão, está ativada.

Você pode desativá-la desmarcando a opção "Maximizar janelas automaticamente" na categoria "Computador" da caixa de diálogo "Configurações" do complemento.

3.3. Movimento do cursor

3.4. Anúncio de pontuação ao mover por palavra

O NVDA permite mover palavra por palavra em documentos usando os comandos de teclado "control + seta para a direita" e "control + seta para a esquerda".

Os símbolos e sinais de pontuação são então pronunciados conforme o nível de pontuação e símbolos configurados para o perfil de configuração atual.

Esta opção permite configurar o nível de símbolos e pontuação que será usado apenas ao mover por palavra.

Esta escolha é salva para o perfil de configuração atual. É configurada na categoria "Aprimoramento NVDA" da caixa de diálogo "Configurações" do complemento e chamada "Nível de pontuação/símbolos no movimento por palavra".

Ela só está presente se o recurso "Anúncio da função associada aos comandos de edição estilo 'copiar', 'colar'" estiver instalado.

É apresentada na forma de uma caixa combinada que permite escolher:

3.4.1. Não dizer "vazio" ao mover por linha

Ao navegar por linha, quando o NVDA encontra uma linha sem caractere anunciado, ele diz "vazio".

Esta opção permite modificar esse comportamento e não anunciar nada.

Esta opção é configurável por perfil de configuração.

Por padrão, não está ativada.

3.5. Relato de erros ortográficos

O NVDA pode sinalizar erros ortográficos:

Para que o NVDA reporte erros ao ler e digitar, a opção "Erros ortográficos" deve estar ativada. Os erros são então indicados pela mensagem de voz "Erro ortográfico".

Para que os erros sejam indicados por som ao digitar, a opção "Tocar som para erros ortográficos ao digitar" deve estar ativada.

O complemento modifica esse comportamento do NVDA da seguinte forma:

O perfil "relato de erros ortográficos" está associado a um gatilho dedicado e não está presente na lista de gatilhos. Ele não deve ser associado a outro gatilho.

Nota:

3.6. Bloqueio das teclas "Insert" e "Caps Lock"

(disponível para versões do NVDA inferiores a 2023.1 se o recurso "Anúncio seletivo das teclas de comando" estiver instalado)

Pode ser útil, em alguns casos, evitar a ação das teclas "Insert" e "Caps Lock".

O papel inicial delas é:

O NVDA permite que o usuário defina essas teclas como tecla "NVDA". Mas nesse caso, a tecla "Insert" como a tecla "Caps Lock" só desempenham seu papel inicial se houver uma pressão dupla rápida.

Por configuração, o complemento dá a possibilidade de que essas teclas não tenham ação quando estão em seu papel inicial.

Essa configuração é feita por perfil de configuração usando uma caixa de seleção para cada tecla (veja o grupo "Bloqueio de tecla" na categoria "Teclado" do perfil atual).

Quando a ação da tecla é bloqueada, um bipe soa.

3.7. Pronúncia de caracteres não alfanuméricos quando o eco por caractere do teclado está desativado

Esta opção permite que caracteres não alfanuméricos sejam falados quando o eco do teclado por caracteres está desativado.

Isso permite que alguns usuários ouçam, por exemplo, símbolos de pontuação digitados, mesmo que tenham desativado o eco do teclado por caractere.

É configurado usando a caixa de seleção "Falar caracteres não alfanuméricos mesmo quando o eco por caractere está desativado", encontrada na categoria "Teclado" para o perfil de configuração atual.

Por padrão, essa opção está desmarcada.

4. Opções avançadas

4.1. Sinalização sonora de um erro no log do NVDA

Usuários experientes podem ter percebido que, ao usar uma versão de desenvolvimento do NVDA (snapshot master ou próxima versão), qualquer erro registrado no log do NVDA é sinalizado com um som. Mas nas versões finais ou candidatas, esse sinal não é emitido.

Esta opção oferece a escolha entre:

Para fazer essa escolha, basta selecionar a opção na lista da caixa combinada chamada "Tocar som em erros registrados" na categoria "Avançado" do diálogo "Configurações" do complemento. Por padrão, a opção "Apenas para versões de desenvolvimento" está selecionada.

4.2. Titulação das caixas de diálogo com o nome do complemento

Esta opção permite que as caixas de diálogo deste complemento sejam tituladas ou não com seu nome. Pode ser encontrada na categoria "Avançado" do diálogo "Configurações".

Por padrão, esta opção está marcada e o título das caixas fica na forma: "RESUMO_DO_COMPLEMENTO - NVDA - título do diálogo".

4.3. Configuração do atraso para espera da repetição do mesmo gesto de entrada

Alguns scripts deste complemento realizam ações diferentes dependendo do número de vezes que o gesto de entrada associado ao script é acionado. A repetição do gesto de controle deve ser feita dentro de um curto período de tempo (500 ms por padrão).

Para um script que realiza três ações diferentes, o mecanismo é:

Dependendo da destreza do usuário ou da configuração do hardware, esse tempo limite pode ser muito longo ou muito curto.

A opção intitulada "Atraso entre repetição do mesmo gesto" na categoria "Avançado" do diálogo "Configurações" do complemento permite ajustar esse tempo limite conforme necessário.

4.4. Uso padrão do teclado numérico

Por padrão, o NVDA usa certas teclas do teclado numérico, como as teclas de seta, as teclas "multiplicar", "dividir" e a tecla "mais", para ativar scripts.

O objetivo é restaurar a cada tecla do teclado numérico, temporária ou permanentemente, seu funcionamento normal, composta sozinha ou com uma tecla modificadora como "control", "Alt", "caps lock" (A tecla "NVDA" está excluída).

Essas teclas são:

Para ativar ou desativar o uso do teclado numérico no funcionamento padrão e se a opção "permitir o uso padrão do teclado numérico" no agrupamento "Teclado numérico" da categoria "Teclado" estiver marcada, o add-on oferece:

A opção "Ativar o uso padrão do teclado numérico na inicialização do NVDA" (agrupamento "Teclado numérico", categoria "Teclado"), permite, se marcada, usar o teclado numérico como padrão desde o início do NVDA, mas a opção que permite o uso padrão do teclado numérico também deve estar marcada.

4.5. Gerenciamento do Num lock

Este recurso é parcialmente retirado do add-on "sharedComputer" (autores "Robert Hänggi <aarjay.robert@gmail.com>, Noelia Ruiz Martínez <nrm1977@gmail.com>"), que parece não ter sido atualizado desde 2018.

Consiste em:

4.5.1. Reportar o estado ativado do Num Lock ao iniciar o NVDA

Por padrão e no layout de teclado "Desktop", o add-on reporta que o Num Lock está ativado ao iniciar o NVDA.

Mas isso pode ser desativado, como é o padrão para o layout de teclado "laptop", usando a opção "Reportar estado ativado ao iniciar o NVDA" no grupo "Num Lock" da categoria "Teclado" das configurações do add-on.

4.5.2. Ativação/desativação automática ao ativar um perfil de configuração

Cada vez que um perfil de configuração é ativado, é possível ativar ou desativar automaticamente o Num Lock.

A escolha é feita nas configurações do perfil de configuração, na categoria "Teclado", no grupo "Num Lock" e com a lista de escolhas "Ao ativar o perfil:".

Esta lista oferece as seguintes opções:

Por padrão, a escolha é:

4.6. Caps lock

Por padrão, quando o NVDA inicia, o estado ativado do Caps Lock é reportado.

Esse relatório pode ser desativado desmarcando a opção "Reportar estado ativado na inicialização do NVDA" no grupo "Caps Lock" da categoria "Teclado" das configurações globais do add-on.

4.7. Limitação da repetição de teclas

Quando uma tecla é pressionada e não solta rapidamente, o Windows gera uma série de pressionamentos da tecla que podem ser incômodos, especialmente em uma área de edição.

Este recurso tenta manter esse número de pressionamentos ao mínimo.

Ele é controlado pela caixa de seleção "Limitar repetições", que está no grupo "Repetição de pressionamentos" da categoria "Avançado" dos parâmetros globais do add-on, e pelo tempo de atraso de repetição que é configurado no mesmo grupo.

Quando essa opção está marcada, qualquer novo pressionamento da mesma tecla que ocorrer dentro de um intervalo menor que o atraso configurado é ignorado.

Por padrão, esta caixa está desmarcada e o atraso de espera está definido para 100 milissegundos.

Não é possível manter apenas o primeiro pressionamento da tecla porque o atraso com o próximo pressionamento é muito grande (cerca de 500 milissegundos).

Teclas modificadoras não são afetadas por essa limitação.

4.8. controle da tecla "mute"

Em certos teclados existem teclas multimídia e, em particular, a tecla "silenciar".

O acionamento dessa tecla corta ou restaura o volume do dispositivo de saída de áudio padrão do Windows (operação básica).

Se o NVDA utiliza esse dispositivo, um acionamento involuntário pode ser bastante incômodo.

Para evitar esse possível problema, o complemento propõe, por configuração e por perfil de configuração, controlar ou não o acionamento dessa tecla.

Na categoria "Teclado" das configurações de perfil, o grupo "Controle da tecla Mute" contém:

No caso de o volume já estar cortado, qualquer acionamento da tecla "mute" é tratado pelo Windows sem nenhum controle.

Nota: Para realizar esse controle, um script foi associado ao gesto de controle oculto (sem descrição) "KB: volumemute", que é instalado a cada carregamento de um perfil de configuração, desde que o controle esteja autorizado.

Se um aplicativo ou uma extensão de aplicativo também utilizar essa tecla "silenciar", basta criar um perfil de configuração para esse aplicativo e não autorizar o controle nesse perfil. A tecla deixará de ser um gesto de comando.

5. Outras melhorias

5.1. Explorar a pasta de configuração do usuário ou a pasta do programa nvda

Este add-on adiciona no menu "ferramentas" do NVDA um sub-menu "Explorar NVDA" que oferece duas opções:

Dois scripts, colocados na categoria "Extensão de comandos globais do NVDA" do diálogo "gestos de entrada" do NVDA, são fornecidos para executar essas mesmas ações, com as seguintes descrições:

Por padrão, nenhum gesto de entrada está associado a eles.

5.2. Apresentação da formatação de texto em um diálogo

Basicamente, uma dupla pressão do gesto de entrada "NVDA + f" apresenta as informações de formatação na forma de um documento HTML.

Este script tem como objetivo complementá-las e exibi-las em uma caixa de diálogo para que possam ser lidas usando as teclas de seta.

Ele é iniciado usando o comando "f" do interpretador.

A descrição do script é: "Exibir informações de formatação para a posição atual do cursor de revisão dentro de um documento em caixa de diálogo".

Está armazenado sob o título "Extensão de comandos globais do NVDA" no diálogo "gestos de entrada do NVDA".

Nenhum gesto de entrada é atribuído a ele por padrão.

5.3. Anúncio do texto de caixas de diálogo do tipo confirmação

O NVDA considera algumas caixas de diálogo, como caixas de confirmação, cujo texto que contêm é uma descrição.

Então, se a opção "Anunciar descrição do objeto" na categoria "Visão geral do objeto" do diálogo "Configurações" do NVDA não estiver marcada, o texto não é anunciado pelo NVDA.

Este add-on implementa a opção "Não levar em conta a opção chamada Reportar descrições de objeto durante a exibição da caixa de diálogo do tipo confirmação" na categoria "Avançado" do diálogo "Configurações" do add-on para forçar, se marcada, o anúncio do texto dessas caixas em todos os casos. Essa opção está marcada por padrão.

5.4. Execução de scripts no diálogo "Gestos de entrada"

O diálogo "Gestos de entrada" do NVDA permite configurar os gestos de entrada (atalhos de teclado, botões do display braille, etc.) para os scripts (chamados de comandos no manual do usuário do NVDA) disponíveis no momento. Para mais informações, veja o capítulo "Gestos de entrada" deste manual.

O add-on possibilita executar scripts nesse diálogo, mesmo que nenhum gesto de entrada esteja configurado.

Ele modifica esse diálogo adicionando o botão "Executar o script" quando um script está selecionado na visualização em árvore.

O script pode ser executado usando uma das três ações seguintes:

Ao repetir a ação várias vezes rapidamente, o script será executado tantas vezes.

5.4.1. Detalhes técnicos

Para alcançar essa funcionalidade, a função "onInputGesturesCommand" do "gui.mainFrame" e a ação acionada pelo submenu "Gestos de entrada" foram substituídas (alteração comum com a funcionalidade seguinte). Não é possível impedir isso.

5.5. Seleção automática da categoria no diálogo "Gestos de entrada"

Pode acontecer de precisarmos abrir o diálogo "Gestos de entrada" para saber os gestos de entrada fornecidos pelo add-on ativo para o aplicativo em foco.

Sem add-on, a primeira categoria é selecionada por padrão.

Para economizar tempo, o add-on traz a seleção da categoria associada ao add-on ativo para o aplicativo em foco.

Ele faz isso procurando a categoria entre as categorias que fornecem scripts pertencentes ao add-on ativo. Mas este último pode configurar scripts em qualquer categoria.

Essa categoria será então selecionada automaticamente e expandida.

5.5.1. Detalhes técnicos

Para alcançar essa funcionalidade, a função "onInputGesturesCommand" do "gui.mainFrame" e a ação acionada pelo submenu "Gestos de entrada" foram substituídas (alteração comum com a funcionalidade anterior). Não é possível impedir isso.

5.6. Seleção da última configuração usada no anel de configurações do sintetizador

Os gestos de entrada "NVDA + controle + seta direita ou esquerda" do NVDA permitem saltar de uma configuração para outra no anel de configurações do sintetizador.

Mas após reiniciar o NVDA, a última configuração usada é esquecida.

Essa melhoria tenta superar essa limitação.

Para isso, o add-on salva, a cada movimento no anel de configurações do sintetizador, a última configuração usada para cada sintetizador e para cada perfil de configuração.

Essa configuração será então selecionada novamente quando o NVDA iniciar para o sintetizador e para o perfil "configuração normal" ou quando houver troca de perfis.

Aviso: como todos os parâmetros do NVDA, é necessário que a configuração do NVDA seja salva antes de reiniciar o NVDA (seja automaticamente ou manualmente) para que sejam encontradas após o reinício.

5.7. Melhorias para o Windows Explorer

O add-on traz os seguintes scripts quando o cursor está na árvore de pastas:

5.7.1. Anúncio do caminho da pasta ou arquivo sob o cursor

Este script permite, quando o cursor está posicionado em um dos elementos da pasta n da árvore do Windows Explorer, que:

Nenhum gesto de entrada ou comando do interpretador é atribuído a ele por padrão.

A descrição do script é: "Anunciar o caminho reduzido da pasta ou arquivo sob o cursor do Windows Explorer. Dois pressionamentos: anunciar o caminho completo. Três pressionamentos: copiar o caminho completo para a área de transferência".

Está armazenado na seção "Extensão de comandos globais do NVDA" do diálogo "Gestos de entrada" do NVDA.

É possível associar um gesto de entrada a ele usando esse diálogo.

O número de pastas a manter para o caminho reduzido é configurável (veja o grupo "Windows Explorer" da categoria "Computador" das configurações globais do add-on. Por padrão, esse número é 4).

5.7.2. Anúncio, subindo na árvore de pastas, dos nomes das pastas que compõem o caminho da pasta que contém o elemento sob o cursor

Este script, assim como o que anuncia o caminho reduzido, permite localizar o elemento sob o cursor sem precisar ouvir todos os nomes das pastas que compõem o caminho completo.

Ao contrário do outro script, ele não é limitado pela configuração, ou seja, pelo número de pastas do caminho a manter.

Ele anuncia o nome das pastas que compõem o caminho no sentido oposto, ou seja, subindo na árvore de pastas. Esse anúncio pode ser interrompido a qualquer momento pressionando a tecla "Control".

Por exemplo, se o item selecionado está na pasta n, o NVDA anunciará na seguinte ordem:

A opção "Reportar nome da pasta do caminho invertido com nível" possibilita não anunciar o nível das pastas. Ela está no grupo "Windows Explorer" da categoria "Computador".

Nenhum gesto de entrada ou comando do interpretador é atribuído por padrão a este script.

A descrição deste script é: "Anunciar o caminho do arquivo ou pasta sob o cursor do Windows Explorer subindo na estrutura em árvore das pastas".

Está armazenado na seção "Extensão de comandos globais do NVDA" do diálogo "Gestos de entrada" do NVDA.

É possível associar um gesto de entrada a ele usando esse diálogo.

6. Resumo dos comandos fornecidos por este add-on

6.1. gestos de entrada instalados sistematicamente

Computador de mesa Laptop Toque Descrição
NVDA+j NVDA+j Nenhum Iniciar o interpretador de comandos do add-on
nvda+, nvda+, nenhum realizar um clique esquerdo único na posição do objeto do navegador. O segundo pressionamento faz um duplo clique
nvda+shift+, nvda+shift+, nenhum clique direito na posição do objeto do navegador. O segundo pressionamento faz um duplo clique

6.2. Seleção automática da categoria no diálogo "Gestos de entrada"

Pode acontecer de precisarmos abrir o diálogo "Gestos de entrada" para saber os gestos de entrada fornecidos pelo add-on ativo para o aplicativo em foco.

Sem add-on, a primeira categoria é selecionada por padrão.

Para economizar tempo, o add-on traz a seleção da categoria associada ao add-on ativo para o aplicativo em foco.

Ele faz isso procurando a categoria entre as categorias que fornecem scripts pertencentes ao add-on ativo. Mas este último pode configurar scripts em qualquer categoria.

Essa categoria será então selecionada automaticamente e expandida.

6.2.1. Detalhes técnicos

Para alcançar essa funcionalidade, a função "onInputGesturesCommand" do "gui.mainFrame" e a ação acionada pelo submenu "Gestos de entrada" foram substituídas (alteração comum com a funcionalidade anterior). Não é possível impedir isso.

6.3. Seleção da última configuração usada no anel de configurações do sintetizador

Os gestos de entrada "NVDA + controle + seta direita ou esquerda" do NVDA permitem saltar de uma configuração para outra no anel de configurações do sintetizador.

Mas após reiniciar o NVDA, a última configuração usada é esquecida.

Essa melhoria tenta superar essa limitação.

Para isso, o add-on salva, a cada movimento no anel de configurações do sintetizador, a última configuração usada para cada sintetizador e para cada perfil de configuração.

Essa configuração será então selecionada novamente quando o NVDA iniciar para o sintetizador e para o perfil "configuração normal" ou quando houver troca de perfis.

Aviso: como todos os parâmetros do NVDA, é necessário que a configuração do NVDA seja salva antes de reiniciar o NVDA (seja automaticamente ou manualmente) para que sejam encontradas após o reinício.

6.4. Melhorias para o Windows Explorer

O add-on traz os seguintes scripts quando o cursor está na árvore de pastas:

6.4.1. Anúncio do caminho da pasta ou arquivo sob o cursor

Este script permite, quando o cursor está posicionado em um dos elementos da pasta n da árvore do Windows Explorer, que:

Nenhum gesto de entrada ou comando do interpretador é atribuído a ele por padrão.

A descrição do script é: "Anunciar o caminho reduzido da pasta ou arquivo sob o cursor do Windows Explorer. Dois pressionamentos: anunciar o caminho completo. Três pressionamentos: copiar o caminho completo para a área de transferência".

Está armazenado na seção "Extensão de comandos globais do NVDA" do diálogo "Gestos de entrada" do NVDA.

É possível associar um gesto de entrada a ele usando esse diálogo.

O número de pastas a manter para o caminho reduzido é configurável (veja o grupo "Windows Explorer" da categoria "Computador" das configurações globais do add-on. Por padrão, esse número é 4).

6.4.2. Anúncio, subindo na árvore de pastas, dos nomes das pastas que compõem o caminho da pasta que contém o elemento sob o cursor

Este script, assim como o que anuncia o caminho reduzido, permite localizar o elemento sob o cursor sem precisar ouvir todos os nomes das pastas que compõem o caminho completo.

Ao contrário do outro script, ele não é limitado pela configuração, ou seja, pelo número de pastas do caminho a manter.

Ele anuncia o nome das pastas que compõem o caminho no sentido oposto, ou seja, subindo na árvore de pastas. Esse anúncio pode ser interrompido a qualquer momento pressionando a tecla "Control".

Por exemplo, se o item selecionado está na pasta n, o NVDA anunciará na seguinte ordem:

A opção "Reportar nome da pasta do caminho invertido com nível" possibilita não anunciar o nível das pastas. Ela está no grupo "Windows Explorer" da categoria "Computador".

Nenhum gesto de entrada ou comando do interpretador é atribuído por padrão a este script.

A descrição deste script é: "Anunciar o caminho do arquivo ou pasta sob o cursor do Windows Explorer subindo na estrutura em árvore das pastas".

Está armazenado na seção "Extensão de comandos globais do NVDA" do diálogo "Gestos de entrada" do NVDA.

É possível associar um gesto de entrada a ele usando esse diálogo.

7. Resumo dos comandos fornecidos por este add-on

7.1. gestos de entrada instalados sistematicamente

Computador de mesa Laptop Toque Descrição
NVDA+j NVDA+j Nenhum Iniciar o interpretador de comandos do add-on
nvda+, nvda+, nenhum realizar um clique esquerdo único na posição do objeto do navegador. O segundo pressionamento faz um duplo clique
nvda+shift+, nvda+shift+, nenhum clique direito na posição do objeto do navegador. O segundo pressionamento faz um duplo clique

2++ gestos de entrada instalados pelas funcionalidades ++

7.1.1. Exibição da lista de ícones na área de notificação e janelas dos aplicativos lançados

Computador de mesa Laptop Toque Descrição
NVDA+F11 NVDA+F11 Nenhum Mostra a lista de botões na Bandeja do Sistema. Duas vezes, exibe a lista das janelas dos aplicativos em execução com a possibilidade de colocar uma delas em primeiro plano ou encerrá-la

7.1.2. Ajuda na composição de símbolos complexos

Computador de mesa Laptop Toque Descrição
NVDA+shift+f4 NVDA+shift+f4 Nenhum Permite copiar ou digitar símbolo complexo

7.1.3. Informação sobre o aplicativo em foco

Computador de mesa Laptop Toque Descrição
NVDA+shift+f1 NVDA+shift+f1 Nenhum Informa o nome e a versão do aplicativo
NVDA+control+F1 NVDA+control+F1 Nenhum Fala o nome do arquivo do aplicativo ativo junto com o nome do arquivo python do appModule carregado atualmente. Pressionar esta tecla duas vezes fala o nome e estado do perfil de configuração atual

7.1.4. Extensão da funcionalidade do buffer virtual

Computador de mesa Laptop Toque Descrição
NVDA+alt+j NVDA+alt+j nenhum Informa as células da linha atual da tabela
NVDA+alt+l NVDA+alt+l nenhum Informa as células da coluna atual da tabela
NVDA+alt+seta para baixo NVDA+alt+seta para baixo nenhum Move para a próxima linha da tabela e informa
NVDA+seta para cima NVDA+seta para cima nenhum Move para a linha anterior da tabela e informa
NVDA+alt+seta para direita NVDA+alt+seta para direita nenhum Move para a próxima coluna da tabela e informa
NVDA+alt+seta para esquerda NVDA+alt+seta para esquerda nenhum Move para a coluna anterior da tabela e informa
NVDA+alt+numpad5 NVDA+alt+; nenhum Informa a posição atual da célula da tabela
control+alt+shift+seta para esquerda control+alt+shift+seta para esquerda nenhum Move para a primeira célula da linha da tabela
control+alt+shift+seta para direita control+alt+shift+seta para direita nenhum Move para a última célula da linha da tabela
control+alt+shift+seta para cima control+alt+shift+seta para cima nenhum Move para a primeira célula da coluna da tabela
control+alt+shift+seta para baixo control+alt+shift+seta para baixo nenhum Move para a última célula da coluna da tabela
NVDA+a NVDA+shift+a nenhum Informa o endereço do documento (URL). Duas vezes: copia para a área de transferência

7.1.5. Anúncio das caixas de diálogo de pré-seleção de pasta dos tipos Abrir, salvar, salvar como

Computador de mesa Laptop Toque Descrição
NVDA+o NVDA+o Nenhum Informa o nome da pasta selecionada atualmente na caixa de diálogo Abrir ou Salvar. Duas vezes: informa o caminho completo

7.1.6. Logs do NVDA

Computador de mesa Laptop Toque Descrição
NVDA+shift+j NVDA+shift+j Nenhum Abre o arquivo de log atual do NVDA. Pressionar essa tecla duas vezes abre o arquivo de log antigo do NVDA. Pressionar pela terceira vez copia o caminho do log atual para a área de transferência

7.1.7. Histórico de fala

Computador de mesa Laptop Toque Descrição
NVDA+control+f8 NVDA+control+f8 Nenhum Informa o registro anterior do histórico de fala e copia para a área de transferência
NVDA+control+f10 NVDA+control+f10 Nenhum Informa o próximo registro do histórico de fala e copia para a área de transferência
NVDA+control+f9 NVDA+control+f9 Nenhum Informa o registro atual do histórico de fala e copia para a área de transferência. Duas vezes: exibe o histórico de fala

7.1.8. Temporizador

Computador de mesa Laptop Toque Descrição
NVDA+shift+f12 NVDA+shift+f12 Nenhum Exibe diálogo para iniciar o temporizador de minutos. Se o temporizador já estiver iniciado, exibe diálogo para informar a duração

7.1.9. Reiniciar o NVDA

Computador de mesa Laptop Toque Descrição
NVDA+control+f4 NVDA+control+f4 Nenhum Reinicia o NVDA. Duas vezes: reinicia com nível de log definido para debug

7.1.10. Exibição dos elementos visíveis que compõem o objeto em primeiro plano

Computador de mesa Laptop Toque Descrição
NVDA+b NVDA+b Nenhum Lê todos os controles na janela ativa. Se pressionado duas vezes: exibe a lista dos itens visíveis que a compõem

7.1.11. Troca de perfil de voz

Computador de mesa Laptop Toque Descrição
nvda+shift+control+número do seletor nvda+shift+control+número do seletor Nenhum Define o seletor x como seletor atual e, se possível, define o perfil de voz associado a ele como perfil de voz atual (x equivale a número de 1 a 8)
nvda+shift+control+seta para direita nvda+shift+control+seta para direita Nenhum Avança para o próximo seletor associado a um perfil de voz e define esse perfil de voz como perfil de voz atual
nvda+shift+control+seta para esquerda nvda+shift+control+seta para esquerda Nenhum Retrocede para o seletor anterior associado a um perfil de voz e define esse perfil de voz como perfil de voz atual
nvda+shift+control+m nvda+shift+control+m Nenhum Exibe diálogo para gerenciar seletores de perfil de voz (comando: v)
nvda+shift+control+p nvda+shift+control+p nenhum Ativa ou desativa o modo de troca de perfil de voz

7.1.12. Data e hora - acréscimos

Computador de mesa Laptop Toque Descrição
NVDA+F12 NVDA+F12 nenhum Informa a hora atual. Duas vezes, informa a data atual. Terceira vez: copia data e hora para a área de transferência

7.1.13. Análise de texto

Computador de mesa Laptop Toque Descrição
NVDA+shift+f6 NVDA+shift+f6 nenhum Analisa a palavra sob o cursor
NVDA+control+f6 NVDA+control+f6 nenhum Analisa a linha sob o cursor
NVDA+windows+f6 NVDA+windows+f6 nenhum Analisa a frase sob o cursor
NVDA+shift+control+f6 NVDA+shift+control+f6 nenhum Analisa o parágrafo sob o cursor