Extension des commandes de base de NVDA - manuel utilisateur

Auteur : paulber19

URL : paulber19@laposte.net

Dépot GitHub : https://github.com/paulber19/NVDAExtensionGlobalPlugin.git

Téléchargement :

Compatibilité :

Traducteur (s) : auteur de l'extension

Sommaire

1. Introduction

1.1. Généralités

Cette extension ajoute aux commandes globales de NVDA :

1.2. Menu de configuration de l'extension

Dans le sous-menu "Préférences" de NVDA est ajouté le sous-menu "Extension des commandes de base de NVDA" qui propose suivant le cas, les choix suivants :

Cette configuration est enregistrée de deux manières suivant la fonctionnalité ou l'options concernée :

NVDA offre l'option "Sauvegarder la configuration en quittant" (voir manuel utilisateur de NVDA) qui permet de sauvegarder automatiquement la configuration de NVDA en quittant ou en redémarrant NVDA. Si cette option n'est pas cochée, la configuration n'est sauvegardée que sur action de l'utilisateur ou sur modification concernant un paramètre nécessitant le redémarrage de NVDA.

Cette extension suit ce mode de fonctionnement.

Certaines modifications de paramètres de l'extension nécessitent la sauvegarde de la configuration et le redémarrage de NVDA. Dans ce cas, il est proposé à l'utilisateur la sauvegarde et le redémarrage immédiat comme le fait NVDA lorsqu’il y a changement du langage.

Lors de la désinstallation de l'extension, son fichier de configuration est supprimé et la configuration de l'extension est effacée de tous les profils de configuration.

Lors de la désinstallation d'une fonctionnalité, sa configuration, s’il y a, est complétement supprimée.

Dans le cas d'une mise à jour, l'installation de l'extension offre la possibilité de conserver (dans la mesure du possible) ou non la précédente configuration.

À l'aide du sous-menu "Réinitialiser la configuration", il est possible de remettre la configuration dans le même état que lors de la première installation de l'extension, y compris celle enregistrée dans les profils de configuration.

Cela permet de repartir à zéro sans avoir besoin de désinstaller et réinstaller l'extension en cas de problème éventuels

1.3. Mise à jour

La mise à jour de l'extension se fait, par défaut, automatiquement peu de temps après le démarrage de NVDA (entre 20 et 600 secondes) et au maximum une fois par jour

Il est possible de désactiver cette mise à jour en décochant l'option "Rechercher automatiquement les mises à jour" se trouvant dans la catégorie "Mise à jour». La version de l'extension peut être :

Par défaut, une version stable est mise à jour avec une version stable plus récente (numéro de version supérieur).

Mais il est possible de mettre à jour la version stable courante avec une version de développement de la prochaine version stable. Il suffit de cocher l'option "Mettre aussi à jour les versions stable vers les versions de développement " situé dans la catégorie "Mise à jour".

Une version de développement est mise à jour :

Le bouton "Rechercher une mise à jour" placé dans la catégorie "Mise à jour" vous permet de rechercher immédiatement une mise à jour.

Le bouton "Voir l'historique", placé dans cette même catégorie, vous permet d'afficher l'historique de la version actuelle dans le navigateur.

Dans le cas d'une mise à jour automatique et si une nouvelle version est détectée, la boite de dialogue "Mise à jour" s'affiche pour proposer :

Dans le cas d'une mise à jour vers une version stable, Le bouton "Quoi de neuf" offre la possibilité d'ouvrir, dans le navigateur, l'historique de l'extension et ainsi pouvoir connaitre les nouveautés de la version proposée.

1.4. Fonctionnement en Mode sécurisé

Dans ce mode, le fonctionnement de l'extension est dégradé.

Comme NVDA, il n'est pas possible d'enregistrer les modifications de configuration.

Certaines fonctionnalités ne sont plus disponibles, comme par exemple :

1.5. Compatibilité

La configuration de la fonctionnalité "Commutation de profil vocal" ayant changée, celle-ci est effacée lors d'une mise à jour à partir d'une version de l'extension plus ancienne que la 9.0. Tous les sélecteurs sont libérés et les profils vocaux associés sont supprimés.

1.6. Historique

L'historique des versions de cette extension est dans le fichier "changes.html"

2. Fonctionnalités

2.1. Préambule

2.1.1. Installation d'une fonctionnalité

Cette extension permet d'installer ou ne pas installer telle ou telle fonctionnalité. L'état d'installation de chaque fonctionnalité de l'extension est présenté dans la catégorie "Installation des fonctionnalités" du dialogue "Paramètres.

Cet état peut être :

Par défaut, cette extension n'installe pas toutes les fonctionnalités.

2.1.2. Activation des scripts

En général, chaque script peut être activé de deux manières :

Dans la boite de dialogue "Gestes de commande " de NVDA, les scripts apportés par l'extension sont placées dans leur propre catégorie. La grande majorité des scripts se répartit dans les catégories : "Extension des commandes de base de NVDA", "Commutation de profil vocal", "Configuration", "Outils" et Parole.

Pour les scripts pouvant être lancés par une commande de l'interpréteur, celle-ci est indiquée à la suite de la description du script.

Suivant le choix d'installation d'une fonctionnalité ("Installer, " ou "Installer sans geste de commande"), les gestes de commande prévus par défaut sont attribués ou non aux scripts de cette fonctionnalité.

Par défaut, la grande majorité des scripts pouvant être lancés par l'interpréteur de commandes ne sont affectés à aucun geste de commande.

2.1.3. Interpréteur de commandes

Celui-ci se lance à l'aide du geste de commande "NVDA+j". Un bip sonore est alors audible.

Il est alors possible d'activer les scripts des fonctionnalités à l'aide de commandes.

Aujourd'hui, ces commandes ne sont pas modifiables.

La commande "h" de l'interpréteur liste l'ensemble des scripts des fonctionnalités installées accessible par une commande de l'interpréteur. Dans cette liste, il est possible de lancer le script sélectionné en appuyant sur la touche "Entrée".

La commande "g" de l'interpréteur ouvre le manuel d'utilisation de l'extension.

L'interpréteur de commandes s'arrête soit :

2.2. Affichage de la liste des icônes de la zone de notification et de la liste des fenêtres des applications lancées

Cette fonctionnalité est, par défaut, installée avec gestes de commande.

Elle ajoute les scripts suivants :

Ces scripts sont rangés dans la catégorie "Extension des commandes de base de NVDA" du dialogue "Gestes de commande" de NVDA.

2.2.1. Affichage de la liste des icônes de la zone de notification

Ce script initialement créé par Yannick Maillot et Daniel Poiraud s'installait à l'aide de l'extension indépendant "ListeIconesZoneNotification_v1.2.nvda-addon" qu'il faudra donc désinstaller.

Sa description est : "Afficher la liste des icônes de la zone de notification"

Il se lance par la commande "F11" de l'interpréteur de commande. Il est le pendant du script de Jaws "Insert + f11".

Aucun geste de commande ne lui est affecté par défaut.

Il affiche une boite de dialogue qui contient :

La navigation dans la boite de dialogue se fait par "Tab" ou majuscule + Tab" et dans la liste avec les flèches de direction haut et bas.

L'appui sur la touche "Échap" permet de refermer la boite de dialogue.

Dans la liste des icônes, l'appui sur la touche "Entrée" déclenche l'appui sur le bouton "Simple clic gauche".

2.2.2. Affichage de la liste des fenêtres des applications en cours d'exécution

La description de ce script est : "Afficher la liste des fenêtres des application lancées avec la possibilité de basculer vers l'une d'entre elles ou de la détruire" :

Il est le pendant du script de Jaws "Insert + f10".

Il se lance par la commande "F10" de l'interpréteur de commande.

Aucun geste de commande ne lui est affecté par défaut.

Il affiche une boite de dialogue qui contient :

La navigation dans la boite de dialogue se fait par "Tab" ou majuscule + Tab" et dans la liste avec les flèches de direction haut et bas.

Dans la liste, il est possible de sélectionner en tapant le début du titre de la fenêtre désirée.

L'appui sur la touche "Echap" permet de refermer la boite de dialogue.

Dans la liste, les fenêtres sont signalées comme agrandies ou réduites.

L'appui sur le bouton "Basculer vers" ou la touche "Entrée" quand on est dans la liste des fenêtres , ferme la boite de dialogue et amène au premier plan la fenêtre de l'application sélectionnée en lui donnant le focus.

L'appui sur le bouton "Détruire" provoque la fermeture de la fenêtre de l'application sélectionnée et le retour du focus dans la liste réactualisée des fenêtres des applications.

L'appui sur le bouton "Détruire tout" provoque la fermeture de toutes les fenêtres et celle de la boite de dialogue.

2.2.3. Affichage de la liste des icônes de la zone de notification ou des fenêtres des applications lancées

