]>

<book id="index" lang="fr">

<title>Guide d'accessibilité du bureau GNOME pour les développeurs </title>

<bookinfo>

<abstract role="description">

<para>Le guide d'accessibilité du bureau GNOME est pour les développeurs qui souhaitent s'assurer que leurs programmes sont accessibles au plus grand nombre d'utilisateurs. Ce guide couvre aussi bon nombre des critères de la section 508 (États Unis).</para>

</abstract>

<copyright><year>2008</year> <holder>Vincent Alexander</holder></copyright>

<copyright><year>2001, 2002</year> <holder>Calum Benson, Brian Cameron, Bill Haneman, Padraig O'Briain, Sharon Snider</holder></copyright>

<publisher role="maintainer"> 

<publishername>Projet de documentation GNOME</publishername> 

</publisher>

<legalnotice id="legalnotice">

<para>Permission vous est donnée de copier, distribuer et/ou modifier ce document selon les termes de la Licence GNU Free Documentation License (GFDL), Version 1.1 ou ultérieure publiée par la Free Software Foundation sans section inaltérable, sans texte de première page de couverture ni texte de dernière page de couverture. Vous trouverez un exemplaire de cette licence en suivant ce <ulink type="help" url="ghelp:fdl">lien</ulink> ou dans le fichier COPYING-DOCS fourni avec le présent manuel.</para>

<para>Ce manuel fait partie de la collection de manuels GNOME distribués selon les termes de la licence de documentation libre GNU. Si vous souhaitez distribuer ce manuel indépendamment de la collection, vous devez joindre un exemplaire de la licence au document, comme indiqué dans la section 6 de celle-ci.</para>

<para>La plupart des noms utilisés par les entreprises pour distinguer leurs produits et services sont des marques déposées. Lorsque ces noms apparaissent dans la documentation GNOME et que les membres du projet de Documentation GNOME sont informés de l'existence de ces marques déposées, soit ces noms entiers, soit leur première lettre est en majuscule.</para>

<para>LE PRÉSENT DOCUMENT ET SES VERSIONS MODIFIÉES SONT FOURNIS SELON LES TERMES DE LA LICENCE DE DOCUMENTATION LIBRE GNU SACHANT QUE : <orderedlist>

<listitem>

<para>LE PRÉSENT DOCUMENT EST FOURNI « TEL QUEL », SANS AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, Y COMPRIS, ET SANS LIMITATION, LES GARANTIES DE BONNE QUALITÉ MARCHANDE OU D'APTITUDE À UN EMPLOI PARTICULIER OU AUTORISÉ DU DOCUMENT OU DE SA VERSION MODIFIÉE. L'UTILISATEUR ASSUME TOUT RISQUE RELATIF À LA QUALITÉ, À LA PERTINENCE ET À LA PERFORMANCE DU DOCUMENT OU DE SA VERSION DE MISE À JOUR. SI LE DOCUMENT OU SA VERSION MODIFIÉE S'AVÉRAIT DÉFECTUEUSE, L'UTILISATEUR (ET NON LE RÉDACTEUR INITIAL, L'AUTEUR, NI TOUT AUTRE PARTICIPANT) ENDOSSERA LES COÛTS DE TOUTE INTERVENTION, RÉPARATION OU CORRECTION NÉCESSAIRE. CETTE DÉNÉGATION DE RESPONSABILITÉ CONSTITUE UNE PARTIE ESSENTIELLE DE CETTE LICENCE. AUCUNE UTILISATION DE CE DOCUMENT OU DE SA VERSION MODIFIÉE N'EST AUTORISÉE AUX TERMES DU PRÉSENT ACCORD, EXCEPTÉ SOUS CETTE DÉNÉGATION DE RESPONSABILITÉ ; ET</para>

</listitem>

<listitem>

<para>EN AUCUNE CIRCONSTANCE ET SOUS AUCUNE INTERPRÉTATION DE LA LOI, QU'IL S'AGISSE D'UN DÉLIT CIVIL (Y COMPRIS LA NÉGLIGENCE), CONTRACTUEL OU AUTRE, L'AUTEUR, LE RÉDACTEUR INITIAL, TOUT PARTICIPANT OU TOUT DISTRIBUTEUR DE CE DOCUMENT OU DE SA VERSION MODIFIÉE, OU TOUT FOURNISSEUR DE L'UNE DE CES PARTIES NE POURRA ÊTRE TENU RESPONSABLE À L'ÉGARD DE QUICONQUE POUR TOUT DOMMAGE DIRECT, INDIRECT, PARTICULIER, OU ACCIDENTEL DE TOUT TYPE Y COMPRIS, SANS LIMITATION, LES DOMMAGES LIÉS À LA PERTE DE CLIENTÈLE, À UN ARRÊT DE TRAVAIL, À UNE DÉFAILLANCE OU UN MAUVAIS FONCTIONNEMENT INFORMATIQUE, OU À TOUT AUTRE DOMMAGE OU PERTE LIÉE À L'UTILISATION DU DOCUMENT ET DE SES VERSIONS MODIFIÉES, MÊME SI LADITE PARTIE A ÉTÉ INFORMÉE DE L'ÉVENTUALITÉ DE TELS DOMMAGES.</para>

</listitem>

</orderedlist></para>

</legalnotice>

<authorgroup> 

<author><firstname>Vincent</firstname> <surname>Alexander</surname> <affiliation> <orgname>Projet de documentation GNOME</orgname> </affiliation></author>

<author><firstname>Calum</firstname> <surname>Benson</surname> <affiliation> <orgname>Projet de documentation GNOME</orgname> </affiliation></author>

<author><firstname>Brian</firstname> <surname>Cameron</surname> <affiliation> <orgname>Projet de documentation GNOME</orgname> </affiliation></author>

<author><firstname>Bill</firstname> <surname>Haneman</surname> <affiliation> <orgname>Projet de documentation GNOME</orgname> </affiliation></author>

<author><firstname>Padraig</firstname> <surname>O'Briain</surname> <affiliation> <orgname>Projet de documentation GNOME</orgname> </affiliation></author> 

<author><firstname>Sharon</firstname> <surname>Snider</surname> <affiliation> <orgname>Projet de documentation GNOME</orgname> </affiliation></author>

</authorgroup>

<revhistory>

<revision><revnumber> Guide d'accessibilité du bureau GNOME 2.24 pour les développeurs V2.24.0 </revnumber> <date>Septembre 2008</date> <revdescription> 

<para role="author">Projet de documentation GNOME</para> 

<para role="publisher">Projet de documentation GNOME</para> 

</revdescription></revision>

<revision><revnumber> Guide d'accessibilité du bureau GNOME 2.24 pour les développeurs V2.24.0 </revnumber> <date>Septembre 2008</date> <revdescription> 

<para role="author">Projet de documentation GNOME</para> 

<para role="publisher">Projet de documentation GNOME</para> 

</revdescription></revision>

</revhistory>

<releaseinfo>Ce manuel documente la version 2.24 du bureau GNOME.</releaseinfo>

<legalnotice> 

<title>Votre avis</title> 

<para>Pour rapporter une anomalie ou faire une suggestion concernant le bureau GNOME ou ce manuel, suivez les indications de la <ulink url="ghelp:user-guide?feedback" type="help">Page de réactions sur GNOME</ulink>.</para>

</legalnotice> 

</bookinfo>

<chapter id="gad" status="draft">

<title>Qu'est-ce que I'accessibilité ?</title>

<para>L'accessibilité signifie l'assistance aux personnes handicapées pour qu'elles puissent participer aux activités substantielles de la vie. Cela inclut le travail, l'accès aux services, produits et informations. GNOME inclut des bibliothèques et une structure de prise en charge qui permettent aux personnes ayant des handicaps d'utiliser toutes les fonctionnalités de l'environnement utilisateur GNOME.</para>

<para>En conjonction avec les technologies d'assistance, si nécessaire - interfaces vocales, lecteurs d'écran, périphériques de saisie alternatifs, et ainsi de suite - les personnes souffrant temporairement ou définitivement de handicaps peuvent donc utiliser le bureau GNOME et ses applications. Les technologies d'assistance sont aussi utiles pour les personnes utilisant un ordinateur en dehors de leur bureau ou de leur maison. Par exemple, si vous êtes pris dans un bouchon vous pouvez utiliser la commande vocale pour consulter votre courriel.</para>

<para>Les technologies d'assistance reçoivent des informations de l'application via l'API Accessibility Toolkit (ATK), que vous pouvez trouver dans le module atk des dépôts GNOME. Comme la prise en charge de l'API est incluse dans les éléments graphiques de GNOME, votre programme devrait fonctionner raisonnablement bien avec les technologies d'assistance sans que vous ayez à faire de travail supplémentaire. Par exemple, les technologies d'assistance peuvent lire automatiquement les étiquettes des éléments graphiques que vous utilisez normalement dans votre programme (par ex. avec des appels de fonctions GTK telles que <function>gtk_label_set_text()</function> ou <function>gtk_button_new_with_label()</function>). Elles peuvent aussi trouver si un texte d'infobulle est associé à un élément graphique et l'utiliser pour décrire l'élément graphique à l'utilisateur.</para>

<para>Avec seulement un petit effort supplémentaire, vous pouvez faire fonctionner votre programme encore mieux grâce aux technologies d'assistance. En plus d'aider les utilisateurs, cela rendra votre programme plus attractif aux marchés gouvernementaux et éducatifs dont la plupart exigent que leurs applications soient légalement accessibles.</para>

<section>

<title>Types de handicaps</title>

<para>Il est estimé, rien qu'aux États Unis, qu'il y a 30 000 000 personnes dont la capacité d'accès aux ordinateurs est limitée par une conception non accessible. Globalement approximativement 8% des personnes qui utilisent Internet ont une forme de handicap. Ces handicaps sont classés comme suit :</para>

<itemizedlist>

<listitem>

<para><emphasis>Déficience visuelle</emphasis> - Cela va de la mauvaise vue (vue faible ou floue, presbytie ou myopie extrême, daltonisme et rétrécissement du champ visuel entre autres) à la cécité complète. Un mauvais choix de taille de texte et de couleurs et des tâches requérant une bonne coordination main-œil (tel que le déplacement de la souris) peuvent causer des problèmes pour ces utilisateurs.</para>

</listitem>

<listitem>

<para><emphasis>Handicaps moteur</emphasis> - Ce sont des utilisateurs qui ont des problèmes de contrôle musculaire ou des faiblesses qui rendent l'utilisation d'un clavier standard et d'une souris difficile. Par exemple, ils peuvent être incapables d'enfoncer deux touches simultanément ou il se peut qu'ils enfoncent des touches accidentellement.</para>

</listitem>

<listitem>

<para><emphasis>Altération auditive</emphasis> - Cela va de la capacité d'entendre certains sons mais pas de distinguer les mots parlés, à la surdité profonde. Les applications qui fournissent des informations importantes uniquement par messages sonores causent des problèmes à ces utilisateurs.</para>

</listitem>

<listitem>

<para><emphasis>Difficultés d'expression et de raisonnement</emphasis> - Cela va de la dyslexie aux problèmes de mémoire, de résolution de problèmes, de compréhension et d'utilisation du langage écrit ou parlé. Un affichage complexe ou peu cohérent, un mauvais choix de mots peut rendre l'utilisation d'ordinateurs difficile pour ces utilisateurs.</para>

</listitem>

<listitem>

<para><emphasis>Troubles convulsifs</emphasis> - Certains motifs lumineux ou répétitions sonores peuvent causer des crises épileptiques pour les utilisateurs qui y sont sensibles.</para>

</listitem>

</itemizedlist>

</section>

<section id="gad-how-it-works">

<title>Fonctionnement de l'accessibilité dans GNOME</title>

<para>La boîte à outils d'accessibilité (ATK) décrit un jeu d'interfaces qui doivent être implémentées dans les composants de l'interface graphique pour les rendre accessibles. Les interfaces sont indépendantes de la boîte à outils - les implémentations peuvent être écrites pour n'importe quel jeu de d'éléments graphiques, tel que GTK, Motif ou Qt.</para>

<para>

The implementation for the GTK widgets is in a module called GAIL (GNOME Accessibility Implementation Library), which is dynamically loadable at runtime by a GTK application. Once

loaded, those parts of your application that use standard GTK widgets will have a basic level of accessibility, without you having to modify your application at all. If GAIL is not

loaded, GTK widgets will have a default accessibility implementation that essentially returns no information, though it nominally conforms to the ATK API. Applications which use

Bonobo controls, particularly out-of-process ones, also load accessibility support code from module libgail-gnome. Whether or not applications on the GNOME desktop automatically load these accessibility support libraries depends on the value of a <application>gconf</application> key, "/desktop/gnome/interface/accessibility"; a boolean value of "true" enables support for assistive technologies and applications which call gnome_program_init will automatically load the appropriate accessibility libraries at runtime. "Pure GTK+ applications", e.g. those that use gtk+ but do not link to libgnome, rely on the value of the GTK_MODULES environment variable, which must be set to "gail:atk-bridge" in order to enable assistive technology support.

</para>

<para>La plupart des technologies d'assistance utilisées par d'autres bureaux ont historiquement nécessité de maintenir des modèles hors écran complexes des applications du bureau, basés sur la capture d'évènements du système d'exploitation (SE), l'utilisation de fonctionnalités et d'API non prises en charge par le SE et les applications, ainsi que d'autres techniques non transférables. Cela rend la prise en charge des technologies d'assistance quelque peu « fragile » et très spécifique au SE et aux applications. Par contraste, pour le bureau GNOME, toutes les informations nécessaires aux technologies d'assistance sont fournies par les applications en fonctionnement, via la boîte à outils d'accessibilité de GNOME, vers l'interface de fournisseur de services (Service Provider Interface : SPI) de la boîte à outils indépendante. L'interface SPI fournit les moyens aux technologies d'assistance basées sur UNIX, telles que les lecteurs d'écran et les loupes, d'obtenir les informations d'accessibilités depuis les applications en fonctionnement via une API stable et homogène, et peut éliminer le besoin d'un modèle hors écran dans de nombreux cas. La prise en charge des applications est « intégrée » dans les boîtes à outils via les API appropriées (par exemple, ATK pour la plupart des applications natives en C et l'API Java Accessibility pour les applications Java) et exportée vers l'interface « AT-SPI » commune via le « pont » correspondant (voir le diagramme ci-dessous).</para>