La description de ce script est : - "Afficher la liste des icônes de la zone de notification. Deux appuis : Afficher la liste des fenêtres des application en cours d'exécution lancées avec la possibilité de basculer vers l'une d'entre elles ou de la détruire".

Par défaut, Le geste de commande "NVDA + F11" lui est affecté.

Aucune commande interpréteur ne lui est attribuée.

Un simple appui du geste de commande "NVDA + F11" lance le script "Affichage de la liste des icônes de la zone de notification" (voir ci-dessus).

Un double appui lance le script "Affichage de la liste des fenêtres des application lancées " (voir ci-dessus).

2.3. Aide à la composition de symboles complexes

Cette fonctionnalité est par défaut, installée sans geste de commande.

Elle ajoute les deux scripts suivants :

Ces scripts sont rangés dans la rubrique "Extension des commandes de base de NVDA" du dialogue "Gestes de commande" de NVDA.

2.3.1. Script Composer un symbole complexe comme par exemple une voyelle accentuée, un symbole mathématique

Ce script se lance :

Il affiche la boite de dialogue "Aide à la composition de symboles complexes" constituée de :

On se déplace dans la boite de dialogue par "Tab" ou "Majuscule + Tab".

L'appui sur la touche "Échap" referme la boite de dialogue.

Quand on est dans la liste des catégories, l'appui sur la touche "Entrée" ou "Tab" amène le focus sur la liste des symboles de la catégorie sélectionnée.

Ces symboles sont listés suivant l'ordre du fichier "symbolCategories.dic"(voir plus loin).

Par contre, si on est dans la liste des symboles et qu'un symbole est sélectionné, l'appui sur la touche "Entrée" provoque l'appui sur le bouton "Coller".

Positionné sur un symbole, l'appui sur la touche "Espace" provoque la vocalisation du code du symbole sous la forme : code en décimal suivi du code en hexadécimal épelé. Cela peut vous servir si vous voulez composer manuellement le symbole par la commande Windows "Alt + 0" suivi du code décimal composé sur le clavier numérique.

L'appui sur l'un des trois boutons ferme la boite de dialogue.

Le bouton "Gérer ses symboles" présente la boite de dialogue qui offre la possibilité de compléter les catégories de base de l'extension par ses propres symboles. Cette boite de dialogue affiche :

Les lignes vides ou de commentaire (commençant par "#") sont acceptées. Ces fichiers sont conservés lors d'une mise à jour de l'extension, même si l'utilisateur demande à ne pas conserver ses propres paramètres. L'installation de l'"extension ajoute, pour chaque langue, la prononciation de certains symboles se trouvant dans les catégories de base et que NVDA n'a pas. Le fichier "symboles-xx.dic" du dossier userConfig est soit créé, soit modifié pour y ajouter les nouvelles prononciations.

2.3.2. Script Afficher la liste des derniers symboles complexes composés

Cette extension mémorise les 20 derniers symboles composés pour le profil de configuration courant.

Ce script permet de les faire afficher et de recomposer un symbole couramment utilisé. Cela évite d'aller le rechercher dans sa catégorie avec le script précédent.

Ce script se lance par la commande contrôle+f4 " de l'interpréteur de commande, Aucun geste de commande ne lui est affecté par défaut.

Il présente le même genre de boite de dialogue que le script précédent sans le bouton pour gérer ses propres symboles.

Le nombre maximum de derniers symboles est configurable avec l'option "Nombre maximum de derniers symboles composés enregistrés" placé dans la catégorie "Avancés" du dialogue "Paramètres" de l'extension.

2.4. Informations sur l'application sous le focus

Cette fonctionnalité est installée par défaut sans geste de commande.

Elle installe, suivant son état d'installation, les scripts suivant :

Et dans tous les cas, les scripts :

Ces scripts sont rangés dans la rubrique "Outils" du dialogue "Gestes de commande" de NVDA.

2.4.1. Annonce du nom du fichier de l'application, du nom de l'extension activée et du nom et de l'état du profil de configuration

La description de ce script est : "Annoncer le nom de fichier de l'application en cours ainsi que le nom du module python chargé. Deux appuis : annoncer le nom et l'état du profil de configuration".

Par défaut, le geste de commande "NVDA+ contrôle +F1 " lui est affecté.

Un simple appui du geste de commande déclenche le script de base de NVDA qui annonce le nom du fichier de l'application et s'il y a, le nom du fichier de l'extension activée.

Un double appui annonce le nom du profil de configuration et son état.

2.4.2. Annonce du numéro de version de l'application sous le focus

La description de ce script est : "Annoncer le nom et le numéro de version de l'application sous le focus".

Par défaut, le geste de commande "NVDA + majuscule + f1 " lui est affecté.

Le geste de commande déclenche l'annonce du nom et du numéro de version de l'application placée sous le focus.

2.4.3. Affichage des informations sur l'application sous le focus

La description de ce script est : "Afficher les informations sur l'application sous le focus".

Il se lance par la commande "a" de l'interpréteur.

Par défaut, Aucun geste de commande ne lui est affecté.

Il affiche la boite de dialogue "Extension des commandes de base de NVDA - Informations" qui présente les informations suivantes :

2.4.4. Affichage du nom et du numéro de version de l'extension

La description de ce script est : "Annoncer le nom et le numéro de version de l'extension activée pour l'application sous le focus".

Par défaut, Aucun geste de commande ne lui est affecté, ni aucune commande interpréteur.

2.5. Extension des fonctionnalités du tampon virtuel

Cette fonctionnalité est installée par défaut.

Elle concerne les navigateurs Mozilla Firefox , Microsoft Internet Explorer, Google Chrome, Microsoft Edge(partiellement) et apporte :

2.5.1. Nouvelles commandes de navigation

Cette extension ajoute les commandes suivantes pour le mode de navigation :

Sauf les quatre premières, ces commandes ne sont pas implémentées dans le navigateur Microsoft Edge.

2.5.2. Nouveaux types d'élément pour le script "NVDA + f7"

De base, le script intégré à NVDA et déclenché par le geste de commande "NVDA + f7", permet d'afficher la boite de dialogue "Liste d'éléments" présentant la liste de certains éléments présents dans une page Web. Cette extension augmente le nombre de types d'éléments pouvant être choisis et affiche dans le titre dudialogue, le type sélectionné.

La liste de ces types devient :

Types de base :

Types ajoutés par l'extension :

Ces types sont présentés sous forme de liste au lieu de bouton radio (dans la version de base). Un type peut être atteint en tapant la première lettre de son libellé. Il est possible de revenir à cette liste par le raccourci "alt + t". A chaque changement de type, Le nombre d'éléments trouvés est annoncé ou si aucun élément n'est trouvé, l'indication vocale "aucun élément" est diffusée.

Un bip sonore répétitif est audible pendant la recherche des éléments.

L'état "coché" ou non coché" est signalé pour les cases à cochées.

Le type "zone d'édition" donne la liste des zones d'édition du document, et chaque élément est présenté vocalement comme suit :

De même chaque champ de formulaire est présenté vocalement en fonction de son type

2.5.3. Scripts pour les tableaux

Pour les navigateurs Microsoft Internet Explorer, Microsoft Edge, Mozilla Firefox, GoogleChrome, il est possible quand le curseur se trouve sur une cellule de tableau de :

Tous ces scripts sont rangés dans la catégorie "Tableau" dans l'arborescence du dialogue "Gestes de commandes" de NVDA.

Cette extension déplace aussi dans cette catégorie les scripts de base de NVDA qui étaient rangés dans la catégorie "Divers". Ce sont :

2.5.4. Annonce de l'adresse du document

Le geste de commande "NVDA+a", (ordinateur de bureau) ou "NVDA+majuscule+a" (ordinateur portable) tapé dans les navigateurs Mozilla FireFox, Microsoft Internet Explorer, Microsoft Edge ou Gooble Chrome, annonce l'adresse (URL) du document. Avec un double appui, cette adresse est copiée dans le presse-papier.

2.5.5. Navigation en boucle

En mode navigation, la recherche de l'élément suivant ou précédent s'arrête à la fin ou au début du document.

Cette extension ajoute, en option, la possibilité de parcourir cycliquement le document, c'est à dire :

Le passage par le début ou la fin du document est signalé par un son et un message vocal.

L'option "Navigation en boucle" de la catégorie "Compléments à NVDA" du dialogue "Paramètres" de l'extension permet d'activer ou désactiver ce fonctionnement.

Cette option n'est présentée que si la fonctionnalité "Extension des fonctionnalités du tampon virtuel" est installée.

Par défaut, cette option n'est pas cochée. Le fonctionnement de base de NVDA est conservé.

2.6. Annonce de la fonction associée aux commandes d'édition du style "copier", "Coller"

Cette fonctionnalité est installée par défaut.

Les fonctions déclenchées par les raccourcis "contrôle + v", "contrpôle + c", "contrôle + x", "contrôle + z" n'étant pas vocalisées par NVDA, cette extension s'en charge.

Aucun contrôle sur le résultat de la fonction n'est fait. Mais pour les raccourcis "contrôle + c", "contrôle + x", l'absence de sélection de texte est signalée dans les arborescences et les listes.

Si l'extension fakeClipboardAnnouncement est installée (qui réalise la même fonction), il faut le désinstaller.

2.7. Annonce du dossier sélectionné dans les boites de dialogue du style "Ouvrir", "Enregistrer", "Enregistrer sous"

Cette fonctionnalité est installée par défaut sans geste de commande.

Elle ajoute, pour les boites de dialogue du style "Ouvrir", "Enregistrer", "Enregistrer sous", "Chercher dans", des scripts qui permettent de connaitre le nom et le chemin du dossier qui est sélectionné pour définir l'emplacement ou le fichier sera rechercher où enregistrer.

Ces scripts sont rangés dans la catégorie "Extension des commandes de base de NVDA" du dialogue "Gestes de commande" de NVDA. Ce sont :

Aucun geste de commande n'est associé aux deux derniers scripts, mais il est possible de leur en associer un à l'aite du dialogue "Geste de commandes" de NVDA.

Attention, ces scripts ne fonctionnent que dans des boites de dialogue conforme au standard Windows.

2.8. Journaux de NVDA

Cette fonctionnalité est par défaut, installée sans geste de commande.

Elle ajoute les scripts :

Les scripts sont rangés dans la catégorie "Outils" du dialogue "Gestes de commandes" de NVDA.

2.8.1. Gestion des journaux de NVDA

La description de ce script est : "Afficher le dialogue pour gérer les journaux de NVDA".

Il se lance à l'aide de la commande "j" de l'interpréteur. Aucun geste de commande ne lui est affecté par défaut.

Ce script affiche la boite de dialogue "Gestion des journaux de NVDA" présentant :

Le journal s'ouvre dans le programme associé à l'extension .log. Si il n'y a pas encore l'association d'un programme avec cet extension, vous devrez la définir (choisissez le bloc-notes par exemple).

2.8.2. Ouverture des journaux de NVDA

La description de ce script est : "Ouvrir le journal courant de NVDA. Deux appuis : ouvrir son ancien journal. Trois appuis : copier le chemin du journal courant dans le presse-papier".

Il se lance à l'aide du geste de commande "NVDA+majuscule+j " qui lui est affecté par défaut.

Un simple appui déclenche l'ouverture du journal courant de NVDA.

Un double appui, l'ouverture de l'ancien journal.

Un triple appui, la copie du chemin du journal courant dans le presse-papier.

Le journal s'ouvre dans le programme associé à l'extension .log. Si il n'y a pas encore l'association d'un programme avec cet extension, vous devrez la définir (choisissez le bloc-notes par exemple).

2.9. Historique des annonces vocales

Cette fonctionnalité est installée par défaut sans geste de commande. Afin de pouvoir réécouter des annonces vocales mal comprises ou mal entendues, cette extension enregistre un historique limité des annonces envoyées au synthétiseur. Le nombre d'enregistrements est limité à 200.

Pour réécouter ces enregistrements, les scripts suivants, rangés dans la catégorie "Parole" du dialogue "Gestes de commande" de NVDA, sont apportés par cette fonctionnalité :

2.9.1. Annonce du précédent enregistrement

Ce script se lance à l'aide du geste de commande, "NVDA+contrôle+f8" affecté par défaut.

Le geste de commande déclenche l'annonce du précédent enregistrement par rapport au dernier enregistrement annoncé et le copier dans le presse-papier.

2.9.2. Annonce de l'enregistrement suivant

Ce script se lance à l'aide du geste de commande, "NVDA+contrôle+f10" affecté par défaut.

Le geste de commande déclenche l'annonce de l'enregistrement suivant par rapport au dernier enregistrement annoncé et le copier dans le presse-papier

2.9.3. Ré annoncer le dernier enregistrement annoncé

La description de ce script est : "Annoncer l'enregistrement courant de l'historique des annonces vocales et le copier dans le presse-papier. Deux appui : afficher tout l'historique".

Ce script se lance à l'aide du geste de commande, "NVDA+contrôle+f9" affecté par défaut.

Un simple appui déclenche l'annonce du dernier enregistrement annoncé et sa copie dans le presse-papier

Un double appui, affiche tout l'historique.

2.9.4. Afficher l'historique vocal

La description de ce script est : "Afficher les enregistrements de l'historique vocal".

Ce script se lance à l'aide de la commande "f9" de l'interpréteur. Aucun geste de commande ne lui est affecté par défaut.

Il présente la boite de dialogue "Historique des annonces vocales" qui liste ces enregistrements dans l'ordre décroissant de leur ancienneté. Un bouton permet de copier dans le presse-papier l'enregistrement sélectionné.

Par défaut :

2.10. Renommage des touches clavier

Cette fonctionnalité est installée par défaut.

Elle permet de renommer certaines touches du clavier comme "Verrouillage majuscule" ou "Verrouillage numérique" à l'aide d'une boite de dialogue qui présente :

Lorsqu'un libellé de remplacement est défini pour la touche sélectionnée, la zone d'édition en lecture seule et atteignable par "Tab", affiche ce libellé de remplacement. Ce libellé est annoncé lorsque le focus arrive sur la touche.

Le bouton "Effacer" permet de supprimer ce libellé de remplacement.

Il est possible aussi de supprimer ce libellé en entrant une chaine vide ou pleine de blanc dans la boite de saisie.

Le bouton " Supprimer tout" permet de supprimer tous les libellés de remplacement pour revenir aux libellés de base prévu par NVDA.

Le bouton "OK" permet d'appliquer les remplacements et d'enregistrer les touches clavier et leur libellé de remplacement dans le fichier de configuration de l'extension dans la section "RedefinedKeyLabels" et la sous-section correspondant au langage de NVDA ("fr" par exemple pour le Français). Il est ainsi possible d'avoir des renommages de touches pour différentes langues.

Pour afficher ce dialogue, trois possibilités :

Il est possible de ne pas installer cette fonctionnalité en sélectionnant, dans la catégorie "Fonctionnalités installées" et pour la fonctionnalité "Renommage des touches clavier", l'état "Ne pas Installer".

2.11. Annonce sélective des touches de commandes

Cette fonctionnalité est installée par défaut.

NVDA permet de faire annoncer vocalement les touches de commandes à l'aide de l'option "Dire les touches de commandes" située dans la catégorie "clavier" du dialogue "Paramètres" de NVDA ou par la commande clavier "NVDA+4".

Cette fonctionnalité apporte, par configuration et à l'aide d'une boite de dialogue, la possibilité de :

Pour afficher ce dialogue, trois possibilités :

Le dialogue présente :

Un appui sur la barre d'espace coche ou décoche la touche ou la combinaison sélectionnée.

Si la case "Dire les touches de commandes" de la boite de dialogue n'est pas cochée, le fait de cocher une touche permet de faire annoncer quand même cette touche lorsque NVDA est configuré à ne pas les annoncer.

La liste des combinaisons de touches de modification est alors accessible et tous les éléments de cette liste sont cochés par défaut.

Pour ne pas que la touche tapée avec une combinaison particulière soit annoncer, il suffit de décocher cette combinaison.

Si l'élément "aucune" de la liste des combinaisons est coché, la touche sera annoncée même frappée sans combinaison de touche de modification.

Par contre, si la case à cocher "Dire les touches de commande" est cochée, le fait de cocher une touche permet de ne pas faire annoncer cette touche lorsque NVDA est configuré à les annoncer.

La liste des combinaisons de touches de modification est alors accessible et tous les éléments de cette liste sont cochées par défaut. Cela signifie que la touche tapée avec ou sans combinaison ne sera pas annoncée.

L'action de décocher une combinaison permet alors de faire annoncer la touche avec cette combinaison.

L'élément "aucune" de la liste des combinaisons permet de ne pas faire annoncer la touche même frappée sans combinaison de touches de modification.

Les boutons "Décocher tout" et "Cocher tout" permettent de décocher ou cocher la totalité des éléments de la liste des combinaisons de touche de modification.

Le premier élément "toute touche avec combinaison de touches de modification" de la liste des touches permet, sans désigner une touche particulière, de sélectionner un ensemble de combinaisons de touches de modification. Toute touche tapée avec une de ces combinaisons sera, suivant le mode de configuration choisi, annoncée ou non.

Le bouton "OK" enregistre les choix faits pour le profil de configuration courant, tandis que le bouton "Annuler" les oublie.

Dans les listes, la touche "F2" et la combinaison de touche "majuscule+F2" permettent de se déplacer respectivement à l'élément coché suivant ou précédent.

Il est possible de ne pas installer cette fonctionnalité en sélectionnant, dans la catégorie "Fonctionnalités installées" et pour la fonctionnalité "Annonce sélective des touches de commande", l'état "Ne pas Installer».