<figure id="gad-architecture">

<title>Architecture de l'accessibilité de GNOME</title>

<mediaobject><imageobject> <imagedata fileref="figures/GNOME_desktop_Accessibility.png" format="PNG"/> </imageobject> <textobject> <phrase>Diagramme de l'architecture d'accessibilité de GNOME</phrase> </textobject></mediaobject>

</figure>

<para>La prise en charge intégrée des technologies d'assistance par GNOME signifie que les applications créées en utilisant les éléments graphiques du magasin GNOME bénéficient de la prise en charge de ces technologies « gratuitement », à condition que l'utilisation des éléments graphiques ne soit pas en conflit avec la prise en charge intégrée.</para>

<para>Un élément graphique gtk+/GNOME est accessible si son utilisation suit les directives générales d'accessibilité décrites dans ce document, et que les interfaces ATK appropriées à son role sont implémentées dans l'interface utilisateur. Les implémentations ATK sont fournies pour les éléments graphiques de la boîte à outils du « magasin » de GNOME (par ex. les éléments graphiques non abandonnés de gtk+ et GNOME) et dans de nombreux cas, les nouveaux éléments graphiques qui sont de simples dérivés d'éléments graphiques GTK+ ou GNOME, héritent également d'une prise en charge d'accessibilité convenable.</para>

<para>

Though GNOME's built-in accessibility support provides significant functionality without any accessibility-specific code changes on the part of the application, applications can often improve on the default descriptions provided for some of the widgets, and tailor them to that widget's specific purpose in your application, via straightforward calls to ATK methods in the application. For instance, in most cases applications should add or change the textual descriptions for these widgets with the appropriate ATK function call, so that an assistive technology can describe their purpose or state to the user. See <link linkend="gad-coding-guidelines">Coding Guidelines for Supporting Accessibility</link> for more information.

</para>

<para>Si votre application utilise des éléments graphiques personnalisés, vous allez sûrement devoir faire un peu de travail pour fournir les propriétés de ces éléments graphiques aux technologies d'assistance. Pour plus d'informations, consultez la section <link linkend="gad-custom">rendre les composants personnalisés accessibles</link> et les <link linkend="gad-api-examples">exemples d'utilisation de l'API d'accessibilité</link>.</para>

<para>Pour des informations supplémentaires plus détaillées sur GTK/GTK+, consultez le <ulink url="http://library.gnome.org/devel/gtk">manuel de référence de GTK+</ulink>, la <ulink url="http://live.gnome.org/GAP/AtkGuide/Gtk">section GTK du guide de ATK</ulink>, le <ulink url="http://library.gnome.org/devel/gtk-tutorial/stable/">tutoriel GTK+ 2.0</ulink> hébergé par GNOME et la <ulink url="http://library.gnome.org/devel/gtk-faq/stable/">FAQ GTK+</ulink> officielle.</para>

</section>

<section id="dev-start">

<title>Démarrage rapide pour le développeur</title>

<para>Voici quelques points de départ courants :</para>

<section id="dev-start-1">

<title>Comment vérifier que mon application est accessible ?</title>

<para>

To start right in, see <link linkend="gad-overview">Making a GNOME Application Accessible - Overview</link>. For a pre-coding perspective, see <link linkend="gad-ui-guidelines">User Interface Guidelines for Supporting Accessibility</link> or <link linkend="gad-coding-guidelines">Coding Guidelines for Supporting Accessibility</link>. For a checklist of post-design test items, see <link linkend="gad-checklist">User Interface Checklist</link>.

</para>

</section>

<section id="dev-start-2">

<title>Pièges à éviter</title>

<para>La <link linkend="gad-checklist">liste de contrôle de l'interface utilisateur</link> couvre toutes les zones qui sont parfois oubliées lors de la phase de conception.</para>