2.12. Minuterie

Cette fonctionnalité est installée par défaut.

Elle permet de lancer une minuterie pour une durée programmable. A L'échéance de la minuterie une boite de dialogue apparait en affichant une annonce programmable et l'émission d'une sonnerie.

Elle installe un script qui se lance :

Si la minuterie est arrêtée, le script affiche la boite de dialogue "Lancement de la minuterie" qui présente :

La durée, l'annonce et le délai pour être averti avant l'échéance de la minuterie sont enregistrés à chaque lancement de la minuterie et affichés par défaut au lancement suivant de celle-ci.

Si la minuterie est en cours, le script affiche alors la boite de dialogue "Minuterie en cours" permettant de connaitre la durée restante de la minuterie et éventuellement d'arrêter la minuterie.

La durée est réactualisée toute les 5 secondes et est annoncée quand le focus se trouve dans la zone d'édition (en lecture seule) l'affichant.

Cette boite de dialogue se ferme automatiquement à l'échéance de la minuterie.

2.13. Redémarrage de NVDA

Cette fonctionnalité n'est pas installée par défaut.

Elle installe un script qui permet de redémarrer NVDA en niveau de journalisation débogage sans modifier la configuration de NVDA.

La description de ce script est : "Redémarrer NVDA. Deux appuis : redémarrer en niveau de journalisation débogage".

Il est rangé dans la catégorie "Divers" du dialogue "Gestes de commandes" de NVDA.

Le geste de commande "NVDA+contrôle+f4 " lui est affecté par défaut.

Un simple appui de ce geste déclenche le redémarrage de NVDA avec le niveau de journalisation configuré dans les préférences générales.

Un double appui de ce geste de commande redémarre NVDA avec le niveau de journalisation débogage sans modifier le niveau de journalisation configuré dans les préférences générales de NVDA.

2.14. Affichage des éléments visibles de l'objet en avant plan

Par défaut, cette fonctionnalité est installée avec geste de commande.

Elle installe deux scripts rangés dans la catégorie "Focus système" du dialogue "Gestes de commande" de NVDA :

2.14.1. Affichage des éléments visibles de l'objet sous le focus

La description de ce script est : "Afficher les éléments visibles composant l'objet en avant plan".

Il se lance à l'aide de la commande "b" de l'interpréteur.

Aucun geste de commande ne lui est attribué.

Le script lance la recherche de ces éléments. Celle-ci peut prendre un temps conséquent. Un signal sonore toute les deux secondes est émis pendant cette recherche.

Pour limiter ce temps de recherche, des limites sont mise en place pour certains types d'éléments :

La recherche terminée, les éléments sont affichés dans la boite de dialogue "List des éléments visibles composant l'objet en avant plan", suivant leur type.

Cette boite de dialogue présente :

Dans la liste des éléments, il est possible de changer le type des objets à lister sans quitter la liste :

Toujours dans cette liste, il est possible d'atteindre un élément en tapant les premières lettres de son étiquette.

Pour un élément de type :

2.14.2. Annonce ou affichage des éléments visibles de l'objet sous le focus

La description de ce script est : "Dire l'objet en avant-plan. Deux appuis : afficher les éléments visibles composant l'objet en avant plan". Il se lance à l'aide du geste de commande "NVDA+b " qui lui est affecté par défaut.

Un simple appui lance le script de base de NVDA qui annonce tous les objets de l'objet en avant plan.

Un double appui lance le script précédent "Affichage des éléments visibles de l'objet en avant plan".

2.15. Commutation rapide de profil vocal

Cette fonctionnalité est installée par défaut sans geste de commande.

Elle permet de changer rapidement de profil vocal en donnant la possibilité de mémoriser jusqu'à 8 profils vocaux et de sélectionner rapidement un de ces profils vocaux.

Un profil vocal est défini par :

Elle installe les scripts suivants rangés dans la catégorie "Commutation de profil vocal" du dialogue "Gestes de commande" de NVDA :

2.15.1. Gestion des sélecteurs de profil vocal

La description de ce script est : "Afficher le dialogue pour gérer les sélecteurs de profil vocal".

Il se lance :

Ce script affiche la boite de dialogue "Gestion des sélecteurs de profil vocal du profil de configuration NomDuProfil" (où NomDuProfil est le nom du profil de configuration déclenché).

Cette boite de dialogue permet de gérer l'association sélecteur- profil vocal et présente :

La liste "Sélecteurs" présentent la liste des sélecteurs libres ou associés à un profil vocal. Les sélecteurs associés sont :

Si le sélecteur sélectionné est un sélecteur associé sous le profil de configuration normal, il n'est alors pas possible de le libérer, mais il peut être associé au profil courant. Seuls les sélecteurs associés sous le profil de configuration courant peuvent être libérés.

2.15.2. Mode "Commutation de profil vocal"

Pour changer rapidement de profil vocal, le mode "Commutation de profil vocal" est mis en place et un script permet de l'activer ou le désactiver.

La description de ce script est : "Activer ou désactiver le Mode commutation de profil vocal".

Pour lancer ce script, deux possibilités :

Ce mode activé, les flèches droite ou gauche permettent de se déplacer au premier sélecteur suivant ou précédent associé à un profil vocal et ainsi définir le profil vocal associé à ce sélecteur comme profil vocal courant.

Les sélecteurs prisent en compte sont les sélecteurs de la liste "Sélecteurs" qui sont associés à un profil vocal.

2.15.3. Choix du Sélecteur de profil vocal précédent

La description de ce script est : "Aller au premier sélecteur précédent associé à un profil vocal et définir ce profil vocal comme profil vocal courant".

Il se lance à l'aide du geste de commande "nvda+majuscule+contrôle+Flèche gauche" qui lui affecté par défaut.

Le script recherche, dans la liste "Sélecteurs", le premier sélecteur précédent le sélecteur courant associé à un profil vocal. Puis il positionne ce profil vocal comme profil vocal courant.

2.15.4. Choix du Sélecteur de profil vocal suivant

La description de ce script est : "Aller au premier sélecteur suivant associé à un profil vocal et définir ce profil vocal comme profil vocal courant".

Il se lance à l'aide du geste de commande "nvda+majuscule+contrôle+Fèche droite" qui lui affecté par défaut.

Le script recherche, dans la liste "Sélecteurs", le premier sélecteur de profil vocal suivant le sélecteur courant associé à un profil vocal. Puis il positionne ce profil vocal comme profil vocal courant.

2.15.5. Choix du sélecteur de profil vocal par son numéro

8 scripts sont installés. La description de ces scripts est : «Positionner le sélecteur x comme sélecteur courant et définir, si possible, son profil vocal associé comme profil vocal courant" (où x est le numéro du sélecteur).

Chaque script se lance à l'aide du geste de commande "nvda+majuscule+contrôle+ numéro du sélecteur" affecté par défaut.

Le script sélectionne le sélecteur x et s'il est associé à un profil vocal, positionne ce profil vocal comme profil vocal courant.

2.15.6. Annonce ou affichage des paramètres vocaux courants

Les 3 scripts suivants permettent de connaitre les paramètres vocaux actuels sans avoir besoin d'utiliser le menu "Parole" de NVDA.

Ils sont rangés dans la catégorie "Parole" du dialogue "Gestes de commandes" de NVDA et sont installés même si la fonctionnalité "Commutation de profil vocal" n'est pas installée.

Aucun geste de commande ne leur sont associé, mais il est possible de leur en attribuer un à chacun.

Leurs descriptions sont :

2.16. Rémanence des touches NVDA et de modification

Cette fonctionnalité n'est pas installée par défaut.

Elle permet de rendre rémanente les touches NVDA ("Insert" du pavé numérique normal ou étendu, la touche "Verrouillage majuscule") et les touches de modification ("majuscule", "contrôle", "Alt gauche", "Contrôle Alt droit", "Windows").

L'objectif étant de pouvoir n'utiliser qu'un seul doigt par exemple pour composer un geste de commande nécessitant l'appui sur plusieurs touches.

Elle place un groupe "Rémanence des touches" dans la catégorie "Clavier" du dialogue "Paramètres" de l'extension.

Pour activer ou désactiver la rémanence des touches, il suffit de composer l'une des séquences de touches clavier suivante :

Elles sont cochées par défaut.

Pendant cette temporisation, tout nouvel appui sur une de ces touches relance la temporisation et cette nouvelle touche est elle aussi mémorisée, mais aucun bip n'est émis.

L'appui sur une toute autre touche du clavier exécute le geste de commande composé de la combinaison de toutes les touches mémorisées avec cette dernière touche.

A chaque fois que cette dernière touche sera de nouveau tapée pendant la temporisation, le geste de commande sera de nouveau exécuté.

Si cette touche est tapée hors temporisation, elle est exécuté seule et les touches mémorisées sont oubliées.

Attention : Il faut attendre la fin de la rémanence pour faire traiter toute nouvelle touche individuellement. Par exemple : "Alt" pour faire apparaitre un menu puis dérouler les éléments du menu.

Il est cependant possible d'arrêter la rémanence avant la fin de la temporisation, en retapant la dernière touche rémanente.

2.16.1. Rémanence spécifique pour le site gmail.com

Cette rémanence est spécifiquement mise en place pour le site gmail.com et n'est active uniquement dans la page "https://mail.google.com/mail/#i".

Elle n'est pas active par défaut. Une case à cocher "Rémanence spécifique pour gmail.com" est prévue dans le groupe "Rémanence des touches".

Dans cette page, il est possible de taper des raccourcis pour lancer des commandes mais certains d'entre eux enchainent deux lettres. En particulier, les lettres "g", "h", "*" doivent être suivi d'une autre lettre. Cet enchainement doit être assez rapide pour provoquer l'exécution de la commande associée. Cela pose problème aux personnes qui n'ont pas la dextérité suffisante.

L'objectif de cette rémanence est donc de retenir la première lettre en attendant que la seconde soit frappée.

Lorsque la première lettre est frappée, une temporisation est démarrée (un bip sourd est audible) et la lettre est mémorisée.

La frappe de la seconde lettre dans le délai de rémanence configuré provoque l'envoi des deux lettres au navigateur et la temporisation est arrêtée.

Si aucune nouvelle lettre n'est frappée, la première lettre est envoyée au navigateur à l'échéance de la temporisation (un bip aigu est audible).

Afin que NVDA envoie les lettres au navigateur, il est nécessaire de basculer en mode formulaire avant toute chose.

2.17. Arrêt de l'ordinateur

Cette fonctionnalité ne peut pas être désinstallée.

Elle installe un script dont la description est : "Afficher le dialogue pour arrêter, redémarrer ou mettre en veille l'ordinateur".

Il se lance à l'aide de La commande "r" de l'interpréteur. Ce script affiche un dialogue composé des éléments suivants :

Cette fonctionnalité installe aussi les scripts correspondants aux fonctions des trois boutons.

Tous les scripts sont rangé dans la catégorie "Extension des commandes de base de NVDA" du dialogue "Gestes de commande" de NVDA, mais aucun geste ne leur est affectés.

2.18. Gestion des gestes de commandes utilisateur

Cette fonctionnalité ne peut pas être désinstallée.

De base, NVDA permet d'ajouter ou de supprimer des gestes de commande à l'aide du dialogue "gestes de commande". Mais il n'y a aucun moyen de savoir quels sont les gestes ajoutés ou supprimés par l'utilisateur. C'est à ce besoin que veut répondre cette fonctionnalité.

Pour cela, Elle ajoute le script dont la description est "Afficher le dialogue pour gérer les Gestes de commande configurés par l'utilisateur" et placé dans la catégorie "Extension des commandes de base de NVDA" du dialogue "Gestes de commandes" de NVDA.

Il se lance à l'aide de la commande "u " de l'interpréteur. Aucun geste de commande ne lui est affecté par défaut.

Ce script affiche un dialogue du style "gestes de commande" de NVDA en sélectionnant uniquement les gestes de commandes supprimées ou modifiées par l'utilisateur.

Le dialogue présente :

Les gestes de commandes supprimés d'une catégorie sont présentés avec la description : "Gestes de commande supprimées".

Comme il n'est pas possible de connaitre la catégorie et la description d'un geste de commande supprimés ou d'un geste de commande ajouté associé à un script d'une extension qui n'est pas activée ou pas installé au moment de l'affichage du dialogue ,ce geste est présenté comme ceci :

Comme pour le dialogue "gestes de commandes" classique, ce n'est que sur appui sur le bouton "OK" que toutes les suppressions de geste seront prises en compte.

L'annulation de toutes les modifications à l'aide du bouton "Supprimer tout" est soumise à confirmation. Sur acceptation, toutes les modifications sont annulées et le dialogue se referme.

2.19. Contrôle du son

Par défaut, cette fonctionnalité est installée sans geste de commande.

Elle ne peut fonctionner que sous le système d'exploitation Windows 10.

Si elle est installée avec ou sans geste de commande, Elle place le groupe "Contrôle du son" dans la catégorie "Ordinateur" du dialogue "Paramètres".

Elle installe la gestion du rétablissement du son au démarrage de l'extension et les scripts suivants rangés sous la catégorie "Contrôle du son" dans le dialogue "Gestes de commandes" :

2.19.1. Établir manuellement le son principal et du flux audio de NVDA

Ce script se lance :

Il établit le son pour le volume principal et pour le flux audio de NVDA et force les niveaux de chacun aux valeurs des niveaux de rétablissement configurées dans le groupe "Contrôle du son" de la catégorie "Ordinateur" des paramètres de l'extension.

2.19.2. Couper ou établir le son du flux audio de l'application placée sous le focus

Ce script se lance :

Cette commande coupe le son du flux audio de l'application placée sous le focus s'il est établi ou le rétablit s'il est coupé.

2.19.3. Modifier le volume du flux audio de l'application sous le focus

Ces scripts permettent d'augmenter, diminuer ou fixer le volume du flux de l'application présente sous le focus.

Ils sont installés sans gestes de commandes. Mais il est toujours possible de leur en attribuer avec le dialogue "Gestes de commandes".

Ils se lancent à l'aide des commandes suivantes de l'interpréteur :

Ces commandes, contrairement aux autres commandes de l'interpréteur, peuvent être répéter sans être obliger de relancer celui-ci. L'interpréteur reste toujours actif. Une fois le niveau de volume atteint, il faut taper sur la touche "Échapp" pour quitter l'interpréteur.

L'augmentation ou la diminution du volume se fait par pas. Il est possible de régler la taille de ces pas dans les paramètres de l'extension sous la catégorie "Ordinateur", groupe "Contrôle du son", en choisissant la taille du pas.

La taille 1 correspond au plus petit pas, la taille 20 au plus grand pas. La taille est réglée par défaut sur 5,.

Cependant il faut comprendre que ce pas correspond à un pourcentage d'augmentation ou de diminution par rapport au volume principal.

Ainsi si le volume principal est de 100, l'augmentation du volume de l'application avec un pas de 5 sera de 5 échelons dans le niveau du mélangeur de Windows.

Tandis que si le volume du volume principal est de 60, un pas de 5 augmentera le volume de l'application de 3 échelons.

Le niveau du volume de l'application ne peut pas dépasser le niveau du volume principal.

2.19.4. Modifier le volume principal

Ces scripts permettent d'augmenter, diminuer, ou fixer le volume principal.

Ils sont installés sans gestes de commandes. Mais il est toujours possible de leur en attribuer avec le dialogue "Gestes de commandes".

Ils se lancent à l'aide des commandes suivantes de l'interpréteur :

Ces commandes, contrairement aux autres commandes de l'interpréteur, peuvent être répéter sans être obliger de relancer celui-ci. L'interpréteur reste toujours actif.

Une fois le niveau de volume atteint, il faut taper sur la touche "Échapp" pour quitter l'interpréteur.

L'augmentation ou la diminution du volume se fait par pas. Il est possible de régler la taille de ces pas dans les paramètres de l'extension sous la catégorie "Ordinateur", groupe "Contrôle du son", en choisissant la taille du pas. La taille 1 correspond au plus petit pas, la taille 20 au plus grand pas. Par défaut, la taille est réglée sur 5, ce qui correspond à 5 échelons de variation du volume dans le mélangeur de Windows.

Le volume principal ne peut pas devenir inférieur au seuil de rétablissement configuré.

2.19.5. Retour au précédent niveau

Lors de l'utilisation des commandes précédents, le niveau du volume est enregistré avant l'exécution de chaque commande, pour le volume principal et pour chaque application.

Pour revenir à ce niveau, les commandes suivantes sont disponibles :

Le niveau précédent est également enregistré à l'exécution de ces commandes.

Ces enregistrements ne sont pas conservés lors d'un redémarage de NVDA.

2.19.6. Annonce des changements de niveau

Les changements de niveau du volume sont annoncés par défaut.

Mais il est possible de désactiver cette annonce à l'aide de l'option "Annoncer les modifications de volume" du groupe "Modification du volume" de la catégorie "Ordinateur".

Pour le volume des applications, celui-ci peut être dit :

Le choix se fait à l'aide de l'option "Annoncer le niveau du volume des applications en pourcentage" du groupe "Modification du volume" de la catégorie "Ordinateur".

2.19.7. Rétablissement automatique du son principal et de NVDA au chargement de l'extension

Cette fonction permet de rétablir, au chargement de cette extension, le volume principal et celui de NVDA et de positionner le niveau de chaque volume à une valeur définie par configuration dans le cas où celui-ci est inférieur au seuil minimum défini par configuration.