</section>

<section id="dev-start-3">

<title>Comment réaliser les fonctions ATK courantes ?</title>

<para>Une liste abrégée des appels ATK courants se trouve <link linkend="gad-api">ici</link>.</para>

</section>

<section id="dev-start-4">

<title>Comment réaliser les fonctions ATK plus complexes ?</title>

<para>Pour plus d'informations, consultez la section <link linkend="gad-custom">rendre les composants personnalisés accessibles</link> et les <link linkend="gad-api-examples">exemples d'utilisation de l'API d'accessibilité</link>.</para>

</section>

<section id="dev-start-5">

<title>Introduction à ATK, AT-SPI, GAIL et GTK+</title>

<screenshot>

<mediaobject><imageobject> <imagedata fileref="figures/gaa.jpg"/> </imageobject> <textobject> <phrase> Architecture de l'accessibilité de GNOME </phrase> </textobject></mediaobject>

</screenshot>

<para>

ATK is the toolkit that GNOME uses to enable accessibility for users needing extra support to make the most of their computers. ATK is used by tools such as screen readers, magnifiers, and input devices to permit a rich interaction with the desktop through alternative means. See <ulink url="http://java-gnome.sourceforge.net/4.0/doc/api/org/gnome/atk/package-summary.html">the ATK SourceForge Project</ulink> and <ulink url="http://library.gnome.org/devel/atk/stable/">the ATK Library</ulink> for more information.

</para>

<para>AT-SPI est l'interface de service principale par laquelle les technologies d'assistance effectuent leurs requêtes et reçoivent les notifications des applications en fonctionnement. L'API complète peut être explorée <ulink url="http://library.gnome.org/devel/at-spi-cspi/stable/">ici</ulink>. Plus d'informations sont disponibles via <ulink url="http://accessibility.kde.org/developer/atk.php#coreclasses">la communauté de développement de l'accessibilité KDE</ulink>.</para>

<para>GAIL (GNOME Accessibility Implementation Library) est une implémentation des interfaces d'accessibilité définies par ATK. GTK est une boîte à outils qui est déjà liée à ATK par le module GAIL. La licence, la procédure de téléchargement et d'autres informations sont disponibles <ulink url="http://www.t2-project.org/packages/gail.html">ici</ulink>. Le <ulink url="ftp://ftp.gnome.org/pub/GNOME/sources/gail/">code source de GAIL</ulink> est aussi un excellent tutoriel pour une utilisation avancée d'ATK. De plus, vous pouvez être intéressé par le <ulink url="http://library.gnome.org/devel/gail-libgail-util/stable/">manuel de référence de GAIL</ulink>.</para>

<para>GTK+ est une bibliothèque utilisée pour créer des interfaces graphiques. Elle fonctionne avec de nombreuses plateformes de type UNIX, Windows et avec des consoles graphiques. GTK+ est distribuée sous la licence de bibliothèque publique générale GNU (GNU LGPL), qui est une licence d'utilisation flexible pour les applications clientes. L'architecture de GTK+ se base sur le langage C orienté objet, qui permet une flexibilité maximum. Des liaisons vers d'autres langages existent pour le C++, Objective-C, Guile/Scheme, Perl, Python, TOM, Ada95, Free Pascal et Eiffel.</para>

<para>

For additional, in-depth information regarding GTK/GTK+, see the <ulink url="http://library.gnome.org/devel/gtk">GTK+ Reference Manual</ulink>, <ulink url="http://wiki.gnome.org/Accessibility/Documentation/GNOME2/AtkGuide/Gtk">the GTK section of the ATK Guide</ulink>, the GNOME-hosted <ulink url="http://library.gnome.org/devel/gtk-tutorial/stable/">GTK+ 2.0 Tutorial</ulink> and the official <ulink url="http://library.gnome.org/devel/gtk-faq/stable/">GTK+ FAQ</ulink>.

</para>

</section>

</section>

<section id="gad-overview">

<title>Rendre une application GNOME accessible - aperçu</title>

<para>Si votre application n'utilise que des éléments graphiques GTK standards, vous aurez peu ou pas de travail pour que votre application soit (raisonnablement) accessible. Mais faites attention aux objets dans votre GUI qui n'ont pas de texte de description associé, tel que des boutons graphiques ou des indicateurs d'état qui n'ont pas d'étiquette ou d'infobulle.</para>

<para>

You can probably also improve on the default descriptions provided for some of the widgets, and tailor them to that widget's specific purpose in your application. You should add or change the textual descriptions for these widgets with the appropriate ATK function call, so that an assistive technology can describe their purpose or state to the user. See <link linkend="gad-coding-guidelines">Coding Guidelines for Supporting Accessibility</link> for more information.

</para>

<para>Si votre application utilise des éléments graphiques personnalisés, vous allez sûrement devoir travailler un peu pour rendre leurs propriétés visibles par les technologies d'assistance. Pour plus d'informations, consultez la section pour <link linkend="gad-custom">rendre les composants personnalisés accessibles</link> et les <link linkend="gad-api-examples">exemples d'utilisation de l'API d'accessibilité</link>. Des informations plus détaillées peuvent être trouvées dans la présentation de Marc Mulcahy au GUADEC 2002 : « <ulink url="https://projects.gnome.org/accessibility/talks/GUAD3C/making-apps-accessible/start.html">Rendre les applications GNOME accessibles</ulink> ».</para>

</section>

<section id="gad-coding-guidelines">

<title>Directives de codage pour la prise en charge de l'accessibilité</title>

<para>Voici plusieurs choses que vous pouvez faire pour que votre programme fonctionne au mieux avec les technologies d'assistance (vous trouverez une liste des choses à considérer lorsque vous concevez votre GUI dans la section sur les <link linkend="gad-ui-guidelines">directives pour la prise en charge de l'accessibilité dans l'interface utilisateur</link> plus loin dans ce document) :</para>

<itemizedlist>

<listitem>

<para>Pour les composants qui n'affichent pas de chaîne de texte courte (tel qu'un bouton graphique), donnez lui un nom avec la fonction <function>atk_object_set_name()</function>. Vous pourriez utiliser cette fonction pour les boutons qui n'affichent qu'une image, les panneaux qui regroupent des fonctions de manière logique, les zones de texte...</para>

</listitem>

<listitem>

<para>Si vous ne pouvez pas fournir d'infobulle pour un composant, utilisez la fonction <function>atk_object_set_description()</function> à la place pour fournir une description que les technologies d'assistance peuvent renvoyer à l'utilisateur. Par exemple, pour fournir une description accessible pour un bouton <guibutton>Fermer</guibutton> :</para>

<example>

<title>Description accessible pour un bouton GtkButton</title>

<programlisting>

{

  AtkObject *obj;

  obj = gtk_widget_get_accessible(button);

  atk_object_set_description(obj,_("Ferme la fenêtre"));

}

</programlisting>

</example>

</listitem>

<listitem>

<para>Utilisez la fonction <function>atk_image_set_description()</function> pour fournir le texte de description pour toutes les images et icônes de votre programme.</para>

</listitem>

<listitem>

<para>Si plusieurs composants forment un groupe logique, essayez de les mettre dans un même conteneur.</para>

</listitem>

<listitem>

<para>Quand vous avez une étiquette qui décrit un autre composant, utilisez la fonction <function>atk_relation_set_add_relation()</function> pour que les technologies d'assistance puissent trouver le composant associé à cette étiquette (si vous associez l'étiquette au composant avec la fonction <function>gtk_label_set_mnemonic_widget()</function>, la relation <constant>ATK_RELATION_LABEL_FOR</constant> est générée automatiquement, donc le code suivant n'est plus nécessaire) :</para>

<example>

<title>Lien entre un GtkLabel et un GtkWidget</title>

<programlisting>

{

  GtkWidget *widget;

  GtkLabel *label;

  AtkObject *atk_widget, *atk_label;

  AtkRelationSet *relation_set;

  AtkRelation *relation;

  AtkObject *targets[1];

  atk_widget = gtk_widget_get_accessible(widget);

  atk_label = gtk_widget_get_accessible (GTK_WIDGET(label));

  relation_set = atk_object_ref_relation_set (atk_label);

  targets[0] = atk_widget;

  relation = atk_relation_new(targets,1, ATK_RELATION_LABEL_FOR);

  atk_relation_set_add(relation_set,relation);

  g_object_unref(G_OBJECT(relation));

}

</programlisting>

</example>

</listitem>

<listitem>

<para>Si vous créez un élément graphique personnalisé, assurez-vous qu'il prend en charge l'accessibilité. Les composants personnalisés qui sont des descendants d'éléments graphiques GTK doivent remplacer les informations d'accessibilité héritées quand c'est nécessaire. Pour plus d'informations, consultez la section pour <link linkend="gad-custom">rendre les composants personnalisés accessibles</link>.</para>

</listitem>

<listitem>

<para>Ne cassez pas ce que vous pouvez obtenir sans effort ! Si votre GUI contient un conteneur inaccessible, tous les composants qu'il contient, risquent de l'être aussi.</para>

</listitem>

</itemizedlist>

</section>

<section id="gad-api">

<title>API d'accessibilité</title>

<para>Voici quelques-uns des appels de base à l'API dont vous pouvez avoir besoin dans votre application pour vous assurer qu'elle fonctionne correctement avec les technologies d'assistance. L'API d'accessibilité complète est vaste pour vous permettre d'écrire vos propres éléments graphiques accessibles personnalisés.</para>

<title>Appels à l'API ATK couramment utilisés</title>

<tgroup cols="2" align="left">

<row>

<entry>API</entry>

<entry>Description</entry>

</row>

<row>

<entry>

<para><function>AtkObject* gtk_widget_get_accessible (GtkWidget*)</function></para>

</entry>

<entry>

<para>Renvoie l'objet accessible qui décrit l'élément graphique GTK spécifié, vers une technologie d'assistance.</para>

</entry>

</row>

<row>

<entry>

<para><function>void atk_object_set_name (AtkObject*, const gchar*)</function></para>

</entry>

<entry>

<para>Définit le nom de l'objet accessible. Par exemple, si l'objet est un bouton graphique qui permet de quitter l'application quand on clique dessus, le nom peut être « Quitter ».</para>

</entry>

</row>

<row>

<entry>

<para><function>void atk_object_set_description (AtkObject*, const gchar*)</function></para>

</entry>

<entry>

<para>Définit le texte de description de l'objet accessible. Par exemple, si l'objet est un bouton graphique « Fermer », la description peut être « Ferme la fenêtre ».</para>

</entry>

</row>

<row>

<entry>

<para><function>AtkRelation* atk_relation_new (AtkObject**, gint, AtkRelationType)</function></para>

</entry>

<entry>

<para>Crée une nouvelle relation entre la clé spécifiée et la liste d'objets cibles spécifiée. Une relation indique normalement à la technologie d'assistance qu'un élément graphique est connecté à un autre. Par exemple, un élément graphique GtkLabel particulier est la légende d'un élément graphique GtkTreeView dans la même fenêtre.</para>

</entry>

</row>

<row>

<entry>

<para><function>void atk_image_set_description (AtkImage*, const gchar*)</function></para>

</entry>

<entry>

<para>Définit le texte de description d'un objet image accessible. Par exemple, si l'objet est une miniature d'un bureau virtuel dans une applet de tableau de bord, la description peut être « Image montrant l'arrangement des fenêtres sur le bureau 1 ».</para>

</entry>

</row>

</tgroup>

</section>

<section id="gad-api-examples">

<title>Exemples d'utilisation de l'API d'accessibilité</title>

<para>Comme remarqué plus tôt, vous avez peu ou pas de travail à faire pour rendre votre application accessible si vous utilisez les éléments graphiques de GTK, ou n'importe quel élément graphique provenant de bibliothèques qui implémentent les interfaces ATK. Les deux choses les plus courantes que vous allez faire dans ce cas sont :</para>

<itemizedlist>

<listitem>

<para>fournir des descriptions pour certains contrôles et images avec les fonctions <function>atk_object_set_description()</function> ou <function>atk_image_set_description()</function> :</para>

<example>

<title>Définition de la description d'accessibilité pour un bouton</title>

<programlisting>

{

   AtkObject *obj;

   obj = gtk_widget_get_accessible(button);

   atk_object_set_description(obj,_("Ouvre la boîte de dialogue Préférences"));

}

</programlisting>

</example>

<para>

</para>

</listitem>

<listitem>

<para>spécifier des relations entre tout regroupement inhabituel d'éléments graphiques en utilisant les fonctions <function>atk_relation_new()</function> et <function>atk_relation_set_add()</function> :</para>

<example>

<title>Spécification des relations d'accessibilité entre deux contrôles</title>

<programlisting>

{

  GtkWidget *widget;

  GtkLabel *label;

  AtkObject *atk_widget, *atk_label;

  AtkRelationSet *relation_set;

  AtkRelation *relation;

  AtkObject *targets[1];

  atk_widget = gtk_widget_get_accessible (widget);

  atk_label = gtk_widget_get_accessible (GTK_WIDGET(label));

  relation_set = atk_object_ref_relation_set (atk_label);

  targets[0] = atk_widget;

  relation = atk_relation_new(targets,1, ATK_RELATION_LABEL_FOR);

  atk_relation_set_add(relation_set,relation);

  g_object_unref(G_OBJECT(relation));

}

</programlisting>

</example>

</listitem>

</itemizedlist>

<para>Les exemples dans la suite de cette section, vont vous donner un aperçu de l'étendue d'ATK. Ils couvrent des techniques dont vous pouvez ne jamais avoir besoin en tant que développeur d'application, bien qu'elles puissent vous intéresser si vous écrivez vos propres éléments graphiques personnalisés (consultez la section pour <link linkend="gad-custom">rendre vos composants personnalisés accessibles</link>) ou si vous voulez écrire une application de technologie d'assistance. Quel que soit votre but, le <ulink url="ftp://ftp.gnome.org/pub/GNOME/sources/gail/">code source de GAIL</ulink> est un excellent tutoriel pour une utilisation avancée d'ATK. Notez que depuis GTK+ 3.1.10, le module Gail a été fusionné dans GTK+ et n'existe plus seul.</para>

<section>

<title>Modules Gtk</title>

<para>Les programmes qui utilisent GAIL (la bibliothèque d'implémentation d'accessibilité pour les éléments graphiques GTK) sont écrits sous la forme de modules GTK. Les modules GTK sont chargés dans l'espace du programme si la variable d'environnement <varname>GTK_MODULES</varname> spécifie le(s) nom(s) de la bibliothèque de module. S'il y a plusieurs bibliothèques de modules, séparez-les par des deux-points. Par exemple :</para>

<para><userinput>setenv GTK_MODULES "libgail:libtestprops"</userinput></para>

<para>Tous les modules GTK possèdent une fonction <function>gtk_module_init()</function>.</para>

</section>

<section>

<title>Collecte des informations d'accessibilité depuis une application</title>

<para>Un programme qui souhaite utiliser des appels ATK doit faire une (ou plusieurs) des actions suivantes :</para>

<orderedlist>

<listitem>

<para>Créer un moniteur d'évènement, par exemple avec la fonction <function>atk_add_focus_tracker()</function> :</para>

<programlisting>atk_add_focus_tracker (_mon_moniteur_evenement);</programlisting>

<para>où <function>_mon_moniteur_evenement()</function> est une fonction qui utilise ce prototype :</para>

<programlisting>void _mon_moniteur_evenement (AtkObject *aobject);</programlisting>

</listitem>

<listitem>

<para>Définir un auditeur d'évènements global avec la fonction atk_add_global_event_listener() :</para>

<programlisting>

mouse_watcher_focus_id =   atk_add_global_event_listener(_mon_auditeur_global,"Gtk:GtkWidget:enter_notify_event");

</programlisting>

<para>où <function>_mon_auditeur_global</function> contient le prototype Glib <type>GSignalEmissionHook</type>. Cet exemple fait en sorte que la fonction <function>_mon_auditeur_global()</function> soit appelée quand un signal enter_notify_even se produit sur un objet <type>GtkWidget</type>.</para>

</listitem>

<listitem>

<para>Accéder aux objets de niveau supérieur d'ATK avec l'appel de fonction suivant :</para>

<programlisting>AtkObject *root_obj = atk_get_root();</programlisting>

<para>

This returns an <type>AtkObject</type> which contains all toplevel windows in the currently running program. The user could then navigate through the object hierarchy by accessing the root object's children, which corresponds to the toplevel windows.

</para>

</listitem>

</orderedlist>

</section>

<section>

<title>Requête d'interfaces d'un <type>AtkObject</type></title>

<para>Après avoir localisé l'objet <type>AtkObject</type> associé avec un objet dans l'application (par ex. avec la fonction <function>gtk_widget_get_accessible()</function>), vous pouvez trouver quelles interfaces il implémente de plusieurs façons :</para>

<orderedlist>

<listitem>

<para>Utilisez les macros <function>ATK_IS_...</function> fournies, par exemple :</para>

<itemizedlist>

<listitem>

<para><function>ATK_IS_ACTION(atkobj)</function></para>

</listitem>

<listitem>

<para><function>ATK_IS_COMPONENT(atkobj)</function></para>

</listitem>

<listitem>

<para>etc. (il y en a une pour chaque interface)</para>

</listitem>

</itemizedlist>

<para>Si la macro renvoie <function>TRUE</function> (VRAI), les appels de l'interface peuvent être effectués sans problème sur cet objet ATK.</para>

</listitem>

<listitem>

<para>Testez le rôle de l'objet <type>AtkObject</type> en appelant la fonction <function>atk_object_get_role()</function>. Chacun des rôles obtenus implémente un numéro spécifique d'API ATK.</para>

</listitem>

</orderedlist>

</section>

<section>

<title>Configuration d'un gestionnaire de signal ATK</title>

<para>Utilisez le signal <constant>column_inserted</constant> comme exemple :</para>

<programlisting>