Pour cela, le groupe "Contrôle du son" de la catégorie "Ordinateur" du dialogue "Paramètres" de l'extension, présente les éléments de configuration suivants :

À son lancement, cette extension vérifie que le volume principal et celui de NVDA sont au-dessus du seuil de rétablissement configuré pour chacun.

Si ce n'est pas le cas, cette extension fixe alors le niveau du volume à la valeur du niveau à rétablir configurée.

Lors de l'installation de cette extension, les niveaux courants du volume principal et de NVDA sont pris en compte pour définir les valeurs des niveaux à rétablir.

2.20. Scripts pour Cliquer à la position courante de l'objet navigateur

Ces scripts permettent de faire, avec le bouton droit ou gauche de la souris, un simple ou un double clic à la position courante de l'objet navigateur.

Ils enchainent en fait deux types de scripts de NVDA :

Les gestes de commandes de ces scripts sont :

Ces gestes de commandes peuvent être modifiés et se trouvent dans la catégorie "Souris" du dialogue "Gestes de commandes" de NVDA.

2.21. Compléments concernant la date et l'heur

Cette fonctionnalité est installée par défaut sans geste de commande.

Attention : installée avec geste de commande, cette fonctionnalité peut être en conflit avec l'extension "Clock" car le geste de commande "nvda+f12" est en commun.

Cette fonctionnalité apporte :

2.21.1. Copie de la date et de l'heure dans le presse-papier

La description de ce script est : "Copier la date et l'heure dans le presse-papier".

Ce script est rangés dans la catégorie "État système" du dialogue "Gestes de commande" de NVDA.

Il se lance à l'aide de la commande "c" de l'interpréteur. Aucun geste de commande ne lui est attribué.

Il permet comme sa description l'indique de copier la date et l'heure dans le presse-papier.

2.21.2. Script pour remplacer le script de base "NVDA+f12"

L'extension installe un script dont la description est : "Annoncer l'heure. Deux appuis : annoncer la date. Trois appuis : copier la date et l'heure dans le presse-papier".

Ce script est rangés dans la catégorie "État système" du dialogue "Gestes de commande" de NVDA.

Aucune commande de l'interpréteur ne lui est associée.

Si l'état d'installation de l'extension est "Installer", ce script remplace le script de NVDA et se lance à l'aide du geste de commande "NVDA+f12".

Sinon aucun geste de commande ne lui est affecté, mais il est toujours possible de lui en attribuer un à l'aide du dialogue "Gestes de commandes" de NVDA.

Ce script permet :

Il apporte aussi :

2.21.2.1. Annonce de l'heure indépendante du niveau de ponctuation

Le geste de commande de base "NVDA + f12" donne l'heure sur un simple appui, mais l'heure n'est pas annoncée de la même façon suivant le Niveau de ponctuations et symboles sélectionné dans les paramètres vocaux.

Ce script corrige ce petit défaut en annonçant l'heure avec le Niveau de ponctuations et symboles forcé à "Aucun" sans modifier le niveau défini dans les paramètres vocaux.

2.21.2.2. Annonce de l'heure avec les secondes

Par défaut, le geste de commande de NVDA "nvda+f12" annonce l'heure sans les secondes.

Ce script offre la possibilité de faire annoncer l'heure avec les secondes.

Il suffit de cocher la case à cocher "Dire l'heure avec les secondes" se trouvant dans la catégorie "Ordinateur" du dialogue "Paramètres" de l'extension. Cette option n'est pas cochée par défaut.

Cette option n'est pas présente si l'état d'installation de la fonctionnalité est "Ne pas installer".

2.22. Émulation de la touche "Applications"

Pour palier à l'absence de la touche "Applications" sur certains ordinateurs et ne sachant pas si le raccourci "majuscule+f10" remplit la même fonction, l'extension installe un script sans geste de commande dans la catégorie "Touches émulées du clavier du système" avec la description "Émuler l'appui de touche : Applications".

Pour l'utiliser, il suffira de lui affecter un geste de commande ou une touche du clavier très peu utilisée, comme par exemple la touche "impression écran", la touche "Pause".

2.23. Fermeture de toutes les fenêtres

L'extension installe un script pour fermer toutes les fenêtres ouvertes.

Ce script est rangé dans la catégorie des scripts de l'extension et sous la description "Fermer toutes les fenêtres ouvertes".

Il se lance avec la commande "k" de l'interpréteur de commande . Aucun geste de commande ne lui est affecté par défaut.

2.24. Lister les extensions en fonctionnement

Le gestionnaire d'extensions présente la liste des extensions installées et leur état : activée ou désactivée.

Mais bien qu'étant activée, une extension peut ne pas être chargée par NVDA. En principe, le journal de NVDA signale ce fait, mais rien dans le gestionnaire d'extensions.

Il peut être intéressant à un moment donné de connaitre les extensions qui sont réellement en fonctionnement.

Pour cela, l'extension installe un script sous la description "Afficher la liste des extensions en fonctionnement" dans la catégorie de l'extensions dans le dialogue "Gestes de commande".

Ce script se lance avec la commande "e" de l'interpréteur de commande. Aucun geste de commande ne lui est affecté.

Les extensions sont listées par type :

2.25. Outils de développement

Cette fonctionnalité n'est pas installée par défaut.

Elle installe le script dont la description est "Afficher le dialogue présentant les outils pour le développement d'extensions".

Ce script est rangé dans la catégorie "Outils" du dialogue "gestes de commande" de NVDA.

Ce script se lance à l'aide de la commande "t" de l'interpréteur. Aucun geste de commande ne lui est assigné.

L'activation de ce script fait apparaitre un dialogue présentant :

2.25.1. Notions

Pour packager une extension (créer le fichier d'installation de l'extension), il est conseillé d'utiliser le modèle "nvda adon scons template". Ce modèle utilise un fichier "buildVars.py" qui définit, pour une extension, toutes les informations nécessaires comme par exemple : son nom interne, sa version, son nom et sa description à traduire dans chaque langue supportée par lui. Ce modèle est aussi utilisé pour permettre la traduction des chaines de caractères de l'extension avec le système de traduction mise en place par la communauté "NVDA-addon.org".

L'objectif de ce modèle est, quand une extension a été mise au point, par simple commande et après avoir renseigné le fichier "buildVars.py" de :

Quand on crée une extension, il n'y a rien. Il faut par soi-même créer le fichier "manifest.ini", éventuellement le fichier "manifest.ini" de localisation et le fichier de documentation.

L'objectif de ces outils se place dans cette condition et est :

2.25.2. Création du fichier buildVars.py

La première étape est de créer le fichier "buildVars.py" à partir des informations du fichier "manifest.ini" que l'on a créé pour la mise au point de l'extension.

Le bouton "Créer le fichier buildVars.py" lance cette opération.

C'est uniquement ce fichier que l'on modifiera ensuite pour mettre à jour le fichier "manifest.ini" (changement de version ou de description par exemple).

Pour être utilisé avec le modèle "adon scons template", il faudra le compléter en renseignant les informations qui ne se trouvent pas dans le fichier "manifest.ini".

2.25.3. Mise à jour de la version de l'extension

Le bouton "Mettre à jour la version de l'extension" permet de modifier la version définie dans le fichier buildVars.py de l'extension sélectionnée.

Il présente une boite de dialogue contenant une zone d'édition initialisée avec la version courante du fichier.

L'appui sur le bouton "OK" enregistre la nouvelle version dans le fichier.

2.25.4. Mise à jour du fichier manifest.ini

Le fichier "manifest.ini" doit être mis à jour dès que le fichier "buildVars.py" est modifié.

Utiliser le bouton "Mettre à jour le fichier manifest.ini" pour cela.

2.25.5. Création de fichier "manifest.ini" de localisation

Toute modification de l'information "addon_summary" ou "addon_description" du fichier "buildVars.py" nécessite la traduction de cette description dans chaque langue supportée par l'extension (prise en compte dans le fichier nvda.po et compilation de ce fichier).

Pour que le gestionnaire d'extensions présente ces informations à l'utilisateur pour la langue choisie pour NVDA, il faut créer ou mettre à jour le fichier "manifest.ini" de localisation pour cette langue.

Le bouton "Créer le fichier manifest.ini de localisation" permet cela. Il est possible de mettre à jour le fichier pour la langue sélectionnée ou pour toutes les langues.

2.25.6. Créer la documentation HTML

Les fichiers de La documentation de l'extension peuvent être soit au format "markdown"(.md) soit au format "txt2tags" (.t2t).

Pour être présenté à l'utilisateur dans un navigateur, ces fichiers doivent être convertis en HTML.

Cela est possible simplement à l'aide du bouton "Créer les fichiers HTML de documentation" après avoir sélectionnée l'extension dans la liste des extensions et choisi un langage ou l'ensemble des langages dans la liste des langages.