table_column_inserted_id = g_signal_connect_closure_by_id (mon_obj_atk, 

g_signal_lookup("column_inserted", G_OBJECT_TYPE(mon_obj_atk)), 0, 

g_cclosure_new(G_CALLBACK (_ma_fonct_tableau_colonne_inseree), NULL, NULL), FALSE);

</programlisting>

<para>La fonction <function>_ma_fonct_tableau_colonne_inseree()</function> est alors appelée à chaque fois qu'un signal column_inserted est émis sur l'objet <type>AtkObject</type> <varname>mon_obj_atk</varname>.</para>

<para>La connexion à un signal est un peu différente si le signal prend en charge les détails. Le signal <constant>children_changed</constant> prend en charge le détail <parameter>add</parameter>. Pour se connecter à un signal quand le détail <parameter>add</parameter> est aussi spécifié, cette technique est utilisée :</para>

<programlisting>

child_added_id = g_signal_connect_closure (my_atk_obj,"children_changed::add",

g_cclosure_new (G_CALLBACK(_my_children_changed_func), NULL, NULL), FALSE);

</programlisting>

<para>

This will cause <function>_my_children_changed_func()</function> to be called whenever a <constant>children_changed</constant> signal with the <parameter>add</parameter> detail is emitted on the <type>AtkObject</type> <varname>my_atk_obj</varname>.

</para>

</section>

<section>

<title>Implémentation d'un objet ATK</title>

<para>Vous devrez implémenter vos propres objets ATK pour tous les éléments graphiques qui n'ont pas déjà une implémentation accessible dans GAIL (ou la bibliothèque équivalente pour d'autres jeux d'éléments graphiques). Vous devez implémenter ceci sous la forme d'un module GTK, qui, comme précédemment, doit être inclus dans la variable d'environnement <envar>GTK_MODULES</envar> afin qu'il soit chargé au lancement. </para>

<section>

<title>Registre</title>

<para>Dans cet exemple nous allons supposer qu'il existe un objet appelé GTK_TYPE_MONTYPE. L'implémentation ATK est appelée <type>MON_IMP_ATK_TYPE_MONTYPE</type>. Une fabrique est nécessaire et est appelée <type>MON_IMP_ATK_TYPE_MONTYPE_FABRIQUE</type>.</para>

<para>Pour enregistrer l'implémentation ATK d'un objet GTK, les étapes suivantes doivent être suivies dans la fonction <function>gtk_module_init()</function> du module :</para>

<orderedlist>

<listitem>

<para>Accès au registre par défaut :</para>

<programlisting>

default_registry = atk_get_default_registry();

</programlisting>

</listitem>

<listitem><para>Enregistrement de l'objet ATK dans la fonction <function>gtk_module_init()</function> de ce module à l'aide de l'appel de fonction suivant :</para>

<programlisting>

atk_registry_set_factory_type (default_registry, GTK_TYPE_MYTYPE, 

MYATKIMP_TYPE_MYTYPE_FACTORY); 

</programlisting>

</listitem>

</orderedlist>

<para>Cela enregistre l'implémentation de l'AtkObject de <type>GTK_TYPE_MONTYPE</type> dans <type>MON_IMP_ATK_TYPE_MONTYPE_FABRIQUE</type>. Cette fabrique sera implémentée afin qu'elle sache construire les objets de type <type>MON_IMP_ATK_TYPE_MONTYPE</type>.</para>

</section>

<section>

<title>Fabrique</title>

<para>La fabrique doit être implémentée comme un enfant du type de classe <type>ATK_TYPE_OBJECT_FACTORY</type> et doit implémenter la fonction <function>create_accessible()</function>. Cette fonction doit créer un objet <type>AtkObject</type> approprié. Une fabrique peut être utilisée pour créer plus d'un type d'objet, dans ce cas sa fonction <function>create_accessible()</function> doit être suffisamment intelligente pour construire et renvoyer l'objet <type>AtkObject</type> correct.</para>

</section>

<section>

<title>Implémentation ATK pour un objet spécifique</title>

<para>Tous les objets <type>GObject</type> implémentent une fonction <function>get_type()</function>. En utilisant l'exemple précédent, la convention d'attribution de nom pour cette fonction est <function>mon_imp_atk_montype_get_type()</function>.</para>

<para>Dans cette fonction, vous spécifiez quelles interfaces sont implémentées par votre objet. Si la logique suivante est incluse dans cette fonction <function>get_type()</function>, cet objet implémente alors l'interface <type>ATK_TEXT</type> :</para>

<example>

<title>Exemple de fonction <function>get_type()</function></title>

<programlisting>

static const GInterfaceInfo atk_text_info = 

{ 

   (GInterfaceInitFunc) atk_text_interface_init, 

   (GInterfaceFinalizeFunc) NULL, 

   NULL 

}; 

g_type_add_interface_static (type, ATK_TYPE_TEXT, 

                             &atk_text_info); 

</programlisting>

</example>

<para>La fonction <function>atk_text_interface_init()</function>, qui possède le prototype suivant, doit être implémentée :</para>

<programlisting>

void atk_text_interface_init (AtkTextIface *iface); 

</programlisting>

<para>Cette fonction connecte les appels de la fonction d'interface à l'implémentation spécifique comme suit :</para>

<example>

<title>Connexion des appels d'interface personnalisés à une implémentation d'AtkObject</title>

<programlisting>

void 

atk_text_interface_init (AtkTextIface *iface) 

{ 

   g_return_if_fail (iface != NULL); 

   iface->get_text = mon_imp_atk_montype_get_text; 

   iface->get_character_at_offset = mon_imp_atk_montype_get_character_at_offset; 

   ... 

}

</programlisting>

</example>

<para>Ensuite les fonctions <function>mon_imp_atk_montype_get_text()</function>, <function>mon_imp_atk_montype_get_character_at_offset()</function> et le reste des fonctions de l'interface <type>ATK_TEXT</type> doivent être implémentés.</para>

</section>

<section>

<title>Implémentation d'<type>AtkObject</type></title>

<para>Les <type>AtkObject</type> sont des objets <type>GObjects</type> et tous les <type>GObject</type> doivent spécifier la fonction <function>get_type()</function>. Voici un exemple qui définit une classe et un initialisateur d'instance. Cette fonction <function>get_type()</function> spécifie aussi que l'objet implémente <type>ATK_TEXT</type> et spécifie l'objet parent comme un <type>MON_IMP_ATK_MONTYPEPARENT</type>.</para>

<example>

<title>Exemple d'implémentation de <function>get_type()</function></title>

<programlisting>

GType 

mon_imp_atk_montype_get_type (void) 

{ 

   static GType type = 0; 

   if (!type) 

   { 

      static const GTypeInfo tinfo = 

      { 

         sizeof (GailLabelClass), 

         (GBaseInitFunc) NULL,                                  /* initialisation base */ 

         (GBaseFinalizeFunc) NULL,                              /* finalisation base */

         (GClassInitFunc) mon_imp_atk_montype_class_init,       /* class init */ 

         (GClassFinalizeFunc) NULL,                             /* class finalize */ 

         NULL,                                                  /* données de la classe */ 

         sizeof (GailLabel),                                    /* taille de l'instance */ 

         0,                                                     /* nbre préallocations */ 

         (GInstanceInitFunc) mon_imp_atk_montype_instance_init, /* instance init */ 

         NULL                                                   /* tableau de valeur */ 

      }; 

      /* Organisation de la structure atk_text_info utilisée ci-dessous */ 

      static const GInterfaceInfo atk_text_info = 

      { 

         (GInterfaceInitFunc) atk_text_interface_init, 

         (GInterfaceFinalizeFunc) NULL, 

         NULL 

      }; 

      /* Organisation du typename et spécification du type du parent */ 

      type = g_type_register_static (MON_IMP_ATK_MONTYPEPARENT, 

            "monimpatkmontype", &tinfo, 0); 

      /* Cette classe implémente l'interface ATK_TYPE_TEXT */ 

      g_type_add_interface_static (type, ATK_TYPE_TEXT, 

                                   &atk_text_info); 

   } 

   return type; 

} 

</programlisting>

</example>

</section>

<section>

<title>Initialisateurs de classe/instance</title>

<para>Vous allez devoir configurer un initialisateur de classe pour l'objet <type>GObject</type> dans l'un des deux cas suivants : si votre implémentation d'<type>AtkObject</type></para>

<orderedlist>

<listitem>

<para>redéfinit un des appels de fonction défini par l'objet parent. C'est en général nécessaire quand un objet doit implémenter une fonction comme <function>atk_object_get_n_accessible_children()</function>. C'est nécessaire si l'objet possède des fils qui ne sont pas représentés par des éléments graphiques.</para>

<para>Par exemple, si votre implémentation ATK doit remplacer la fonction <function>get_name()</function> d'<type>AtkObject</type> alors l'initialisateur de classe ressemblera à :</para>

<example>

<title>Initialisateur de classe qui remplace la fonction <function>get_name()</function> du parent.</title>

<programlisting>

mon_imp_atk_montype_class_init (GailLabelClass *klass) 

{ 

  AtkObjectClass *class = ATK_OBJECT_CLASS (klass); 

  class->get_name = mon_imp_atk_montype_get_name; 

} 

</programlisting>

</example>

</listitem>

<listitem><para>ou si elle requiert une fonction <function>parent->init</function>, <function>parent->notify_gtk</function> ou <function>parent->finalize</function>. Cet exemple définit les trois :</para>

<example>

<title>Initialisateur de classe qui définit ses propres fonctions <function>init()</function>, <function>notify_gtk()</function> et <function>finalize()</function></title>

<programlisting>

static ParentObjectType *parent_class = NULL; 

mon_imp_atk_montype_class_init (GailLabelClass *klass) 

{ 

   ParentObjectType *parent_class = (ParentObjectType*)klass; 

   /* 

    * La mise en cache de parent_class est nécessaire si les fonctions 

    * init, notify_gtk ou finalize sont configurées. 

    */ 

    parent_class = g_type_class_ref (MONATKIMP_TYPE_PARENT); 

    parent_class->init = mon_imp_atk_montype_widget_init; 

    parent_class->notify_gtk = mon_imp_atk_montype_real_notify_gtk; 

    parent_class->finalize = mon_imp_atk_montype_finalize; 

}

</programlisting>

</example>

<orderedlist>

<listitem>

<para>parent->init</para>

<para>Une fonction <function>parent->init()</function> peut être nécessaire si l'implémentation ATK a besoin d'effectuer l'une des actions suivantes :</para> 

<orderedlist>

<listitem>

<para>mettre en cache toutes les données obtenues à partir de l'élément graphique GTK auxiliaire,</para>

</listitem>

<listitem>

<para>écouter tous les signaux émis par l'élément graphique GTK auxiliaire.</para>

</listitem>

</orderedlist>

<para>Voici un exemple des deux :</para>

<example>

<title>Une fonction personnalisée <function>init()</function></title>

<programlisting>

void 

gail_tree_view_widget_init (Monimpatkmontype  *montype, 

                            GtkWidget       *gtk_widget) 

{ 

   /* Être sûr d'appeler la fonction init du parent */ 

   parent_class->init (widget, gtk_widget); 

   /* Mettre en cache une valeur dans l'implementation ATK */ 

   montype->cached_value = gtk_widget_function_call(); 

   /* Écouter un signal */ 

   gtk_signal_connect (GTK_OBJECT (gtk_widget), 

                       "type-signal", 

                       GTK_SIGNAL_FUNC (_mon_imp_atk_montype_signal_type), 

                       NULL); 

} 

</programlisting>

</example>

<para>Dans cet exemple, si le signal <type>type-signal</type> spécifié est généré par le <varname>gtk_widget</varname> auxiliaire alors la fonction <function>_mon_imp_atk_montype_signal_type()</function> est appelée.</para>

</listitem>

<listitem>

<para>parent->notify_gtk</para>

<para>Si l'implémentation d'ATK doit écouter toutes les notifications de propriété de l'objet GTK auxiliaire, une fonction  <function>parent->notify_gtk()</function> peut être nécessaire. Par exemple :</para>

<example>

<title>Une fonction personnalisée <function>notify_gtk()</function></title>

<programlisting>

void 

mon_imp_atk_montype_real_notify_gtk (GObject    *obj, 

                                 GParamSpec *pspec) 

{ 

   GtkWidget *widget = GTK_WIDGET (obj); 

   AtkObject* atk_obj = gtk_widget_get_accessible (widget); 

   if (strcmp (pspec->name, "propriété-concernée") == 0) 

   { 

      /* Gestion de la modification de propriété. */ 

   } 

   else 

   { 

      parent_class->notify_gtk (obj, pspec); 

   } 

} 

</programlisting>

</example>

</listitem>

<listitem>

<para>parent->finalize</para>

<para>S'il est nécessaire de libérer toutes les données quand une instance <type>GObject</type> est détruite alors il y a besoin d'une fonction <function>finalize()</function> pour libérer la mémoire. Par exemple :</para>

<example>

<title>Une fonction personnalisée <function>finalize()</function></title>

<programlisting>

void 

mon_imp_atk_montype_finalize (GObject *object) 

{ 

   MonImpAtkMonType *mon_type = MONIMPATK_MONTYPE (object); 

   g_object_unref (mon_type->cached_value); 

   G_OBJECT_CLASS (parent_class)->finalize (object); 

} 

</programlisting>

</example>

</listitem>

</orderedlist>

</listitem>

</orderedlist>

</section>

</section>

</section>

<section id="gad-custom">

<title>Rendre les composants personnalisés accessibles</title>

<para>L'ajout de la prise en charge ATK à votre élément graphique personnalisé assure de sa coopération avec les infrastructures d'accessibilité. Voici les étapes générales requises :</para>

<itemizedlist>

<listitem>

<para>accéder à un élément graphique personnalisé en suivant les <link linkend="gad-ui-guidelines">directives d'interface utilisateur</link> concernées ;</para>

</listitem>

<listitem>

<para>

determine which <ulink url="https://developer.gnome.org/atk/stable/interfaces.html">ATK interfaces</ulink> a custom widget should implement, according to the widget's feature set and function;

</para>

</listitem>

<listitem>

<para>

assess which <ulink url="https://developer.gnome.org/atk/stable/interfaces.html">ATK interfaces</ulink> can be inherited from the parent widget class;

</para>

</listitem>

<listitem>

<para>implémenter les interfaces ATK appropriées pour la classe d'élément graphique d'une des deux façons suivantes :</para>

<itemizedlist>

<listitem>

<para>directement par un élément graphique personnalisé ou</para>

</listitem>

<listitem>

<para>dans un sous-type <ulink url="http://library.gnome.org/devel/atk/stable/AtkObject.html"><type>AtkObject</type></ulink> créé par une nouvelle sous-classe <ulink url="http://library.gnome.org/devel/atk/stable/AtkObjectFactory.html"><type>AtkObjectFactory</type></ulink>.</para>

</listitem>

</itemizedlist>

<para>Si la seconde méthode est utilisée, le type de fabrique approprié doit être enregistré avec l'objet <type>AtkObjectFactoryRegistry</type> à l'exécution.</para>

</listitem>

</itemizedlist>

<para>Le <ulink url="ftp://ftp.gnome.org/pub/GNOME/sources/gail/">code source GAIL</ulink> est un excellent tutoriel pour une utilisation avancée d'ATK.</para>

</section>

<section id="gad-ui-guidelines">

<title>Directives pour la prise en charge de l'accessibilité dans l'interface utilisateur</title>

<para>Lors de la conception de l'interface graphique de votre application, il y a un certain nombre de directives simples que vous devez suivre pour être certain qu'elle puisse être utilisée par le plus grand nombre, que ce soit en conjonction avec des technologies d'assistance ou non. Ne faites pas l'erreur de penser qu'il s'agit seulement de « rendre l'interface graphique utilisable pour les personnes handicapées » et que vous n'avez pas à vous inquiéter de savoir si une personne possédant un handicap utilisera un jour votre application. Suivre ces directives améliorera l'ergonomie globale de votre application pour tous les utilisateurs, vous y compris.</para>

<section>

<title>Généralités</title>

<para>Nous sommes tous un jour ou l'autre frustrés de ne pas trouver une fonctionnalité dans une application ou de faire une erreur qui prend plusieurs minutes pour être corriger ; si c'est possible de la corriger. Si vous avez un handicap quelconque, il y a de bonnes chances que les efforts et la perte de temps soient bien plus importants. Suivez ces quelques directives de base pour prévenir ce type de situations pour tous les utilisateurs.</para>

<itemizedlist>

<listitem>

<para>Fournissez la possibilité d'annuler chacune des actions qui modifient les données de l'utilisateur ou les paramètres de l'application. Si possible, fournissez plusieurs niveaux d'annulation et de rétablissement, ainsi qu'un historique pour permettre de prévisualiser quelles actions seront annulées.</para>

</listitem>

<listitem>

<para>Fournissez des commandes pour restaurer les paramètres par défaut. Si un paramètre particulier peut rendre l'application complètement inutilisable pour un individu, par exemple en réduisant la taille des polices, il est alors utile de fournir une option de restauration des paramètres par défaut en dehors de l'application elle-même. Par exemple, à l'aide d'une option en ligne de commande.</para>

</listitem>

<listitem>

<para>Aidez les utilisateur à ne pas commettre d'erreurs. Ceci est particulièrement important pour des actions qui peuvent être lancées accidentellement (comme les actions avec la souris) ou qui ne sont pas faciles à annuler (comme l'écrasement d'un fichier). Considérez la possibilité d'utiliser des boîtes de dialogue de confirmation ou de forcer l'utilisation d'un mode particulier pour effectuer des actions potentiellement dangereuses.</para>

</listitem>

<listitem>

<para>Minimisez le travail mémoire des utilisateurs. Par exemple, permettez à l'utilisateur de regarder plusieurs documents en même temps et assurez-vous que l'aide en ligne ou d'autres instructions peuvent rester visibles pendant que la tâche décrite est effectuée. Permettez le copier-coller de toutes les informations affichées partout où des données peuvent être saisies.</para>

</listitem>

<listitem>