Ouvert dans le navigateur, ces fichiers HTML ont besoin de fichiers de style (style.css pour les fichiers Markdown et style_t2t.css pour les fichiers txt2tags) placé dans le dossier doc de l'extension.

2.25.7. Création du fichier catalogue

Le bouton "Créer le fichier POT" permet de créer le fichier catalogue de l'extension sélectionnée.

Une fois créé, ce fichier est placé dans le dossier "locale\en" de l'extension et est nommé "nom-version.pot" où "nom" est le nom de l'extension et "version" sa version.

2.25.8. Préparation de l'extension

Le bouton "Préparer l'extension" lance, pour l'extension sélectionnée, l'exécution des actions suivantes :

2.25.9. Exploration du dossier de l'extension

Le bouton "Explorer le dossier de l'extension" ouvre l'explorateur Windows dans le dossier de l'extension sélectionnée.

3. Options

3.1. Suppression de l'annonce de la description des objets dans les rubans Windows

Dans les rubans Windows, NVDA est trop bavard sans nécessité. Par défaut, cette extension empêche l'annonce de la description qui semble bien inutile.

Mais ceci peut être désactivé à l'aide de l'option "Ne pas annoncer la description des objets dans les rubans Windows" qui se trouve dans la catégorie "Ordinateur" du dialogue "Paramètres de l'extension".

Un redémarrage de NVDA sera alors nécessaire pour la prise en compte de l'option.

3.2. Annonce du mot focalisé après une suppression de mot

Dans certaines application telle que WordPad , microsoft Word, il est possible d'effacer le mot suivant avec la commande "contrôle + Suppr", mais les versions de NVDA antérieure à la 2020.3 ne prononcent pas le mot qui suit la position du curseur après la suppression.

Par défaut, cette extension permet à ces versions de NVDA de prononcer ce mot.

, ceci peut être empêché en décochant l'option "Annoncer le mot focalisé après une suppression de mot" de la catégorie "Compléments à NVDA" du dialogue "Paramètres" de l'extension.

3.3. Agrandissement automatique des fenêtres

Cette option permet d'agrandir automatiquement les fenêtres qui sont mises au premier plan.

Par défaut, elle est activée.

Vous pouvez la désactivée en décochant l'option "Agrandir automatiquement les fenêtres" de la catégorie "Ordinateur" du dialogue "Paramètres" de l'extension.

3.4. Annonce des ponctuations lors de déplacement par mot

NVDA permet, dans les documents, de se déplacer mot par mot à l'aide des commandes clavier "contrôle+ flèche droite" et "contrôle + flèche gauche".

Les symboles et ponctuations sont alors dites suivant le niveau de ponctuations et symboles configuré pour le profil de configuration courant.

Cette option permet de configurer le niveau de symboles et de ponctuations qui sera utilisé uniquement lors de déplacement par mot.

Ce choix est enregistré pour le profil de configuration courant.

Elle se configure dans la catégorie "Compléments à NVDA" du dialogue "Paramètres" de l'extension.

Elle n'est présente que si la fonctionnalité "Annonce de la fonction associée aux commandes d'édition du style "copier", "Coller" est installée.

Elle se présente sous la forme d'une liste qui permet de choisir :

4. Options avancées

4.1. Signalement par son de l'inscription d'une erreur dans le journal de NVDA

Les utilisateurs expérimentés ont pu remarquer que lorsqu'ils utilisent une version de développement de NVDA (version snapshot master ou next), toute erreur inscrite dans le journal de NVDA est signaler par un son. Mais avec les versions finales ou releases candidates, ce signal n'est pas émis.

Cette option offre le choix entre :

Pour faire ce choix, il suffit de sélectionner l'option dans la liste déroulante nommée "Jouer un son lors de l'inscription d'une erreur dans le journal" de la catégorie "Avancés" du dialogue "Paramètres" de l'extension. Par défaut, l'option "Seulement pour les versions de développement" est sélectionnée.

4.2. Titrage des boites de dialogue avec le nom de l'extension

Cette option permet de titrer ou non les boites de dialogue de cette extension avec son nom. Elle se trouve dans la catégorie "Avancées" du dialogue "Paramètres de l'extension.

Par défaut, cette option est cochée et le titre des boites se présente sous la forme : "Extension des commandes de base de NVDA - NVDA - titre du dialogue".

4.3. Configuration de la temporisation d'attente de répétition du même geste de commande

Certains scripts de cette extension réalisent différentes actions suivant le nombre de fois où le geste de commande associé au script est composé. La répétition du geste de commande doit se faire dans un bref délai (500 ms par défaut).

Pour un script réalisant trois actions différentes, le mécanisme est :

Suivant la dextérité de l'utilisateur ou la configuration matérielle, cette temporisation peut être trop longue ou trop courte.

L'option intitulée "Temporisation d'attente de répétition du même geste de commande" de la catégorie "Avancés" du dialogue "Paramètres" de l'extension permet d'ajuster cette temporisation suivant le besoin.

4.4. Utilisation standard du pavé numérique

Par défaut, NVDA utilise certaines touches du pavé numérique, comme les touches de direction, les touches "multiplier", "diviser" et la touche "plus", pour activer des scripts.

L'objectif est de rendre à chaque touche du pavé numérique, de manière temporaire ou permanente, son fonctionnement normal, composé seule ou avec une touche de modification comme "contrôle", "Alt","majuscule" (La touche "NVDA" est exclue).

Ces touches sont :

Pour activer ou désactiver l'utilisation du pavé numérique en fonctionnement standard et si l'option "Autoriser l'utilisation standard du pavé numérique" du groupe "Pavé numérique" de la catégorie "Clavier" est cochée, l'extension offre :

L'option "Activer l'utilisation standard du pavé numérique au démarrage de NVDA " (groupe "Pavé numérique, catégorie "Clavier"), permet, si elle est cochée, d'utiliser le pavé numérique de manière standard dès le démarrage de NVDA, mais il faut aussi que l'option qui autorise l'utilisation standard du pavé numérique soit cochée.

5. Autres améliorations

5.1. Exploration du dossier de configuration ou dossier programme de NVDA

Cette extension ajoute dans le menu "outils" de NVDA un sous-menu "Explorer NVDA" qui propose deux éléments de choix :

Deux scripts, rangés dans la catégorie "Extension des commandes de base de NVDA" du dialogue "Gestes de commande" de NVDA, sont prévus pour réaliser ces mêmes actionset avec les descriptions suivantes :

Par défaut, aucun geste de commande ne leur est associé.

5.2. Présentation de la mise en forme du texte dans une boite de dialogue

De base, un double appui du geste de commande "NVDA + f" présente les informations de mise en forme sous la forme d'un document HTML.

Ce script a pour but de les compléter et les afficher plutôt dans une boite de dialogue afin de pouvoir les lire en utilisant les flèches de direction.

Il se lance à l'aide de la commande "f" de l'interpréteur.

La description du script est : "Afficher, dans une boite de dialogue, les informations de mise en forme à la position actuelle du curseur de revue dans un document".

Il est rangé sous la rubrique "Extension des commandes de base de NVDA" du dialogue "Gestes de commande de NVDA".

Aucun geste de commande ne lui est affecté par défaut.

5.3. Annonce du texte des boites de dialogues du style confirmation

NVDA considère pour certaines boites de dialogue comme celles de confirmation, que le texte qu'elles contiennent est une description.

Donc si l'option "Annoncer la description de l'objet" de la catégorie "Présentation des objets" du dialogue "Paramètres" De NVDA n'est pas cochée, le texte n'est pas annoncé par NVDA.

Cette extension met en place l'option "Ne pas tenir compte de l'option Annoncer la description de l'objet lors de l’affichage des boite de dialogue du style confirmation" dans la catégorie "Avancés" du dialogue "Paramètres" de l'extension pour forcer, si elle est cochée, l'annonce du texte de ces boites dans tous les cas. Cette option est cochée par défaut.

6. Résumé des commandes apportées par cette extension

6.1. Gestes de commande installés systématiquement

Nom Ordinateur de bureau Ordinateur portable Tactile Description
NVDA+j NVDA+j Aucun Lancer l'interpréteur de commandes de l'extension

6.2. Commandes de l'interpréteur