<para>Ne faites pas insérer de disques aux utilisateurs. En fonction du handicap de l'utilisateur, il se peut qu'il lui soit difficile d'insérer physiquement un disque ou de le changer, il se peut aussi qu'il ne soit pas capable d'identifier le bon disque dans un premier temps. Si votre application est installée à partir d'un CD-ROM, fournissez l'option de copier tous les fichiers nécessaires sur le disque dur de l'utilisateur.</para>

</listitem>

<listitem>

<para>Ne placez pas les fonctions utilisées fréquemment profondément dans la structure des menus. Que vous utilisiez une souris, le clavier ou tout autre périphérique de saisie, il vaut mieux éviter les éléments de menus placés profondément. En plus de l'effort de mémoire pour les trouver, ils sont toujours plus difficiles et longs à accéder.</para>

</listitem>

<listitem>

<para>N'imposez pas aux utilisateurs des étapes inutiles. Par exemple, les assistants sont utiles pour des utilisateurs qui ont des problèmes pour manipuler un grand nombre d'options à la fois, mais d'autres utilisateurs ont besoin de minimiser le temps et le nombre de saisies au clavier. Ces utilisateurs sont aidés s'il est possible de sauter des étapes inutiles et d'aller directement à l'étape voulue. Pensez à fournir dans les assistants un bouton <guibutton>Terminer</guibutton> qui va directement à la fin et utilise les réponses par défaut pour les étapes intermédiaires. Si le processus contient de nombreuses étapes, pensez à demander à l'utilisateur s'il souhaite effectuer toutes les étapes ou seulement celles utilisées le plus fréquemment.</para>

</listitem>

</itemizedlist>

</section>

<section>

<title>Navigation au clavier</title>

<para>Une interface utilisateur clavier bien conçue joue un rôle important quand vous concevez un logiciel accessible. Les utilisateurs non-voyants peuvent naviguer plus efficacement dans le logiciel à l'aide du clavier, alors que l'utilisation de la souris dépend des retours d'informations visuels fonction de la position du pointeur. Il est aussi possible qu'un handicap moteur empêche un utilisateur d'utiliser la souris, à cause du degré de contrôle nécessaire à sa manipulation.</para>

<para>Il est donc important de rendre toutes les actions de la souris disponibles depuis le clavier et d'inclure une touche d'accès à toutes les barres d'outils, les menus, liens et boutons. Chaque fonction de votre application se doit d'être disponible en utilisant uniquement le clavier. Cachez votre souris lors de vos tests s'il le faut !</para>

<para>La plupart des fonctionnalités doivent être accessibles facilement à l'aide de mnémoniques et raccourcis clavier et de fonctions de navigation intégrées de la boîte à outils. Par contre, des opérations qui requièrent un glisser-déposer, par exemple, peuvent nécessiter plus de réflexion.</para>

<itemizedlist>

<listitem>

<para>Fournissez un accès clavier efficace pour toutes les fonctionnalités de l'application. Certains utilisateurs ne peuvent pas se servir d'une souris, et de nombreux « utilisateurs avancés » préfèrent utiliser le clavier. De nombreux périphériques de technologie d'assistance simulent des évènements claviers plutôt que des évènements souris. Comme la frappe est difficile voire même douloureuse pour certains utilisateurs, il est important de fournir une interface clavier qui minimise le nombre de frappes de touches nécessaire pour une tâche donnée.</para>

</listitem>

<listitem>

<para>Utilisez un ordre de navigation clavier logique. Lors d'une navigation dans une fenêtre avec la touche <keycap>Tab</keycap>, le focus clavier doit se déplacer entre les contrôles dans un ordre prévisible. Dans les environnements linguistiques occidentaux, c'est habituellement de la gauche vers la droite et de haut en bas.</para>

</listitem>

<listitem>

<para>Assurez-vous que l'ordre de parcours des contrôles avec la touche Tab reste correct pour ceux dont l'état activé dépend de l'état d'une case à cocher, d'un bouton radio et d'un bouton poussoir. Lorsqu'un bouton de ce type est sélectionné, tous les contrôles en dépendant doivent être activés et tous ceux qui dépendent d'un autre bouton du groupe doivent être désactivés. Lorsque l'utilisateur sélectionne une case à cocher, un bouton radio ou un bouton poussoir qui possèdent des contrôles en dépendance, ne donnez pas automatiquement le focus au premier contrôle dépendant mais laissez plutôt le focus sur le bouton qui commande cette dépendance.</para>

</listitem>

<listitem>

<para>Ne sur-définissez pas les caractéristiques existantes d'accessibilité au niveau système. Par exemple, <ulink url="http://www.rehab.uiuc.edu/accessx/overview.html">AccessX</ulink> est une extension de Xserver qui est prise en charge depuis X11R6. La caractéristique MouseKeys de cette extension permet de simuler à l'aide du pavé numérique les déplacements de la souris et les clics de boutons. Par conséquent, vous ne pouvez pas ajouter des caractéristiques à l'application qui ne seraient atteintes qu'en utilisant le pavé numérique ; les utilisateurs comptant sur les fonctionnalités de MouseKeys ne pourraient plus les utiliser.</para>

</listitem>

<listitem>

<para>Fournissez plus d'une méthode pour réaliser les tâches au clavier lorsque c'est possible. Certains utilisateurs peuvent trouver certaines touches ou combinaisons plus faciles que d'autres.</para>

</listitem>

<listitem>

<para>Fournissez si possible la possibilité d'utiliser à la fois le clavier et la souris pour accéder à une fonction. Certains utilisateurs ne peuvent utiliser que le clavier ou la souris, mais pas les deux.</para>

</listitem>

<listitem>

<para>N'attribuez pas de moyens d'accès complexes aux opérations clavier fréquemment utilisées. Certaines personnes ne peuvent utiliser qu'une seule main sur le clavier, donc les raccourcis utilisables facilement d'une seule main sont préférables pour les opérations courantes. Dans tous les cas, avoir à réaliser des extensions ou des positionnements difficiles sur le clavier augmente pour tous les utilisateurs le risque de se froisser un muscle, donc de douleurs ou de blessures.</para>

</listitem>

<listitem>

<para>N'exigez pas des utilisations répétées d'appuis simultanés de touches. Certains utilisateurs ne sont capables que d'appuyer et tenir une seule touche enfoncée à la fois. Les technologies d'assistance telles que celles d'AccessX permettent aux utilisateurs d'appuyer sur les touches de manière séquentielle plutôt que simultanément, mais bien sûr cela signifie que l'opération prendra plus de temps pour eux.</para>

</listitem>

<listitem>

<para>Assurez-vous que tout texte pouvant être sélectionné avec la souris puisse également l'être avec le clavier. C'est une facilité pour tous les utilisateurs, mais elle s'adresse plus spécialement à ceux qui ont des difficultés à contrôler finement le mouvement de la souris.</para>

</listitem>

<listitem>

<para>Assurez-vous que les objets qui peuvent être redimensionnés ou déplacés par un glisser-déposer peuvent également l'être avec le clavier, par exemple les icônes ou les fenêtres sur le bureau. Lorsqu'un positionnement et un redimensionnement précis peut se révéler important (par ex. les formes dans un diagramme), pensez également à fournir, soit une boîte de dialogue dans laquelle l'utilisateur peut saisir des coordonnées, soit un moyen de placer les objets sur une grille définie par ce dernier.</para>

</listitem>

<listitem>

<para>N'utilisez pas de fonctions générales de navigation pour déclencher des actions. Par exemple, n'utilisez pas l'usuelle navigation clavier avec la touche <keycap>Tab</keycap> dans une boîte de dialogue pour activer une action associée à un contrôle.</para>

</listitem>

<listitem>

<para>Affichez les menus appelés par le clavier, les fenêtres et les infobulles auprès des objets auxquels ils sont associés. Dans GNOME 2.0, les utilisateurs peuvent activer les menus contextuels avec <keycombo><keycap>Maj</keycap><keycap>F10</keycap></keycombo> et les infobulles avec <keycombo><keycap>Maj</keycap><keycap>F1</keycap></keycombo>. Toutefois, ne masquez ou n'obscurcissez pas entièrement l'objet auquel le menu ou l'infobulle se rapporte.</para>

</listitem>

</itemizedlist>

</section>

<section>

<title>Interaction avec la souris</title>

<para>Prenez en compte le fait que tous les utilisateurs ne peuvent pas utiliser une souris avec la même dextérité et que certains d'entre eux peuvent aussi avoir des difficultés pour voir ou suivre le pointeur de la souris.</para>

<itemizedlist>

<listitem>

<para>Les entrées ne doivent pas dépendre du bouton central ou de droite. En plus d'être physiquement plus difficils à cliquer, certains dispositifs de pointage et de nombreux dispositifs de technologies d'assistance ne prennent en charge ou n'émulent que le bouton gauche de la souris 1. Certaines technologies d'assistance n'émulent même pas du tout la souris mais génèrent des évènements clavier à la place.</para>

</listitem>

<listitem>

<para>Permettez à toutes les opérations d'être annulées avant leur fin. Un appui sur la touche <keycap>Échap</keycap> doit annuler toutes opérations de la souris en cours telles qu'une action de glisser-déposer d'un fichier ou le dessin d'une forme dans une application de dessin.</para>

</listitem>

<listitem>

<para>Fournissez un retour visuel pendant toute la durée d'une opération de glisser-déposer. Quand la souris passe au-dessus de cibles valides, mettez-les en évidence et modifiez le pointeur de la souris. Utilisez le pointeur de souris « dépôt impossible » lorsque vous passez au-dessus de cibles de dépôt non valides. Consultez également les <link linkend="gad-mouse-examples">exemples d'interaction avec la souris</link>.</para>

</listitem>

<listitem>

<para>Ne déformez pas le pointeur de la souris ou ne restreignez pas le mouvement de la souris à une partie de l'écran. Cela peut interférer avec les technologies d'assistance et est habituellement perturbant pour les utilisateurs qui n'utilisent pas les technologies d'assistance.</para>

</listitem>

<listitem>

<para>Ne créez pas de cibles trop petites pour la souris. En général, les cibles doivent être au minimum de la taille de la « zone sensible » autour de la bordure d'une fenêtre redimensionnable dans le gestionnaire/thème de fenêtres actuel ; en gardant à l'esprit qu'un utilisateur à mobilité ou vision réduite peut utiliser un gestionnaire de fenêtres avec des zones plus grandes que celles par défaut.</para>

</listitem>

</itemizedlist>

<section id="gad-mouse-examples">

<title>Exemples d'interaction avec la souris</title>

<figure>

<title>Exemple de pointeur « dépôt impossible » de CDE/Motif</title>

<mediaobject><imageobject> <imagedata fileref="figures/nodrop.png" format="PNG"/> </imageobject> <textobject> <phrase>Exemple d'une forme de pointeur de « cible de dépôt non valide »</phrase> </textobject></mediaobject>

</figure>

</section>

</section>

<section>

<title>Éléments graphiques</title>

<para>Fournissez une option pour personnaliser la présentation de tous les éléments graphiques importants de votre application. Cela la rend plus facile d'utilisation pour des personnes ayant des problèmes visuels ou des difficultés de raisonnement.</para>

<itemizedlist>

<listitem>

<para>Ne codez pas de manière permanente les attributs graphiques tel que ligne, bordure ou largeur des ombres. Ces éléments devraient être idéalement lus depuis le thème GTK ou celui du gestionnaire de fenêtres. Si ce n'est pas possible, fournissez des options dans votre application pour les modifier.</para>

</listitem>

<listitem>

<para>Fournissez des noms descriptifs pour tous les composants de l'interface. La bibliothèque GAIL fournit des descriptions accessibles par défaut pour de nombreux éléments graphiques GTK, mais vous devrez ajouter vos propres descriptions dans certains cas, par exemple les éléments graphiques qui utilisent une image au lieu d'un texte (par ex. un pot dans une palette de couleurs ou une icône sans étiquette). Pensez à remplacer les valeurs par défaut avec d'autres plus utiles ou plus spécifiques à l'application quand c'est possible.</para>

</listitem>

<listitem>

<para>Permettez, si possible, l'affichage monochrome des éléments graphiques en couleurs (par ex. les icônes de barre d'outils). Ces images monochromes doivent s'afficher avec les couleurs de premier et d'arrière-plan que l'utilisateur a lui-même choisi (via son choix de thème GTK) pour une lisibilité maximale. </para>

</listitem>

<listitem>

<para>Rendez les éléments de l'interface graphique facilement reconnaissables. Par exemple, ne forcez pas l'utilisateur à survoler un objet pour déterminer s'il est cliquable ou pas. Laissez suffisamment d'espace entre les objets et délimitez clairement les limites des objets. N'affichez pas d'élément dans l'interface graphique qui soient beaux mais ne servent à rien, sauf si vous fournissez une option pour les désactiver.</para>

</listitem>

<listitem>

<para>Fournissez une option pour cacher les graphiques qui ne sont pas nécessaires à la compréhension. Les images peuvent distraire les utilisateurs ayant des difficultés de raisonnement. Les icônes du menu GNOME, par exemple, peuvent être désactivées tout en laissant les menu fonctionnels.</para>

</listitem>

</itemizedlist>

</section>

<section>

<title>Police et texte </title>

<para>

Even to a user with normal vision, textual output provides the majority of the information and feedback in most applications. It is therefore critical to choose and position text carefully on the screen, and leave the choice of font and size to the user, to ensure that people with vision impairments can also use your application effectively.

</para>

<itemizedlist>

<listitem>

<para>Ne codez pas de manière permanente les styles et tailles des polices de caractères. L'utilisateur doit être capable d'adapter toutes les tailles et tous les styles. Si pour une raison quelconque vous ne pouvez pas rendre cette fonctionnalité disponible, ne codez jamais des tailles de police inférieures à 10 points.</para>

</listitem>

<listitem>

<para>Fournissez l'option de désactiver toutes les toiles de fond graphiques ou « filigranes » placés derrière le texte. Ces images interfèrent avec le contraste entre le texte et l'arrière-plan, ce qui peut causer des difficultés pour les utilisateurs qui ont des problèmes de vision.</para>

</listitem>

<listitem>

<para>Donnez aux objets un nom porteur de sens, même pris hors contexte. Les utilisateurs qui utilisent des lecteurs d'écran ou d'autres technologies d'assistance ne sont pas nécessairement capables de comprendre immédiatement la relation entre un contrôle et son environnement.</para>

</listitem>

<listitem>

<para>N'utilisez pas la même étiquette plus d'une fois dans la même fenêtre. Si vous utilisez la même étiquette dans des fenêtres différentes, il est préférable qu'elles aient le même sens. Pour la même raison, n'utilisez pas d'étiquettes qui s'épellent différemment, mais qui se prononcent d'une façon proche, par ex. « emprunte » et « empreinte », car cela peut troubler les utilisateurs qui utilisent des lecteurs d'écran.</para>

</listitem>

<listitem>

<para>Positionnez les étiquettes de façon consistante partout dans votre application. En général immédiatement sous les grandes icônes, à droite des petites icônes et au-dessus ou à gauche des autres contrôles. Consultez les <link linkend="gad-font-examples">exemples de polices et de texte</link>.</para>

</listitem>

<listitem>

<para>Quand vous utilisez un texte statique pour nommer un contrôle, terminez l'étiquette par deux-points. Par exemple, <guilabel>Nom d'utilisateur :</guilabel> pour nommer une zone de texte dans lequel l'utilisateur doit saisir son nom d'utilisateur. Cela aide à l'identifier comme étiquette du contrôle plutôt que comme élément indépendant.</para>

</listitem>

<listitem>

<para>Quand vous utilisez un texte statique pour nommer un contrôle, assurez-vous que l'étiquette précède le contrôle dans l'ordre de parcours des contrôles avec la touche Tab. Cela assure que le mnémonique (caractère souligné) que vous attribuez à l'étiquette active ou déplace le focus vers le contrôle correct quand il est utilisé.</para>

</listitem>

<listitem>

<para>Fournissez des alternatives au WYSIWYG (What You See Is What You Get). Certains utilisateurs peuvent par exemple avoir besoin d'imprimer le texte avec des petites polices, mais d'utiliser des grandes polices d'écran pour l'édition. Les alternatives possibles sont soit l'affichage de tout le texte dans la même police et taille (toutes deux choisies par l'utilisateur), soit une option « retour à la ligne automatique » qui permet de lire tout le texte d'une fenêtre sans défilement horizontal, soit un affichage en colonne unique (le contenu de la fenêtre est sur une seule colonne bien qu'il soit imprimé sur plusieurs colonnes), soit un affichage texte-seulement pour lequel les graphiques sont remplacés par des substituants ou des descriptions textuelles. Si l'application possède des panneaux contenant des contrôles fils, pensez à permettre aux panneaux de se redimensionner en même temps que la fenêtre parente.</para>

</listitem>

</itemizedlist>

<section id="gad-font-examples">

<title>Exemples de polices et de texte</title>

<figure id="label-placement-example">

<title>Placement correct des étiquettes pour divers éléments de l'interface graphique</title>

<informaltable frame="all">

<tgroup cols="3" align="center">

<row>

<entry valign="middle"><mediaobject>

<imageobject>

<imagedata fileref="figures/label_above.png" format="PNG"/>

</imageobject>

<textobject>

<phrase>List control with label above</phrase>

</textobject>

</mediaobject> Contrôle liste avec une étiquette au-dessus</entry>

<entry valign="middle"><mediaobject>

<imageobject>

<imagedata fileref="figures/label_below.png" format="PNG"/>

</imageobject>

<textobject>

<phrase>Large file manager icon with label underneath</phrase>

</textobject>

</mediaobject>Grande icône de gestionnaire de fichiers avec une étiquette au-dessous</entry>

<entry valign="middle"><mediaobject>

<imageobject>

<imagedata fileref="figures/label_right.png" format="PNG"/>

</imageobject>

<textobject>

<phrase>Small toolbar icon with label to its right</phrase>

</textobject>

</mediaobject>Petite icône de barre d'outils avec une étiquette à droite</entry>

<entry valign="middle"><mediaobject>