Commande Description
a Afficher les informations sur l'application sous le focus
b Afficher les éléments visibles composant l'objet en avant plan
c Copier la date et l'heure dans le presse-papier
e Afficher les Extensions en fonctionnement
f Afficher, dans une boite de dialogue, les informations de mise en forme à la position actuelle du curseur de revue dans un document
f1 Afficher le dialogue de paramétrage de l'extension
f2 Afficher le dialogue Renommage des touches clavier
f3 Afficher le dialogue pour configurer les annonces sélectives des touches de commandes
f4 Composer un symbole complexe comme par exemple une voyelle accentuée, un symbole mathématique
contrôle+f4 Afficher la liste des derniers symboles complexes composés
f5 Activer ou désactiver l'utilisation standard du pavé numérique
f9 Afficher les enregistrements de l'historique vocal
F10 Afficher la liste des fenêtres des application lancées avec la possibilité de basculer vers l'une d'entre elles ou de la détruire
F11 Afficher la liste des icônes de la zone de notification
f12 Afficher le dialogue permettant, sila minuterie est arrêtée, de la lancer ou sinon de consulter la durée restante ou d'arrêter celle-ci
k Fermer toutes les fenêtres ouvertes
g Afficher le manuel utilisateur de l'extension
h Afficher la liste des commandes de l'interpréteur de commandes
j Afficher le dialogue pour gérer les journaux de NVDA
o Annoncer le nom du dossier sélectionner pour les boites de dialogue du style Ouvrir, Enregistrer
contrôle+o Annoncer le chemin complet du dossier sélectionner pour les boites de dialogue du style Ouvrir, Enregistrer
p Activer ou désactiver le Mode commutation de profil vocal
r Afficher le dialogue pour arrêter, redémarrer ou mettre en veille prolongée l'ordinateur
s Couper ou établir le son pour l'application sous le focus
contrôle+s Établir le son principal et de NVDA
t Afficher le dialogue présentant les outils pour le développement d'extensions
u Afficher le dialogue pour gérer les gestes de commande configurés par l'utilisateur
v Afficher le dialogue pour gérer les sélecteurs de profil vocal
z Annoncer les paramètres vocaux acctuels
contrôle+z Afficher les paramètres vocaux acctuels
flèche haut Augmenter le volume de l'application sous le focus
contrôle+flèche haut Augmenter le volume principal
flèche bas Diminuer le volume de l'application sous le focus
contrôle+flèche bas Diminuer le volume principal
page précédente Maximiser le volume de l'application sous le focus
contrôle+page précédente Maximiser le volume principal
page suivante Minimiser le volume de l'application sous le focus
contrôle+page suivante Minimiser le volume principal
retour arrière Établir le volume de l'application sous le focus au précédent niveau
contrôle+retour arrière Établir le volume principal au précédent niveau
chiffre de 1 à 9 Établir le volume de l'application sous le focus à x pourcent du volume principal ( x égal à 10 multiplié par le chiffre)
contrôle+chiffre de 1 à 9 Établir à x le volume principal (x égal à 10 multiplié par le chiffre)

6.3. Gestes de commande installés par les fonctionnalités

6.3.1. Affichage de la liste des icones de la zone de notification et des fenêtres des applications lancées

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Liste des icônes et fenêtres actives NVDA + F11 NVDA + F11 Aucune Afficher la liste des icônes de la zone de notification. Deux appuis : Afficher la liste des fenêtres des application lancées avec la possibilité de basculer vers l'une d'entre elles ou de la détruire

6.3.2. Aide à la composition de symboles complexes

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Aide à la composition de Symboles complexes NVDA + Majuscule + f4 NVDA + Majuscule + f4 Aucune Composer un symbole complexe comme par exemple une voyelle accentuée, un symbole mathématique

6.3.3. Informations sur l'application sous le focus

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Annoncer le nom et le numéro de version de l'application sous le focus NVDA + majuscule + f1 NVDA + majuscule + f1 Aucune Annoncer le nom et la version de l'application sous le focus
Annoncer le Profil de configuration NVDA+ contrôle +F1 NVDA+ contrôle +F1 Aucune Annoncer le nom de fichier de l'application en cours ainsi que le nom du module python chargé. Deux appuis : annoncer le nom et l'état du profil de configuration

6.3.4. Extension des fonctionnalités du tampon virtuel

Ordinateur de bureau Ordinateur portable Tactile Description
NVDA+alt+j NVDA+alt+j aucun annoncer les cellules de la ligne courante du tableau
NVDA+alt+l NVDA+alt+l aucun annoncer les cellules de la colonne courante du tableau
NVDA+alt+Flèche bas NVDA+alt+Flèche bas aucun Aller à la ligne suivante du tableau et annoncer les cellules de celle-ci
NVDA+alt+Flèche haut NVDA+alt+Flèche haut aucun Aller à la ligne précédente du tableau et annoncer les cellules de celle-ci
NVDA+alt+Flèche droite NVDA+alt+Flèche droite aucun Aller à la colonne suivante du tableau et annoncer les cellules de celle-ci
NVDA+alt+Flèche gauche NVDA+alt+Flèche gauche aucun Aller à la colonne précédente du tableau et annoncer les cellules de celle-ci
NVDA+alt+pavnum5 NVDA+alt+; aucun annoncer la position de la cellule courante du tableau
contrôle+alt+majuscule+Flèche gauche contrôle+alt+majuscule+Flèche gauche aucun Aller à la première cellule de la ligne du tableau
contrôle+alt+majuscule+Flèche droite contrôle+alt+majuscule+Flèche droite aucun Aller à la dernière cellule de la ligne du tableau
contrôle+alt+majuscule+Flèche haut contrôle+alt+majuscule+Flèche haut aucun Aller à la première cellule de la colonne du tableau
contrôle+alt+majuscule+Flèche bas contrôle+alt+majuscule+Flèche bas aucun Aller à la dernière cellule de la colonne du tableau
NVDA+a NVDA+majuscule+a aucun Annoncer l'adresse (URL) du document. Deux appuis : l'enregistrer dans le presse-papier

6.3.5. Annonce du dossier présélectionner des boites de dialogue du style Ouvrir, enregistrer, enregistrer sous

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Annoncer le Dossier présélectionné NVDA+o NVDA+o Aucune Annoncer le nom du dossier sélectionner pour les boites de dialogue du style Ouvrir, Enregistrer. Deux appuis : annoncer son chemin complet

6.3.6. Journaux de NVDA

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Ouvrir le Journal NVDA+majuscule+j NVDA+majuscule+j Aucune Ouvrir le journal courant de NVDA. Deux appuis : ouvrir son ancien journal. Trois appuis : copier le chemin du journal courant dans le presse-papier

6.3.7. Historique des annonces vocales

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Annoncer l'enregistrement précédent NVDA+contrôle+f8 NVDA+contrôle+f8 Aucune Annoncer le précédent enregistrement de l'historique vocal et le copier dans le presse-papier
Annoncer l'enregistrement suivant NVDA+contrôle+f10 NVDA+contrôle+f10 Aucune Annoncer l' enregistrement suivant de l'historique des annonces vocales et le copier dans le presse-papier
Annoncer l'enregistrement courant NVDA+contrôle+f9 NVDA+contrôle+f9 Aucune Annoncer l'enregistrement courant de l'historique des annonces vocales et le copier dans le presse-papier. Deux appui : afficher tout l'historique

6.3.8. Minuterie

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Minuterie NVDA+majuscule+f12 NVDA+majuscule+f12 Aucune Afficher le dialogue permettant, sila minuterie est arrêtée, de la lancer ou sinon de consulter la durée restante ou d'arrêter celle-ci

6.3.9. Redémarrage de NVDA

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Redémarrage de NVDA NVDA+contrôle+f4 NVDA+contrôle+f4 Aucune Redémarrer NVDA. Deux appuis : redémarrer en niveau de journalisation débogage

6.3.10. Affichage des éléments visibles composant l'objet en avant plan

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Affichage des objets NVDA+b NVDA+b Aucune Annoncer tous les contrôles dans la fenêtre active. Deux appuis : afficher les éléments visibles composant l'objet en avant plan

6.3.11. Commutation de profil vocal

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Choix du sélecteur nvda+majuscule+contrôle+ numéro du sélecteur nvda+majuscule+contrôle+ numéro du sélecteur Aucune Positionner le sélecteur x comme sélecteur courant et définir , si possible, son profil vocal associé comme profil vocal courant(x égal chiffre 1 à 8)
Profil vocal suivant nvda+majuscule+contrôle+Fèche droite nvda+majuscule+contrôle+Fèche droite Aucune Aller au premier sélecteur suivant associé à un profil vocal et définir ce profil vocal comme profil vocal courant
Profil vocal précédent nvda+majuscule+contrôle+Flèche gauche nvda+majuscule+contrôle+Flèche gauche Aucune Aller au premier sélecteur précédent associé à un profil vocal et définir ce profil vocal comme profil vocal courant
Association du profil vocal nvda+majuscule+contrôle+m nvda+majuscule+contrôle+m Aucune Afficher le dialogue pour gérer les sélecteurs de profil vocal
Activation/désactivation du mode commutation de profil vocal nvda+majuscule+contrôle+p nvda+majuscule+contrôle+p aucune Activer ou désactiver le Mode commutation de profil vocal

6.3.12. Date et heure- compléments

Nom Ordinateur de bureau Ordinateur portable Tactile Description
Date et heure NVDA + F12 NVDA + F12 aucune Annoncer l'heure. Deux appuis : annoncer la date. Trois appuis : copier la date et l'heure dans le presse-papier