1715 lines
94 KiB
Plaintext
1715 lines
94 KiB
Plaintext
<!-- $XConsortium: ch04.sgm /main/11 1996/12/21 18:56:15 rws $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
<chapter id="SAG.RegAp.div.1">
|
|
<title id="SAG.RegAp.mkr.1">Enregistrement d'une application</title>
|
|
<para><indexterm><primary>Enregistrement</primary></indexterm>Ce chapitre
|
|
explique comment créer le module d'enregistrement d'une application
|
|
et enregistrer l'application sur le Bureau.</para>
|
|
<informaltable id="SAG.RegAp.itbl.1" frame="All">
|
|
<tgroup cols="1" colsep="1" rowsep="1">
|
|
<colspec colwidth="4.13in">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Généralités
|
|
sur l'enregistrement des applications58'--><xref role="JumpText" linkend="SAG.RegAp.mkr.3"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etapes
|
|
générales d'enregistrement d'une application62'--><xref role="JumpText" linkend="SAG.RegAp.mkr.5"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
1: Modification des ressources polices et couleurs63'--><xref role="JumpText"
|
|
linkend="SAG.RegAp.mkr.14"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
2: Création du répertoire racine d'une application64'--><xref role="JumpText"
|
|
linkend="SAG.RegAp.mkr.15"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
3: Création des répertoires du module d'enregistrement65'--><xref role="JumpText"
|
|
linkend="SAG.RegAp.mkr.16"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
4: Création des actions et des types de données de l'application67'--><xref
|
|
role="JumpText" linkend="SAG.RegAp.mkr.19"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
5: Insertion des fichiers d'aide dans le module d'enregistrement71'--><xref
|
|
role="JumpText" linkend="SAG.RegAp.mkr.21"></para></entry>
|
|
</row>
|
|
<row rowsep="1">
|
|
<entry><para><!--Original XRef content: 'Step 6: Putting Information Libraries
|
|
in the Registration Package'--><xref role="JumpText" linkend="SAG.RegAp.div.19a"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
7: Création d'icônes pour l'application72'--><xref role="JumpText" linkend="SAG.RegAp.mkr.22"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
8: Création du groupe d'applications73'--><xref role="JumpText" linkend="SAG.RegAp.mkr.23"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: '&Etape
|
|
9: Enregistrement de l'application à l'aide de dtappintegrate80'--><xref role="JumpText"
|
|
linkend="SAG.RegAp.mkr.28"></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><!--Original XRef content: 'Exemple
|
|
de création d'un module d'enregistrement83'--><xref role="JumpText" linkend="SAG.RegAp.mkr.30"></para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
<para id="SAG.RegAp.mkr.2">Une fois entièrement enregistrée
|
|
dans le Bureau, l'application possède:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>son propre groupe d'applications au niveau supérieur
|
|
du Gestionnaire d'applications</para>
|
|
</listitem>
|
|
<listitem><para>une action qui lance l'application. L'action est représentée
|
|
par une icône dans le groupe d'applications</para>
|
|
</listitem>
|
|
<listitem><para>éventuellement, des types de données pour ces
|
|
fichiers de données.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>L'enregistrement ne constitue pas une opération “invasive”
|
|
pour l'application:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>elle n'implique pas la modification de l'exécutable
|
|
de l'application. De ce fait, vous pouvez enregistrer des applications existantes
|
|
sur un système</para>
|
|
</listitem>
|
|
<listitem><para>elle ne requiert pas le déplacement d'un des fichiers
|
|
de l'application (tels que le fichier exécutable et <filename>app-defaults</filename>) vers un autre endroit</para>
|
|
</listitem>
|
|
<listitem><para>elle peut être annulée facilement. L'outil <command>dtappintegrate</command>, utilisé pour enregistrer les applications,
|
|
fournit une option de ligne de commande permettant d'inverser le processus.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>La création de modules d'enregistrement est nécessaire
|
|
dans les cas suivants:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>enregistrement d'applications existantes sur le Bureau (administration
|
|
du système)</para>
|
|
</listitem>
|
|
<listitem><para>création de modules d'installation pour des applications
|
|
adaptées au Bureau CDE (développement)</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect1 id="SAG.RegAp.div.2">
|
|
<title id="SAG.RegAp.mkr.3">Généralités sur l'enregistrement
|
|
des applications<indexterm><primary>Applications</primary><secondary>enregistrement</secondary></indexterm><indexterm><primary>Enregistrement</primary><secondary>généralités</secondary></indexterm></title>
|
|
<para>Cette section explique:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>les fonctions offertes à votre application par l'enregistrement
|
|
;</para>
|
|
</listitem>
|
|
<listitem><para>l'objectif de l'enregistrement des applications.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<note>
|
|
<para>Pour un exemple détaillé d'enregistrement d'une application
|
|
existante, reportez-vous à la section <!--Original XRef content: '”Exemple
|
|
de création d'un module d'enregistrement”, page 83'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.30">.</para>
|
|
</note>
|
|
<sect2 id="SAG.RegAp.div.3">
|
|
<title>Fonctions offertes par<indexterm><primary>Applications</primary><secondary>fonctions de l'enregistrement</secondary></indexterm><indexterm><primary>Module d'enregistrement</primary><secondary>objectif</secondary></indexterm>
|
|
l'enregistrement des applications<indexterm><primary>Enregistrement</primary>
|
|
<secondary>fonctions</secondary></indexterm></title>
|
|
<para><indexterm><primary>Gestionnaire d'applications</primary><secondary>intégration d'applications</secondary></indexterm>L'enregistrement
|
|
d'applications offre aux utilisateurs un outil graphique de localisation des
|
|
applications.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Localisez les applications.</para>
|
|
<para>Lors de son installation, votre application est enregistrée dans
|
|
le Gestionnaire d'applications et possède son propre groupe d'applications.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<figure>
|
|
<title id="SAG.RegAp.mkr.4">Groupes d'applications au niveau supérieur
|
|
du Gestionnaire d'applications</title>
|
|
<graphic id="SAG.RegAp.grph.1" entityref="SAG.RegAp.fig.1"></graphic>
|
|
</figure>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Lancez votre application.</para>
|
|
<para>Le groupe de votre application comporte une icône sur laquelle
|
|
l'utilisateur cliquera deux fois pour lancer l'application.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<figure>
|
|
<title>Groupe d'applications contenant une icône permettant de lancer
|
|
l'application</title>
|
|
<graphic id="SAG.RegAp.grph.2" entityref="SAG.RegAp.fig.2"></graphic>
|
|
</figure>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><indexterm><primary>Applications</primary><secondary>objectif
|
|
pour les types de données</secondary></indexterm><indexterm><primary>Types de données</primary><secondary>objectif de la création</secondary></indexterm>Identifiez et manipulez les fichiers de données.
|
|
Les fichiers de données de l'application possèdent une seule
|
|
icône dans le Gestionnaire de fichiers.</para>
|
|
<para>L'utilisateur peut se servir des icônes des fichiers de données
|
|
pour:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>lancer (ouvrir) l'application,</para>
|
|
</listitem>
|
|
<listitem><para>imprimer les fichiers de données.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<figure>
|
|
<title>Menu instantané d'un fichier de données contenant les
|
|
options ''Ouvrir'' et ''Imprimer''</title>
|
|
<graphic id="SAG.RegAp.grph.3" entityref="SAG.RegAp.fig.3"></graphic>
|
|
</figure>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Vous pouvez ensuite effectuer d'autres opérations (envoi,
|
|
compression, visualisation ou reproduction sonore de données).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.4">
|
|
<title>Objectif de l'enregistrement d'applications<indexterm><primary>Enregistrement</primary><secondary>objectif</secondary></indexterm></title>
|
|
<para><indexterm><primary>Fichiers</primary><secondary>de configuration</secondary>
|
|
<tertiary>module d'enregistrement</tertiary></indexterm>Une application enregistrée
|
|
possède certains fichiers de configuration utilisés par le Bureau
|
|
pour fournir à l'interface utilisateur de l'application:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>des fichiers de définitions des actions et des types
|
|
de données</para>
|
|
</listitem>
|
|
<listitem><para>des fichiers d'images d'icônes (pixmaps ou bitmaps)
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>un répertoire et des fichiers qui créent le
|
|
groupe d'applications</para>
|
|
</listitem>
|
|
<listitem><para>éventuellement, des fichiers d'aide et des fichiers
|
|
de définition du Tableau de bord.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Afin que ces fichiers soient reconnus et utilisés par le Bureau,
|
|
ils doivent figurer dans certains répertoires indiqués par les
|
|
chemins de recherche du Bureau.</para>
|
|
<para>Il est parfois difficile de gérer une application lorsque ses
|
|
fichiers de configuration sont éparpillés dans différents
|
|
répertoires. C'est pourquoi le Bureau permet à une application
|
|
de rassembler tous ses fichiers de configuration dans un seul répertoire.
|
|
Ce regroupement de fichiers est appelé<indexterm><primary>Module d'enregistrement</primary><secondary>définition</secondary></indexterm> <symbol role="Variable">module d'enregistrement</symbol>.</para>
|
|
<para>Si l'application est adaptée au Bureau CDE, son module d'installation
|
|
comporte un module d'enregistrement. Si vous êtes l'administrateur système
|
|
et créez vous-même les fichiers de configuration, vous pouvez
|
|
également créer ce module.</para>
|
|
<para>Le Bureau ne peut pas accéder aux fichiers de configuration du
|
|
module d'enregistrement car ces derniers ne sont pas situés dans les
|
|
répertoires du chemin de recherche adéquats. Le processus consistant
|
|
à les mettre aux emplacements corrects s'appelle<indexterm><primary>Enregistrement</primary><secondary>définition</secondary></indexterm> <symbol role="Variable">l'enregistrement</symbol>, ou <symbol role="Variable">l'intégration</symbol> de l'application.</para>
|
|
<para>Le Bureau fournit un utilitaire, <command>dtappintegrate</command>,
|
|
qui effectue l'enregistrement en créant des liens symboliques des fichiers
|
|
dans les répertoires des chemins de recherche appropriés.</para>
|
|
<para>De nombreuses applications adaptées au Bureau CDE exécuteront
|
|
automatiquement <command>dtappintegrate</command> lors de l'installation.
|
|
Si vous êtes l'administrateur système et intégrez une
|
|
application existante, vous pouvez l'exécuter vous-même après
|
|
avoir créé le module d'enregistrement.</para>
|
|
<para>Lorsqu'une application est enregistrée sur le Bureau d'un système,
|
|
elle est accessible à tous les utilisateurs du système. Si le
|
|
système est configuré en tant que<indexterm><primary>Serveurs</primary><secondary>d'applications</secondary><tertiary>disponibilité</tertiary></indexterm><indexterm><primary>des applications</primary></indexterm> serveur
|
|
d'applications du Bureau, l'application sera également accessible aux
|
|
autres systèmes du réseau.</para>
|
|
<para>L'utilitaire <command>dtappintegrate</command> offre une option de ligne
|
|
de commande permettant d'inverser le processus en supprimant les liens. Il
|
|
est ainsi plus facile de supprimer l'application du Gestionnaire d'applications
|
|
et de la déplacer vers un autre serveur d'applications ou de la mettre
|
|
à jour.</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.5">
|
|
<title id="SAG.RegAp.mkr.5">Etapes générales d'enregistrement
|
|
d'une application<indexterm><primary>Enregistrement</primary><secondary>étapes générales</secondary></indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple détaillé de création d'un module
|
|
d'application, reportez-vous à la section <!--Original XRef content:
|
|
'”Exemple de création d'un module d'enregistrement”, page 83'--><xref
|
|
role="SecTitleAndPageNum" linkend="SAG.RegAp.mkr.30">.</para>
|
|
</note>
|
|
<orderedlist>
|
|
<listitem><para id="SAG.RegAp.mkr.6">Modifiez les ressources de l'application
|
|
qui définissent les polices et les couleurs. Sinon, les polices et
|
|
les couleurs dynamiques du Bureau ne s'afficheront pas correctement.</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 1: Modification des
|
|
ressources polices et couleurs”, page 63'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.14">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.7">Créez un emplacement racine pour
|
|
l'application.</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 2: Création du répertoire
|
|
racine d'une application”, page 64'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.15">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.8">Créez la structure du répertoire
|
|
sous la racine de l'application.</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 3: Création des répertoires
|
|
du module d'enregistrement”, page 65'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.16">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.9">Créez les actions et les types
|
|
de données de l'application.</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 4: Création des actions
|
|
et des types de données de l'application”, page 67'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.19">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.10">Placez les fichiers d'aide dans le répertoire
|
|
approprié.</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 5: Insertion des fichiers
|
|
d'aide dans le module d'enregistrement”, page 71'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.21">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.10a">Placez les fichiers de documentation
|
|
en ligne (infolib) dans le répertoire approprié.</para>
|
|
<para>See <!--Original XRef content: '&xd2;Step 6: Putting the Infolib Files
|
|
in the
|
|
Registration Package&xd3; on page 66'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.div.19a">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.11">Créez les icônes de l'application
|
|
</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 6: Création d'icônes
|
|
pour l'application”, page 72'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.22">.</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.12">Créez le groupe de l'application.
|
|
</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 7: Création du groupe
|
|
d'applications”, page 73'--><xref role="SecTitleAndPageNum" linkend="SAG.RegAp.mkr.23">.
|
|
</para>
|
|
</listitem>
|
|
<listitem><para id="SAG.RegAp.mkr.13">à l'aide de <command>dtappintegrate</command>.</para>
|
|
<para>Voir <!--Original XRef content: '”Etape 8: Enregistrement de
|
|
l'application à l'aide de dtappintegrate” page 80'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.28">.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.6">
|
|
<title id="SAG.RegAp.mkr.14">Etape 1: Modification des ressources polices
|
|
et couleurs<indexterm><primary>Enregistrement</primary><secondary>modification
|
|
des ressources</secondary></indexterm><indexterm><primary>Enregistrement</primary><secondary>modification des ressources</secondary></indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple de modification des ressources d'une application, reportez-vous
|
|
à l' <!--Original XRef content: 'Etape 1'--><xref role="Step"
|
|
linkend="SAG.RegAp.mkr.6"> de la section <!--Original XRef content: '”Exemple
|
|
de création d'un module d'enregistrement”'--><xref role="SectionTitle"
|
|
linkend="SAG.RegAp.mkr.30">, <!--Original XRef content: 'page 84'--><xref
|
|
role="PageNum" linkend="SAG.RegAp.mkr.31">.</para>
|
|
</note>
|
|
<para>Le Bureau fournit des mécanismes de définition et de manipulation
|
|
des polices d'interface et des couleurs de fenêtres. Pour qu'une application
|
|
utilise correctement ces mécanismes, il peut être nécessaire
|
|
de modifier son fichier <filename>app-defaults</filename>.</para>
|
|
<sect2 id="SAG.RegAp.div.7">
|
|
<title>Modification des ressources polices<indexterm><primary>Gestionnaire
|
|
de configuration</primary><secondary>intégration des polices</secondary>
|
|
</indexterm><indexterm><primary>Enregistrement</primary><secondary>modifications
|
|
des polices</secondary></indexterm><indexterm><primary>Polices</primary>
|
|
<secondary>ressources</secondary><tertiary>modification pour enregistrement</tertiary></indexterm></title>
|
|
<note>
|
|
<para>Cette section concerne les applications créées à
|
|
l'aide d'Motif version 1.2 (ou suivantes). Le Gestionnaire de configuration
|
|
ne peut définir des polices d'interface pour les applications rédigées
|
|
avec des versions antérieures d'Motif.</para>
|
|
</note>
|
|
<para>Le Gestionnaire de configuration du Bureau définit des polices
|
|
d'interface pour les applications créées avec Motif version
|
|
1.2 (ou suivantes) si l'application ne requiert pas de polices spécifiques.
|
|
</para>
|
|
<para>Le Gestionnaire de configuration propose deux types de police:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="138*">
|
|
<colspec colwidth="390*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Police système</para></entry>
|
|
<entry align="left" valign="top"><para>Utilisée par les zones système
|
|
telles que les libellés, menus et boutons</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Police utilisateur</para></entry>
|
|
<entry align="left" valign="top"><para>Utilisée pour les zones modifiables
|
|
telles que les zones de texte</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
<para>Chaque police est disponible dans sept tailles, numérotées
|
|
de 1 à 7 dans la boîte de dialogue Polices. Les polices du Gestionnaire
|
|
de configuration sont liées aux polices réelles du système
|
|
par l'intermédiaire du jeu de ressources du Gestionnaire de configuration
|
|
définies dans <filename>/usr/dt/app-defaults/</filename><symbol role="Variable">langue</symbol><filename>/Dtstyle</filename>.</para>
|
|
<para>Si vous souhaitez que l'application utilise les polices du Gestionnaire
|
|
de configuration, supprimez les ressources de l'application comportant des
|
|
références à des polices spécifiques. Le Bureau
|
|
définira alors automatiquement les ressources de l'application.</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="228*">
|
|
<colspec colwidth="228*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><command>FontList</command></para></entry>
|
|
<entry align="left" valign="top"><para>Police système</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>XmText*FontList</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Police utilisateur</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>XmTextField*FontList</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Police utilisateur</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.8">
|
|
<title>Modification des ressources couleurs<indexterm><primary>Enregistrement</primary><secondary>modifications des couleurs</secondary></indexterm><indexterm>
|
|
<primary>Ressources</primary><secondary>couleurs</secondary><tertiary>modifications
|
|
pour enregistrement</tertiary></indexterm></title>
|
|
<para><indexterm><primary>Gestionnaire de configuration</primary><secondary>intégration des couleurs</secondary></indexterm>Le Gestionnaire de
|
|
configuration permet de modifier de façon dynamique les couleurs des
|
|
applications. L'application doit être un client Motif 1.1 ou 1.2.
|
|
Les programmes clients rédigés avec d'autres outils de développement
|
|
ne peuvent pas modifier leurs couleurs dynamiquement. Ces modifications prennent
|
|
effet lors de la réinitialisation du client.</para>
|
|
<para>La manière la plus simple d'utiliser les couleurs du Bureau consiste
|
|
à supprimer toutes les ressources couleurs des applications, qu'il
|
|
s'agisse des couleurs d'avant- ou d'arrière-plan.</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.9">
|
|
<title id="SAG.RegAp.mkr.15">Etape 2: Création du répertoire
|
|
racine d'une application<indexterm><primary>Applications</primary><secondary>répertoire racine</secondary></indexterm><indexterm><primary>Applications</primary><secondary>répertoire racine</secondary></indexterm><indexterm>
|
|
<primary>Enregistrement</primary><secondary>répertoire racine d'une
|
|
application</secondary></indexterm><indexterm><primary>Répertoire</primary>
|
|
<secondary>racine</secondary><tertiary>application</tertiary></indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple de création du répertoire racine d'une
|
|
application du Bureau, reportez-vous à l' <!--Original XRef content:
|
|
'Etape 2'--><xref role="Step" linkend="SAG.RegAp.mkr.7"> de la section <!--Original
|
|
XRef content: '”Exemple de création d'un module d'enregistrement”'--><xref
|
|
role="SectionTitle" linkend="SAG.RegAp.mkr.30">, <!--Original XRef content:
|
|
'page 84'--><xref role="PageNum" linkend="SAG.RegAp.mkr.32">.</para>
|
|
</note>
|
|
<para>Les fichiers du module d'enregistrement de l'application sont regroupés
|
|
dans un répertoire appelé racine de l'application, ou <symbol role="Variable"><indexterm><primary>racine_app</primary><secondary>répertoire
|
|
racine</secondary></indexterm>racine_app</symbol>. Le répertoire <symbol role="Variable">racine_app</symbol> utilisé pour les fichiers de configuration
|
|
du Bureau peut être identique au répertoire <symbol role="Variable">racine_app</symbol> d'installation de l'application ou d'un autre emplacement.
|
|
</para>
|
|
<para>Supposons, par exemple, qu'une application est installée dans
|
|
le répertoire <filename>/usr/BTE</filename>. Ce même répertoire
|
|
peut être utilisé comme répertoire <symbol role="Variable">racine_app</symbol> des fichiers de configuration du Bureau. Cependant, si
|
|
vous intégrez une application “non CDE” existante, il est
|
|
recommandé de créer un répertoire racine de bureau différent,
|
|
afin d'éviter que les fichiers de configuration en cours de création
|
|
ne soient écrasés lors de la mise à jour de l'application.
|
|
</para>
|
|
<para>Par exemple, un administrateur système peut souhaiter créer
|
|
un répertoire <filename>/etc/desktop_approots/BTE</filename> comme
|
|
répertoire racine du Bureau.</para>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.10">
|
|
<title id="SAG.RegAp.mkr.16">Etape 3: Création des répertoires
|
|
du module d'enregistrement<indexterm><primary>Module d'enregistrement</primary>
|
|
<secondary>répertoires</secondary></indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple de création des répertoires du module
|
|
d'enregistrement d'une application, reportez-vous à l'<!--Original
|
|
XRef content: 'Etape 3'--><xref role="Step" linkend="SAG.RegAp.mkr.8">
|
|
de la section <!--Original XRef content: '”Exemple de création d'un
|
|
module d'enregistrement”'--><xref role="SectionTitle" linkend="SAG.RegAp.mkr.30">, <!--Original
|
|
XRef content: 'page 85'--><xref role="PageNum" linkend="SAG.RegAp.mkr.33">.
|
|
</para>
|
|
</note>
|
|
<para>Le module d'enregistrement correspond au groupe de fichiers de configuration
|
|
utilisés par le Bureau afin de fournir une interface graphique à
|
|
l'application.</para>
|
|
<sect2 id="SAG.RegAp.div.11">
|
|
<title>Contenu du module d'enregistrement</title>
|
|
<para>Les fichiers de configuration du Bureau comprennent:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>les fichiers de définitions des actions et des types
|
|
de données</para>
|
|
</listitem>
|
|
<listitem><para>les fichiers d'images d'icônes</para>
|
|
</listitem>
|
|
<listitem><para>un répertoire de groupe d'applications et son contenu
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>éventuellement, les fichiers de données d'aide
|
|
et un fichier de configuration du Tableau de bord.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Le module d'enregistrement est regroupé sous un répertoire
|
|
de premier niveau, appelé racine de l'application ( <symbol role="Variable">racine_app</symbol>).</para>
|
|
<figure>
|
|
<title id="SAG.RegAp.mkr.17">Un module d'enregistrement sous le répertoire
|
|
racine d'une application</title>
|
|
<graphic id="SAG.RegAp.grph.4" entityref="SAG.RegAp.fig.4"></graphic>
|
|
</figure>
|
|
<para>Les principales catégories de zones de configuration dans le
|
|
répertoire <symbol role="Variable">racine_app</symbol> sont:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="147*">
|
|
<colspec colwidth="381*">
|
|
<thead>
|
|
<row><entry align="left" valign="bottom"><para>Sous-répertoire</para></entry>
|
|
<entry align="left" valign="bottom"><para>Contenu</para></entry></row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><command>types</command></para></entry>
|
|
<entry align="left" valign="top"><para>Fichiers de définitions des
|
|
actions et des types de données.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><command>help</command></para></entry>
|
|
<entry align="left" valign="top"><para>Fichiers d'aide du Bureau.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><command>icons</command></para></entry>
|
|
<entry align="left" valign="top"><para>Fichiers d'images bitmaps et pixmaps
|
|
utilisés par les actions et les types de données de l'application.
|
|
</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><command>appmanager</command></para></entry>
|
|
<entry align="left" valign="top"><para>Le répertoire et le contenu
|
|
qui créent le groupe d'applications.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry><para><filename>biblinfo</filename></para></entry>
|
|
<entry><para>Les fichiers de documentation en ligne sont divisés en
|
|
biblinfos, rayons et livres</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
<para>Chacune de ces catégories comporte des sous-répertoires
|
|
pour les fichiers dépendant de la langue. Les fichiers de langue par
|
|
défaut sont placés dans le répertoire <command>C</command>.
|
|
</para>
|
|
<sect3 id="SAG.RegAp.div.12">
|
|
<title>Pour créer un module d'enregistrement</title>
|
|
<itemizedlist>
|
|
<listitem><para>Créez ces répertoires. Si vous avez des fichiers
|
|
de configuration dépendant de la langue, créez un répertoire
|
|
distinct pour chaque langue. Si vous ne proposez qu'une seule langue, placez
|
|
les fichiers dans le répertoire <command>C</command>.</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/help/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/icons/</filename><symbol role="Variable">langue</symbol></para>
|
|
</listitem>
|
|
<listitem><para><filename><symbol role="Variable">racine_app</symbol>/dt/appconfig/appmanager/<symbol role="Variable">langue</symbol>/<symbol role="Variable">groupe_app</symbol></filename>,
|
|
où <symbol role="Variable">groupe_app</symbol> est le nom du groupe
|
|
d'applications.</para>
|
|
<para>Par exemple, la <!--Original XRef content: 'Figure 4‐5'--><xref
|
|
role="CodeOrFigureOrTable" linkend="SAG.RegAp.mkr.18"> affiche le Gestionnaire
|
|
d'applications contenant un groupe dont <symbol role="Variable">groupe_app</symbol> est “Outils_Media”.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<figure>
|
|
<title id="SAG.RegAp.mkr.18">Groupe d'applications au premier niveau du Gestionnaire
|
|
d'applications</title>
|
|
<graphic id="SAG.RegAp.grph.5" entityref="SAG.RegAp.fig.5"></graphic>
|
|
</figure>
|
|
<para>L'outil <command>dtappintegrate</command> fonctionne uniquement sur
|
|
les fichiers de configuration du Bureau dans les répertoires <command>types</command>, <command>help</command>, <command>icons</command>, et <command>appmanager</command>. Le fichier exécutable binaire de l'application, <filename>app-defaults</filename>, et les fichiers de messages de catalogues sont gérés
|
|
séparément.</para>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.13">
|
|
<title id="SAG.RegAp.mkr.19">Etape 4: Création des actions et des
|
|
types de données de l'application<indexterm><primary>Actions</primary>
|
|
<secondary>requises pour l'enregistrement</secondary></indexterm><indexterm>
|
|
<primary>Types de données</primary><secondary>requis pour l'enregistrement</secondary></indexterm><indexterm><primary>Enregistrement</primary><secondary>actions nécessaires</secondary></indexterm><indexterm><primary>Enregistrement</primary><secondary>types de données nécessaires</secondary>
|
|
</indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple de création d'actions et de types de données
|
|
pour une application, reportez-vous à l' <!--Original XRef content:
|
|
'Etape 4'--><xref role="Step" linkend="SAG.RegAp.mkr.9"> de la section <!--Original
|
|
XRef content: '”Exemple de création d'un module d'enregistrement”'--><xref
|
|
role="SectionTitle" linkend="SAG.RegAp.mkr.30">, <!--Original XRef content:
|
|
'page 85'--><xref role="PageNum" linkend="SAG.RegAp.mkr.34">.</para>
|
|
</note>
|
|
<para>Les actions et les types de données fournissent une interface
|
|
utilisateur à l'application.</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Les actions constituent une interface utilisateur pour la
|
|
commande de lancement de l'application.</para>
|
|
</listitem>
|
|
<listitem><para>Les types de données servent à personnaliser
|
|
la présentation et le comportement des fichiers de données de
|
|
l'application.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect2 id="SAG.RegAp.div.14">
|
|
<title>Actions et types de données requis par une application<indexterm>
|
|
<primary>Applications</primary><secondary>actions requises</secondary></indexterm><indexterm>
|
|
<primary>Applications</primary><secondary>types de données requis</secondary>
|
|
</indexterm></title>
|
|
<para>Les applications type requièrent les définitions d'actions
|
|
et de types de données suivantes:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>une action qui ouvre l'application;</para>
|
|
</listitem>
|
|
<listitem><para>un type de données pour les fichiers de l'application.
|
|
Si vous créez un type de données, vous allez également
|
|
créer:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>une action Ouvrir pour les fichiers de données de l'application
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>une action Imprimer pour les fichiers de données de
|
|
l'application</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>un type de données pour le groupe d'applications (voir
|
|
la section <!--Original XRef content: '”Configuration du groupe
|
|
d'applications avec un nom d'icône unique”, page 75'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.25">).</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Pour une présentation sur l'utilisation des actions et des types
|
|
de données du Bureau, reportez-vous au <!--Original XRef content: 'chapitre 8,
|
|
”Introduction aux actions et types de données”'--><xref role="ChapNumAndTitle"
|
|
linkend="SAG.IntAc.mkr.1">.</para>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.15">
|
|
<title>Emplacement des fichiers de configuration des définitions d'actions
|
|
et de types de données</title>
|
|
<para>Les actions et les types de données sont définis dans
|
|
les fichiers de configuration. La seule exigence de dénomination pour
|
|
les fichiers comportant des définitions d'actions et de types de données
|
|
est qu'ils doivent inclure l'extension <filename>.dt</filename>. Selon les
|
|
conventions, vous pouvez nommer le fichier <symbol role="Variable">nom_action</symbol><filename>.dt</filename> ou <symbol role="Variable">nom_application</symbol><filename>.dt</filename>.</para>
|
|
<para>Placez les fichiers contenant les actions et types de données
|
|
sous la racine de l'application, dans le répertoire <symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/types/</filename><symbol role="Variable">langue.</symbol> La <symbol role="Variable">langue</symbol> par défaut
|
|
est <command>C</command>.</para>
|
|
<figure>
|
|
<title>Fichiers de définitions des actions et des types de données</title>
|
|
<graphic id="SAG.RegAp.grph.6" entityref="SAG.RegAp.fig.6"></graphic>
|
|
</figure>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.16">
|
|
<title>Comment créer des actions et des types de données</title>
|
|
<para>Deux méthodes permettent de créer les définitions
|
|
d'actions et de types de données d'une application:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Avec l'outil “Créer action”.</para>
|
|
<para>Cet outil offre une interface d'un usage convivial. Cependant, il comporte
|
|
certaines limites.</para>
|
|
</listitem>
|
|
<listitem><para>Manuellement.</para>
|
|
<para>Vous devez alors connaître la syntaxe de création des définitions,
|
|
mais vous pouvez accéder à l'ensemble des fonctionnalités
|
|
disponibles.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.17" role="Procedure">
|
|
<title>Création d'actions et de types de données à l'aide
|
|
de ”Créer action”</title>
|
|
<para>Cette procédure utilise l'outil “Créer action”
|
|
pour créer une action et des types de données pour l'application.
|
|
</para>
|
|
<para>Pour plus de détails sur “Créer action”, utilisez
|
|
son aide en ligne ou reportez-vous au <!--Original XRef content: 'chapitre 9,
|
|
”Création d'actions et de types de données à l'aide de Créer action”'--><xref
|
|
role="ChapNumAndTitle" linkend="SAG.dtCrA.mkr.1">.</para>
|
|
<orderedlist>
|
|
<listitem><para id="SAG.RegAp.mkr.20">Ouvrez le groupe d'applications “App_Bureau”
|
|
et cliquez deux fois sur “Créer action”.</para>
|
|
</listitem>
|
|
<listitem><para>Utilisez cet outil pour créer les définitions
|
|
d'actions et de types de données pour l'application et son type de
|
|
données.</para>
|
|
<para>Le fichier de configuration créé par l'outil est écrit
|
|
dans <symbol role="Variable">RépPersonnel</symbol><filename>/.dt/type/</filename><symbol role="Variable">nom_action</symbol><filename>.dt</filename>.
|
|
Le fichier d'actions (fichier exécutable portant le même nom
|
|
que l'action) est placé dans votre répertoire personnel.</para>
|
|
</listitem>
|
|
<listitem><para>Testez l'action en cliquant deux fois sur l'icône du
|
|
fichier d'actions créé dans votre répertoire personnel.
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>Copiez le fichier de définitions d'actions <symbol role="Variable">RépPersonnel</symbol><filename>/.dt/type/</filename><symbol role="Variable">nom_action</symbol><filename>.dt</filename> vers <symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>.</para>
|
|
</listitem>
|
|
<listitem><para>Après la création du répertoire du groupe
|
|
d'applications (voir <!--Original XRef content: ' ”Etape
|
|
7: Création du groupe d'applications”, page 73'--><xref role="SecNumTitleAnsPage"
|
|
linkend="SAG.RegAp.mkr.23">), copiez le fichier d'actions <symbol role="Variable">RépPersonnel</symbol><filename>/</filename><symbol role="Variable">nom_action</symbol> dans le répertoire <filename><symbol role="Variable">racine_app</symbol>/dt/appconfig/appmanager/<symbol role="Variable">langue</symbol>/<symbol role="Variable">groupe_app</symbol></filename>.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.18" role="Procedure">
|
|
<title>Création manuelle d'actions et de types de données</title>
|
|
<itemizedlist>
|
|
<listitem><para>Créez un fichier de configuration contenant les définitions
|
|
d'actions et de types de données de l'application.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Les fichiers d'actions et de types de données doivent respecter
|
|
les conventions de dénomination <symbol role="Variable">nom</symbol><filename>.dt</filename>.</para>
|
|
<para>Vous pouvez placer vos définitions d'actions et de types de données
|
|
dans un ou plusieurs fichiers. Pour chaque fichier, utilisez un nom que les
|
|
administrateurs système associeront facilement à l'application.
|
|
</para>
|
|
<para>Les noms des actions et des types de données doivent être
|
|
en un seul “mot” (sans espace). Vous pouvez utiliser un caractère
|
|
de soulignement. Par convention, la première lettre de l'action ou
|
|
du type de données est en majuscules. N'utilisez pas un nom d'action
|
|
ou de fichier existant. Utilisez un nom que les administrateurs système
|
|
et les utilisateurs confirmés associeront facilement à votre
|
|
application.</para>
|
|
<para>Si vous préférez assigner à l'icône de l'application
|
|
un nom différent de celui de l'action, insérez une zone <command>LABEL</command> dans la définition de l'action.</para>
|
|
<para>Pour plus de détails sur la création d'actions et de types
|
|
de données, reportez-vous aux chapitres indiqués ci-dessous.
|
|
</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><!--Original XRef content: 'chapitre 8,
|
|
”Introduction aux actions et aux types de données”'--><xref role="ChapNumAndTitle"
|
|
linkend="SAG.IntAc.mkr.1"></para>
|
|
</listitem>
|
|
<listitem><para><!--Original XRef content: 'chapitre 9, ”Création
|
|
d'actions et de types de données à l'aide de Créer action”'--><xref
|
|
role="ChapNumAndTitle" linkend="SAG.dtCrA.mkr.1"></para>
|
|
</listitem>
|
|
<listitem><para><!--Original XRef content: 'chapitre 10,
|
|
”Création manuelle d'actions”'--><xref role="ChapNumAndTitle"
|
|
linkend="SAG.CrAct.mkr.1"></para>
|
|
</listitem>
|
|
<listitem><para><!--Original XRef content: 'chapitre 11,
|
|
”Création manuelle de types de données”'--><xref role="ChapNumAndTitle"
|
|
linkend="SAG.CrDT.mkr.1"></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.19">
|
|
<title id="SAG.RegAp.mkr.21">Etape 5: Insertion des fichiers d'aide dans
|
|
le module d'enregistrement<indexterm><primary>Enregistrement</primary><secondary>fichiers d'aide</secondary></indexterm><indexterm><primary>Fichiers</primary>
|
|
<secondary>d'aide</secondary><tertiary>module d'enregistrement</tertiary>
|
|
</indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple d'ajout de fichiers d'aide à un module d'enregistrement,
|
|
reportez-vous à l'<!--Original XRef content: 'Etape 5'--><xref
|
|
role="Step" linkend="SAG.RegAp.mkr.10"> de la section <!--Original XRef content:
|
|
'”Exemple de création de module d'enregistrement”'--><xref role="SectionTitle"
|
|
linkend="SAG.RegAp.mkr.30">, <!--Original XRef content: 'page 88'--><xref
|
|
role="PageNum" linkend="SAG.RegAp.mkr.35">.</para>
|
|
</note>
|
|
<para>Si l'application comporte un<indexterm><primary>Volume d'aide</primary>
|
|
<secondary>emplacement dans le module d'enregistrement</secondary></indexterm> volume
|
|
d'aide du Bureau (créé avec le kit du développeur de
|
|
l'aide du Bureau), le fichier maître du volume d'aide (<filename>*.sdl</filename>) doit être placé dans le répertoire <symbol role="Variable">racine_app</symbol><filename>/appconfig/help/</filename><symbol role="Variable">langue</symbol>.</para>
|
|
<para><indexterm><primary><$nopage>Aide</primary><secondary>voir aussi
|
|
Volume d'aide</secondary></indexterm>Les graphiques utilisés par les
|
|
fichiers d'aide sont généralement placés dans un sous-répertoire <command>graphics</command>. Ils doivent se trouver dans le même répertoire
|
|
lié au fichier du volume d'aide (<filename>*.sdl</filename>) que lors
|
|
de la création du volume d'aide.</para>
|
|
<para>Si l'application ne comporte pas de volume d'aide, vous pouvez en créer
|
|
un si vous disposez du<indexterm><primary>Kit du développeur du Bureau
|
|
CDE</primary></indexterm> kit du développeur du Bureau CDE.</para>
|
|
<para>Il existe deux niveaux d'intégration d'un<indexterm><primary>Volume d'aide</primary><secondary>niveaux d'intégration</secondary>
|
|
</indexterm> volume d'aide:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><indexterm><primary>Aide</primary><secondary>intégration
|
|
totale</secondary></indexterm>Intégration totale</para>
|
|
<para>Lorsque l'aide du Bureau est totalement intégrée, l'utilisateur
|
|
peut accéder au volume d'aide à partir de l'application —
|
|
par exemple à partir de l'aide sur l'élément et du menu
|
|
Aide. L'intégration totale implique la modification des exécutables
|
|
de l'application.</para>
|
|
</listitem>
|
|
<listitem><para><indexterm><primary>Aide</primary><secondary>intégration
|
|
partielle</secondary></indexterm>Intégration partielle</para>
|
|
<para>Lorsque l'aide du Bureau est partiellement intégrée, l'utilisateur
|
|
peut y accéder à partir du premier niveau du Gestionnaire d'aide.
|
|
Cependant, il ne peut accéder au volume d'aide à partir des
|
|
fenêtres de l'application. Vous pouvez créer une action pour
|
|
accéder à l'aide à partir du groupe d'applications. L'action
|
|
de l'exemple suivant affiche le volume d'aide situé dans le<indexterm>
|
|
<primary>Volume d'aide</primary><secondary>fichier d'aide maître</secondary>
|
|
</indexterm> fichier maître de l'aide <filename>MonApp.sdl</filename><indexterm>
|
|
<primary>Fichiers</primary><secondary>.sdl</secondary></indexterm>:</para>
|
|
<programlisting>ACTION OuvrirAideMonApp
|
|
{
|
|
LABEL AideMonApp
|
|
ARG_COUNT 0
|
|
TYPE COMMAND
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING /usr/dt/bin/dthelpview -helpVolume MonApp
|
|
DESCRIPTION Affiche l'aide sur l'application MonApp.
|
|
}</programlisting>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.19a">
|
|
<title id="SAG.RegAp.mkr.21a">Etape 6: Insertion des bibliothèques
|
|
d'informations dans le module d'enregistrement<indexterm><primary>registration</primary><secondary>biblinfos</secondary></indexterm><indexterm><primary>biblinfos</primary><secondary>in regisration package</secondary></indexterm></title>
|
|
<para>Si l'application comprend la documentation en ligne (créée
|
|
à l'aide du Kit du développeur du système d'information
|
|
du bureau), la bibliothèque d'informations (<filename>*.dti</filename>)
|
|
qui contient la documentation devra être placée dans le répertoire
|
|
:<indexterm><primary>biblinfo</primary><secondary>location in regisration
|
|
package</secondary></indexterm></para>
|
|
<programlisting><symbol role="Variable">app_root</symbol><filename>/dt/infolib/</filename><symbol role="Variable">language</symbol></programlisting>
|
|
<para>Les graphiques utilisés dans les fichiers du livre DocBook (<filename>*.sgm</filename>) sont généralement placés dans un sous-
|
|
répertoire <command>graphics</command> Ils doivent se trouver dans
|
|
le même répertoire lié au fichier de la bibliothèque
|
|
d'informations (biblinfo) (<filename>*.dti</filename>) que lors de la création
|
|
d'une biblinfo.</para>
|
|
<para>Si l'application ne comporte pas de documentation en ligne, vous pouvez
|
|
la créer à l'aide du Kit du développeur du système
|
|
information.<indexterm><primary>Information System Developer's Kit</primary>
|
|
</indexterm></para>
|
|
<para>Il existe deux niveaux d'intégration d'une bibliothèque
|
|
d'informations (biblinfo):<indexterm><primary>biblinfo</primary><secondary>levels of integrtion</secondary></indexterm></para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Intégration totale<indexterm><primary>biblinfo</primary>
|
|
<secondary>full integration</secondary></indexterm></para>
|
|
<para>Lorsqu'une biblinfo est totalement intégrée, l'utilisateur
|
|
peut y accéder à partir de l'application en utilisant <literal>DtActionInvoke</literal> pour afficher un sujet spécifique dans le
|
|
Gestionnaire de l'information. L'intégration totale demande la modification
|
|
des fichiers d'exécution de l'application.</para>
|
|
</listitem>
|
|
<listitem><para>Intégration partielle<indexterm><primary>biblinfo</primary><secondary>partial integration</secondary></indexterm></para>
|
|
<para>Lorsqu'une biblinfo est partiellement intégrée, l'utilisateur
|
|
peut y accéder à partir du niveau supérieur du Gestionnaire
|
|
de l'information. Cependant, il ne peut y accéder à partir des
|
|
fenêtres de l'application. Vous pouvez créer une action pour
|
|
accéder à la biblinfo à partir du groupe d'application.
|
|
L'action de l'exemple suivant affiche le volume de la biblinfo située
|
|
dans la bibliothèque d'informations<?Pub Caret> <filename>MyApp.dti</filename>:</para>
|
|
<programlisting>ACTION OpenMyAppInfolib
|
|
{
|
|
LABEL MyAppInfolib
|
|
ARG_TYPE InfoLib
|
|
TYPE MAP
|
|
MAP_ACTION DtLoadInfoLib /usr/dt/infolib/C/MyAppInfolib.dti
|
|
DESCRIPTION Fait appel au Gestionnaire de l'information pour afficher la documentation
|
|
en ligne de l'application MyApp.
|
|
}</programlisting>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.20">
|
|
<title id="SAG.RegAp.mkr.22">Etape 7: Création d'icônes pour
|
|
l'application<indexterm><primary>Enregistrement</primary><secondary>icônes
|
|
requises</secondary></indexterm><indexterm><primary>Icônes</primary>
|
|
<secondary>requises pour l'enregistrement</secondary></indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple de création de fichiers d'icônes pour une
|
|
application, reportez-vous à l'<!--Original XRef content: 'Etape 6'--><xref
|
|
role="Step" linkend="SAG.RegAp.mkr.11"> de la section <!--Original XRef content:
|
|
'”Exemple de création d'un module d'enregistrement”'--><xref role="SectionTitle"
|
|
linkend="SAG.RegAp.mkr.30">, <!--Original XRef content: 'page 88'--><xref
|
|
role="PageNum" linkend="SAG.RegAp.mkr.36">.</para>
|
|
</note>
|
|
<para>Le Bureau fournit des icônes par défaut pour les actions,
|
|
les types de données et les groupes d'applications. Cependant, vous
|
|
pouvez souhaiter créer des icônes propres à l'application.
|
|
</para>
|
|
<para>Les icônes sont placées dans le répertoire <symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/icons/</filename><symbol role="Variable">langue</symbol>.</para>
|
|
<sect2 id="SAG.RegAp.div.21">
|
|
<title>Icônes requises pour le Bureau</title>
|
|
<para>L'application utilise ces images d'icônes sur le Bureau:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><emphasis role="Lead-in"><indexterm><primary>Icônes</primary><secondary>lancement d'une application</secondary></indexterm><indexterm>
|
|
<primary>Icône d'application</primary><secondary>requise par le Bureau</secondary></indexterm><indexterm><primary>Icône d'action</primary>
|
|
<secondary>requise par le Bureau</secondary></indexterm> Icône d'action</emphasis>. Il s'agit de l'icône sur laquelle
|
|
vous cliquez deux fois pour lancer votre application (action). Elle est répertoriée
|
|
dans la zone <command>ICON</command> de l'action qui lance l'application.
|
|
</para>
|
|
<para>Elle existe en trois tailles: petite, moyenne et grande.</para>
|
|
</listitem>
|
|
<listitem><para><emphasis role="Lead-in"><indexterm><primary>Icônes</primary><secondary>type de données</secondary></indexterm><indexterm>
|
|
<primary>Types de données</primary><secondary>icônes</secondary>
|
|
</indexterm>Icône de type de données</emphasis>. Cette icône
|
|
est utilisée pour représenter les fichiers de données
|
|
de l'application dans le Gestionnaire de fichiers. Elle est répertoriée
|
|
dans la zone <command>ICON</command> de la définition du type de données.
|
|
</para>
|
|
<para>Si votre application prend en charge différents types de données,
|
|
vous devez attribuer une icône différente à chaque type.
|
|
</para>
|
|
<para>Elle existe en deux tailles: petite et moyenne.</para>
|
|
</listitem>
|
|
<listitem><para><emphasis role="Lead-in"><indexterm><primary>Icônes</primary><secondary>groupes d'applications</secondary></indexterm><indexterm>
|
|
<primary>Groupes d'applications</primary><secondary>icônes</secondary>
|
|
</indexterm> Icône de groupe d'applications</emphasis>.
|
|
Il s'agit de l'icône qui représente le répertoire au premier
|
|
niveau du Gestionnaire d'applications. Elle est listée dans la zone <command>ICON</command> de la définition du type de données du groupe
|
|
d'applications (voir <!--Original XRef content: '”Etape 7: Création
|
|
du groupe d'applications”, page 73'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.RegAp.mkr.23">).</para>
|
|
<para>Elle existe en deux tailles: petite et moyenne.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Vous devrez peut-être indiquer les versions pixmap et bitmap de
|
|
chaque icône pour permettre le support des écrans couleur (8
|
|
bits et plus) et monochromes (moins de 8 bits).</para>
|
|
<table id="SAG.RegAp.tbl.1" frame="Topbot">
|
|
<title>Conventions de dénomination des fichiers d'icônes</title>
|
|
<tgroup cols="4" colsep="0" rowsep="0">
|
|
<colspec colwidth="1.02in">
|
|
<colspec colwidth="1.46in">
|
|
<colspec colwidth="1.76in">
|
|
<colspec colwidth="3.72in">
|
|
<thead>
|
|
<row><entry align="left" valign="bottom"><para><literal>Taille</literal></para></entry>
|
|
<entry align="left" valign="bottom"><para><literal>Dimensions en pixels</literal></para></entry>
|
|
<entry align="left" valign="bottom"><para><literal>Nom bitmap</literal></para></entry>
|
|
<entry align="left" valign="bottom"><para><literal>Nom pixmap</literal></para></entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Petite</para></entry>
|
|
<entry align="left" valign="top"><para>16 x 16</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.t.bm</filename></para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.t.pm</filename></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Moyenne</para></entry>
|
|
<entry align="left" valign="top"><para>32 x 32</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.m.bm</filename></para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.m.pm</filename></para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para>Grande</para></entry>
|
|
<entry align="left" valign="top"><para>48 x 48</para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.l.bm</filename></para></entry>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.l.pm</filename></para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
<para>Si vous ne disposez pas des fichiers bitmap, le Bureau fait correspondre
|
|
les spécifications couleur des fichiers pixmap en noir et blanc. Cependant,
|
|
cette correspondance risque de pas produire donner l'apparence souhaitée.
|
|
</para>
|
|
<para>Pour plus de détails, reportez-vous à la section <!--Original
|
|
XRef content: '”Fichiers d'images”, page 214'--><xref role="SecTitleAndPageNum"
|
|
linkend="SAG.CrIcn.mkr.3">.</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.22">
|
|
<title id="SAG.RegAp.mkr.23">Etape 8: Création du groupe d'applications<indexterm>
|
|
<primary>Enregistrement</primary><secondary>groupe d'applications</secondary>
|
|
</indexterm><indexterm><primary>Groupes d'applications</primary><secondary>création dans le module d'enregistrement</secondary></indexterm></title>
|
|
<note>
|
|
<para>Pour un exemple de création d'un groupe d'applications, reportez-vous
|
|
à l' <!--Original XRef content: 'Etape 7'--><xref role="Step"
|
|
linkend="SAG.RegAp.mkr.12"> de la section <!--Original XRef content: '”Exemple
|
|
de création d'un module d'enregistrement”'--><xref role="SectionTitle"
|
|
linkend="SAG.RegAp.mkr.30">, <!--Original XRef content: 'page 89'--><xref
|
|
role="PageNum" linkend="SAG.RegAp.mkr.37">.</para>
|
|
</note>
|
|
<para>Une fois que vous avez créé les définitions d'actions
|
|
et de types de données de l'application, vous devez créer les
|
|
fichiers de configuration qui vont supporter la création de ce que
|
|
l'utilisateur voit réellement — le groupe d'applications et son
|
|
contenu.</para>
|
|
<para><indexterm><primary>Groupes d'applications</primary><secondary>répertoires</secondary></indexterm>Le groupe d'applications est un répertoire
|
|
situé au premier niveau du Gestionnaire d'applications (reportez-vous
|
|
à la <!--Original XRef content: 'Figure 4‐1, page 59'--><xref
|
|
role="CodeOrFigOrTabAndPNum" linkend="SAG.RegAp.mkr.4">).</para>
|
|
<para>Il existe trois étapes pour la création du groupe d'applications
|
|
:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>Créez le répertoire du groupe d'applications
|
|
dans le module d'enregistrement.</para>
|
|
</listitem>
|
|
<listitem><para>Facultatif: configurez le groupe d'applications afin qu'il
|
|
utilise une icône unique. Cela implique la création de la définition
|
|
du type de données du groupe d'applications.</para>
|
|
</listitem>
|
|
<listitem><para>Créez le contenu du groupe d'applications.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect2 id="SAG.RegAp.div.23">
|
|
<title>Création du répertoire du groupe d'applications</title>
|
|
<para>Pour créer un groupe d'applications, créez les répertoires
|
|
dans le module d'enregistrement sous <command>appmanager</command>, comme
|
|
indiqué à la <!--Original XRef content: 'Figure 4‐7'--><xref
|
|
role="CodeOrFigureOrTable" linkend="SAG.RegAp.mkr.24">.</para>
|
|
<figure>
|
|
<title id="SAG.RegAp.mkr.24">Le répertoire <command>appmanager</command>.</title>
|
|
<graphic id="SAG.RegAp.grph.7" entityref="SAG.RegAp.fig.7"></graphic>
|
|
</figure>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.24">
|
|
<title>Nom du groupe d'applications<indexterm><primary>Groupes d'applications</primary><secondary>noms</secondary></indexterm></title>
|
|
<para>Dans la <!--Original XRef content: 'Figure 4‐7'--><xref
|
|
role="CodeOrFigureOrTable" linkend="SAG.RegAp.mkr.24">, <groupe_app> correspond
|
|
au nom du groupe d'applications.</para>
|
|
<figure>
|
|
<title>Nom du groupe d'applications (<groupe_app>)</title>
|
|
<graphic id="SAG.RegAp.grph.8" entityref="SAG.RegAp.fig.8"></graphic>
|
|
</figure>
|
|
<para>Le nom peut être un nom de fichier (répertoire) valide
|
|
quelconque. Utilisez de préférence un nom explicite.</para>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.25">
|
|
<title id="SAG.RegAp.mkr.25">Configuration du groupe d'applications avec un
|
|
nom d'icône unique<indexterm><primary>Icônes</primary><secondary>groupes d'applications</secondary></indexterm><indexterm><primary>Groupes
|
|
d'applications</primary><secondary>icônes</secondary></indexterm></title>
|
|
<para>Le Bureau fournit une icône de groupe d'applications par défaut.
|
|
Toutefois, vous souhaiterez probablement attribuer au groupe d'applications
|
|
une icône personnalisée.</para>
|
|
<para>Pour attribuer une icône unique au groupe d'applications, vous
|
|
devez créer:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>un type de données pour le répertoire apparaissant
|
|
au premier niveau du Gestionnaire d'applications;</para>
|
|
</listitem>
|
|
<listitem><para>les actions Ouvrir et Imprimer pour le type de données.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Supposons, par exemple, que vous souhaitez créer un groupe d'applications
|
|
appelé Outils_Media. La définition de types de données
|
|
suivante, placée dans un fichier <filename> <symbol role="Variable">racine_app</symbol>/dt/appconfig/types/<symbol role="Variable">langue</symbol>/<symbol role="Variable">nom</symbol>.dt</filename>, attribue une icône unique
|
|
à l'icône du groupe d'applications.</para>
|
|
<programlisting>DATA_ATTRIBUTES Media_ToolsAppgroup
|
|
{
|
|
ACTIONS OpenInPlace,OpenNewView
|
|
ICON MediaTools
|
|
DESCRIPTION Cliquez deux fois pour ouvrir le \
|
|
groupe d'applications Outils_Media
|
|
}
|
|
DATA_CRITERIA Media_ToolsAppgroupCriteria1
|
|
{
|
|
DATA_ATTRIBUTES_NAME Media_ToolsAppgroup
|
|
MODE d
|
|
PATH_PATTERN */appmanager/*/Outils_Media
|
|
}</programlisting>
|
|
<para>La section des attributs de la définition indique l'icône
|
|
à utiliser. La section des critères indique que le type de données
|
|
est défini dans un répertoire appelé <filename>Outils_Media</filename>, lui-même un sous-répertoire d'un répertoire
|
|
appelé <command>appmanager</command>.</para>
|
|
<para>La <!--Original XRef content: 'Figure 4‐9'--><xref role="CodeOrFigureOrTable"
|
|
linkend="SAG.RegAp.mkr.26"> illustre la relation entre le nom du groupe d'applications
|
|
et la définition du type de données. La zone <filename>PATH_PATTERN</filename> de la définition du type de données associe une
|
|
icône unique au groupe d'applications.</para>
|
|
<figure>
|
|
<title id="SAG.RegAp.mkr.26">Attribution d'une icône unique à
|
|
un groupe d'applications</title>
|
|
<graphic id="SAG.RegAp.grph.9" entityref="SAG.RegAp.fig.9"></graphic>
|
|
</figure>
|
|
<para>Vous devez également créer une action Ouvrir et une action
|
|
Imprimer pour le<indexterm><primary>Groupes d'applications</primary><secondary>actions</secondary></indexterm><indexterm><primary>Groupes d'applications</primary><secondary>type de données</secondary></indexterm> type de
|
|
données du groupe d'applications:</para>
|
|
<programlisting>ACTION Ouvrir
|
|
{
|
|
ARG_TYPE Media_ToolsAppGroup
|
|
TYPE MAP
|
|
MAP_ACTION OpenAppGroup
|
|
}
|
|
ACTION Imprimer
|
|
{
|
|
ARG_TYPE Media_ToolsAppGroup
|
|
TYPE MAP
|
|
MAP_ACTION PrintAppGroup
|
|
}</programlisting>
|
|
<para>Les actions OpenAppGroup et PrintAppGroup sont des actions intégrées
|
|
définies dans <filename>/usr/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol><filename>/dtappman.dt</filename>.</para>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.26">
|
|
<title>Création du contenu du groupe d'applications<indexterm><primary>Groupes d'applications</primary><secondary>contenu</secondary></indexterm><indexterm>
|
|
<primary>Module d'enregistrement</primary><secondary>contenu du groupe d'applications</secondary></indexterm></title>
|
|
<para>L'élément le plus important du groupe d'applications est
|
|
l'icône permettant de lancer l'application (icône d'action). Si
|
|
le groupe d'applications comporte une série d'applications, il existe,
|
|
en général, une icône par application.</para>
|
|
<para>Outre la ou les icônes d'action, le groupe d'applications peut
|
|
contenir:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>un ou plusieurs fichiers README,</para>
|
|
</listitem>
|
|
<listitem><para>un ou plusieurs fichiers de données échantillon,
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>des modèles,</para>
|
|
</listitem>
|
|
<listitem><para>une icône sur laquelle l'utilisateur peut cliquer deux
|
|
fois pour visualiser l'aide,</para>
|
|
</listitem>
|
|
<listitem><para>une page de manuel,</para>
|
|
</listitem>
|
|
<listitem><para>une icône spécialisée pour le Tableau
|
|
de bord.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>Le groupe d'applications peut contenir des sous-répertoires.
|
|
</para>
|
|
<sect3 id="SAG.RegAp.div.27">
|
|
<title>Création du fichier d'action (Icône de l'application)<indexterm>
|
|
<primary>Icônes</primary><secondary>représentation des applications</secondary></indexterm><indexterm><primary>Module d'enregistrement</primary>
|
|
<secondary>icône d'application</secondary></indexterm><indexterm><primary><$nopage>Enregistrement</primary><secondary>voir aussi module d'enregistrement</secondary></indexterm><indexterm><primary><$nopage>Module d'enregistrement</primary><secondary>voir aussi enregistrement</secondary></indexterm></title>
|
|
<para>Le groupe d'applications doit contenir une icône permettant de
|
|
lancer l'application. Si le groupe comporte une série d'applications,
|
|
une icône doit exister pour chacune d'entre elles. Ces icônes
|
|
s'appellent <emphasis role="Variable">icônes d'application</emphasis>
|
|
ou <symbol role="Variable">icônes d'action</symbol>, puisqu'elles représentent
|
|
une action sous-jacente.</para>
|
|
<para>Pour définir une icône d'action, vous devez créer
|
|
un fichier exécutable dont le nom doit être identique à
|
|
celui de l'action à exécuter.</para>
|
|
<programlisting><symbol role="Variable">racine_app</symbol>/dt/appconfig/appmanager/<symbol role="Variable">groupe_app</symbol>/<symbol role="Variable">nom_action</symbol></programlisting>
|
|
<para>Le fichier est appelé<indexterm><primary>Fichier</primary><secondary>d'action</secondary><tertiary>création</tertiary></indexterm> <emphasis
|
|
role="Variable">fichier d'action</emphasis>, car son but est de créer
|
|
une représentation visuelle de l'action sous-jacente.</para>
|
|
<para>Par exemple, si vous avez créé une action BestTextEditor
|
|
qui exécute l'application BestTextEditor, vous devez créer un
|
|
fichier exécutable portant le nom BestTextEditor. Dans le Gestionnaire
|
|
de fichiers et le Gestionnaire d'applications, le fichier d'action utilisera
|
|
l'icône d'image indiquée dans la définition de l'action.
|
|
</para>
|
|
<para>La <!--Original XRef content: 'Figure 4‐10'--><xref role="CodeOrFigureOrTable"
|
|
linkend="SAG.RegAp.mkr.27"> illustre la relation entre la définition
|
|
de l'action, le fichier d'action et l'entrée réelle dans la
|
|
fenêtre du Gestionnaire d'applications.</para>
|
|
<figure>
|
|
<title id="SAG.RegAp.mkr.27">L'icône d'application est un fichier du
|
|
groupe d'applications</title>
|
|
<graphic id="SAG.RegAp.grph.10" entityref="SAG.RegAp.fig.10"></graphic>
|
|
</figure>
|
|
</sect3>
|
|
<sect3 id="SAG.RegAp.div.28">
|
|
<title>Fichiers Read Me<indexterm><primary><$nopage>Module d'applications,
|
|
voir module d'enregistrement</primary></indexterm><indexterm><primary>Fichiers</primary><secondary>readme</secondary></indexterm><indexterm><primary>Module
|
|
d'enregistrement</primary><secondary>fichiers readme</secondary></indexterm><indexterm>
|
|
<primary>Groupes d'applications</primary><secondary>fichiers readme</secondary>
|
|
</indexterm></title>
|
|
<para>Le Bureau fournit un type de données README à utiliser
|
|
pour les fichiers README de votre application. Utilisez l'une des conventions
|
|
de dénomination suivantes:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para><filename>README</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>readme</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>README.*</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>Read.*.Me</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>read.*.me</filename></para>
|
|
</listitem>
|
|
<listitem><para><filename>READ.*.ME</filename></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
<sect3 id="SAG.RegAp.div.29">
|
|
<title>Création d'une icône spécialisée du Tableau
|
|
de bord<indexterm><primary>Tableau de bord</primary><secondary>icône
|
|
du module d'enregistremen</secondary></indexterm><indexterm><primary>Module
|
|
d'enregistrement</primary><secondary>icône Tableau de bord</secondary>
|
|
</indexterm></title>
|
|
<para>Dans la plupart des cas, il n'est pas nécessaire de définir
|
|
une icône pour le Tableau de bord; l'utilisateur peut en effet ajouter
|
|
l'application au Tableau de bord en faisant glisser son icône d'action
|
|
sur l'icône “Installer une icône” d'un panneau secondaire.
|
|
</para>
|
|
<para>Vous pouvez créer un fichier de configuration du Tableau de bord
|
|
contenant une définition d'icône de votre application permettant
|
|
aux utilisateurs d'installer une icône d'un comportement différent
|
|
de celui de l'icône d'action — par exemple, si l'icône contrôle
|
|
un fichier et change d'aspect lorsque ce fichier est modifié.</para>
|
|
<para>Les fichiers de configuration du Tableau de bord sont placés
|
|
dans le répertoire <symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol>. La
|
|
convention de dénomination est <symbol role="Variable">nom</symbol><filename>.fp</filename>.</para>
|
|
<para>Si vous disposez d'un fichier de configuration comportant une icône,
|
|
l'utilisateur peut l'ajouter à un panneau secondaire en faisant glisser
|
|
le fichier <filename>*.fp</filename> sur l'icône “Installer une
|
|
icône” du panneau secondaire.</para>
|
|
<para>Par exemple, la définition suivante peut être placée
|
|
dans un fichier de configuration du Tableau de bord du groupe d'applications.
|
|
Si l'utilisateur fait glisser ce fichier sur l'icône ”Installer
|
|
une icône” d'un panneau secondaire, une icône est créée
|
|
dans ce dernier et exécute une seule instance de l'application BestTextEditor.
|
|
Si BestTextEditor est déjà lancé, la fenêtre est
|
|
déplacée sur le haut de la pile de fenêtres de l'espace
|
|
de travail courant.</para>
|
|
<programlisting>CONTROL BestTextEditorControl
|
|
{
|
|
TYPE icon
|
|
ICON BTEFPanel
|
|
PUSH_RECALL True
|
|
CLIENT_NAME BTEd
|
|
PUSH_ACTION BTEditor
|
|
DROP_ACTION BTEditor
|
|
HELP_STRING Lance l'application BestTextEditor.
|
|
}</programlisting>
|
|
<para>Pour plus de détails sur la création des fichiers de configuration
|
|
du Tableau de bord, reportez-vous:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>au <!--Original XRef content:
|
|
'chapitre 13, ”Personnalisation du Tableau de bord”'--><xref
|
|
role="ChapNumAndTitle" linkend="SAG.FrPC.mkr.1">,</para>
|
|
</listitem>
|
|
<listitem><para>à la page de manuel <filename moreinfo="RefEntry">dtfpfile(4)</filename>.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.30">
|
|
<title id="SAG.RegAp.mkr.28">Etape 9: Enregistrement de l'application à
|
|
l'aide de<indexterm><primary>dtappintegrate</primary></indexterm><indexterm>
|
|
<primary>Enregistrement</primary><secondary>dtappintegrate</secondary></indexterm> dtappintegrate</title>
|
|
<note>
|
|
<para>Pour un exemple d'enregistrement d'une application, reportez-vous à
|
|
l' <!--Original XRef content: 'Etape 8'--><xref role="Step" linkend="SAG.RegAp.mkr.13">
|
|
de la section <!--Original XRef content: '”Exemple de création d'un
|
|
module d'enregistrement”'--><xref role="SectionTitle" linkend="SAG.RegAp.mkr.30">, <!--Original
|
|
XRef content: 'page 90'--><xref role="PageNum" linkend="SAG.RegAp.mkr.38">.
|
|
</para>
|
|
</note>
|
|
<para>Une fois que vous avez créé un module d'enregistrement
|
|
sous la racine d'une application, vous pouvez commencer l'enregistrement réel
|
|
de l'application.</para>
|
|
<para>L'enregistrement de l'application crée des liens entre le module
|
|
d'enregistrement et les répertoires situés dans les chemins
|
|
de recherche du Bureau (reportez-vous à la section <!--Original XRef
|
|
content: '”Intégration des applications par dtappintegrate”,
|
|
page 82'--><xref role="SecTitleAndPageNum" linkend="SAG.RegAp.mkr.29">).
|
|
</para>
|
|
<sect2 id="SAG.RegAp.div.31" role="Procedure">
|
|
<title>Enregistrement d'une application à l'aide de dtappintegrate</title>
|
|
<para>Si l'application est adaptée au Bureau CDE, <command>dtappintegrate</command> est généralement exécuté automatiquement
|
|
comme étape finale du processus d'installation. S'il n'est pas exécuté
|
|
automatiquement, ou si vous avez créé les fichiers de configuration
|
|
pour intégrer une application “non CDE”, vous pouvez alors
|
|
lancer <command>dtappintegrate</command> manuellement.</para>
|
|
<orderedlist>
|
|
<listitem><para>Connectez-vous en tant qu'utilisateur root.</para>
|
|
</listitem>
|
|
<listitem><para>Exécutez la commande:</para>
|
|
<para remap="CodeIndent1"><command>/usr/dt/bin/dtappintegrate -s</command> <symbol role="Variable">racine_app</symbol></para>
|
|
<para>où <symbol role="Variable">racine_app</symbol> est le répertoire
|
|
racine de l'application du Bureau. Pour plus de détails, reportez-vous
|
|
à la page de manuel <filename moreinfo="RefEntry">dtappintegrate(1)</filename>.</para>
|
|
</listitem>
|
|
<listitem><para>Ouvrez le groupe d'applications Outils_Bureau et cliquez deux
|
|
fois sur Recharger applications.</para>
|
|
</listitem>
|
|
<listitem><para>Vérifiez que l'application est correctement enregistrée
|
|
:</para>
|
|
</listitem>
|
|
<listitem><para>Affichez le premier niveau du Gestionnaire d'applications.
|
|
Le nouveau groupe d'applications doit apparaître dans celui-ci.</para>
|
|
</listitem>
|
|
<listitem><para>Ouvrez le groupe d'applications et cliquez deux fois sur l'icône
|
|
d'action.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
<sect3 id="SAG.RegAp.div.32">
|
|
<title>Syntaxe et options de<indexterm><primary>dtappintegrate</primary>
|
|
<secondary>syntaxe</secondary></indexterm> dtappintegrate</title>
|
|
<para><command>dtappintegrate -s</command> <symbol role="Variable">racine_app</symbol> <command>[-t</command> <symbol role="Variable">chemin_cible</symbol> <command>] [-l</command> <symbol role="Variable">langue</symbol> ] <command>[-u]</command></para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="159*">
|
|
<colspec colwidth="369*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><computeroutput>-s</computeroutput> <symbol role="Variable">racine_app</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Paramètre requis. Indique la
|
|
racine sous laquelle l'application a été installée.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><computeroutput>-t</computeroutput> <symbol role="Variable">chemin_cible</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Paramètre facultatif. A pour
|
|
valeur par défaut l'emplacement du système <command>/etc/dt/appconfig.</command> Indique l'emplacement auquel les fichiers de configuration du Bureau
|
|
sont liés. Vous devez utiliser un emplacement dans le chemin de recherche
|
|
de l'application.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><computeroutput>-l</computeroutput> <symbol role="Variable">langue</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Paramètre facultatif. A pour
|
|
valeur par défaut toutes les langues. Indique les fichiers de configuration
|
|
du Bureau dépendant de la langue à intégrer.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>-u</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Paramètre facultatif. Annule
|
|
l'intégration de l'application, en supprimant tous les liens établis
|
|
lors de l'intégration.</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</sect3>
|
|
</sect2>
|
|
<sect2 id="SAG.RegAp.div.33">
|
|
<title id="SAG.RegAp.mkr.29">Intégration des applications par dtappintegrate<indexterm>
|
|
<primary>Liens symboliques</primary><secondary>créés pendant
|
|
l'enregistrement</secondary></indexterm><indexterm><primary>dtappintegrate</primary><secondary>fonctionnalités</secondary></indexterm></title>
|
|
<para><command>dtappintegrate</command> configure des liens entre les fichiers
|
|
installés et les emplacements où le Bureau recherche les fichiers
|
|
de configuration.</para>
|
|
<sect3 id="SAG.RegAp.div.34">
|
|
<title>Actions et types de données<indexterm><primary>Actions</primary>
|
|
<secondary>intégrées à l'aide de dtappintegrate</secondary>
|
|
</indexterm><indexterm><primary>Types de données</primary><secondary>intégrés à l'aide de dtappintegrate</secondary></indexterm></title>
|
|
<para><command>dtappintegrate</command> crée des liens symboliques
|
|
entre les fichiers de définitions d'actions et de types de données
|
|
du module d'enregistrement et le répertoire de niveau système,
|
|
à travers le chemin de recherche d'aide de bases de données
|
|
d'actions. Pour ce faire, il crée des liens entre</para>
|
|
<para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/types/</filename> <symbol role="Variable">langue</symbol><filename>/*.dt</filename></para>
|
|
<para>et</para>
|
|
<para><filename>/etc/dt/appconfig/types/</filename><symbol role="Variable">langue</symbol><filename>/*.dt</filename></para>
|
|
</sect3>
|
|
<sect3 id="SAG.RegAp.div.35">
|
|
<title>Fichiers d'aide<indexterm><primary>Fichiers</primary><secondary>d'aide</secondary><tertiary>intégrés à l'aide de dtappintegrate</tertiary></indexterm></title>
|
|
<para><command>dtappintegrate</command> crée des liens symboliques
|
|
entre les fichiers d'aide du module d'enregistrement et le répertoire
|
|
de niveau système, à travers le chemin de recherche d'aide.
|
|
Pour ce faire, il crée des liens entre</para>
|
|
<para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/help/</filename><symbol role="Variable">langue</symbol>/<symbol role="Variable">fichier_aide</symbol><filename>.sdl</filename></para>
|
|
<para>et</para>
|
|
<para><filename>/etc/dt/appconfig/help/</filename><symbol role="Variable">langue</symbol>/<symbol role="Variable">fichier_aide</symbol><filename>.sdl</filename></para>
|
|
</sect3>
|
|
<sect3 id="SAG.RegAp.div.34a">
|
|
<title>Bibliothèques d'informations<indexterm><primary>biblinfos</primary>
|
|
<secondary>integrated with dtappintegrate</secondary></indexterm></title>
|
|
<para><command>dtappintegrate</command> crée des liens symboliques
|
|
entre les bibliothèques d'information (biblinfos) du module d'enregistrement
|
|
et le répertoire de niveau système, à travers le chemin
|
|
de recherche biblinfo. Pour ce faire, il crée des liens entre</para>
|
|
<programlisting><symbol role="Variable">app_root</symbol>/dt/infolib/<symbol role="Variable">language</symbol>/*.dti</programlisting>
|
|
<para>to</para>
|
|
<programlisting>/etc/dt/infolib/<symbol role="Variable">language</symbol>/*.dti
|
|
</programlisting>
|
|
</sect3>
|
|
<sect3 id="SAG.RegAp.div.36">
|
|
<title>Fichiers d'icônes<indexterm><primary>Icônes</primary>
|
|
<secondary>intégrées à l'aide de dtappintegrate</secondary>
|
|
</indexterm></title>
|
|
<para><command>dtappintegrate</command> crée des liens symboliques
|
|
entre les fichiers d'icônes du module d'enregistrement et le répertoire
|
|
de niveau système, à travers le chemin de recherche d'icônes.
|
|
Pour ce faire, il crée des liens entre</para>
|
|
<para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/icons/</filename><symbol role="Variable">langue</symbol>/<symbol role="Variable">fichiers_icône</symbol></para>
|
|
<para>et</para>
|
|
<para><filename>/etc/dt/appconfig/icons/</filename><symbol role="Variable">langue</symbol>/<symbol role="Variable">fichiers_icône</symbol></para>
|
|
</sect3>
|
|
<sect3 id="SAG.RegAp.div.37">
|
|
<title>Groupe d'applications<indexterm><primary>Groupes d'applications</primary>
|
|
<secondary>intégrés à l'aide de dtappintegrate</secondary>
|
|
</indexterm></title>
|
|
<para>Pour placer le groupe de l'application au premier niveau du Gestionnaire
|
|
d'applications, <command>dtappintegrate</command> crée un lien entre
|
|
le répertoire du groupe d'applications du module d'enregistrement et
|
|
l'emplacement de niveau système à travers le chemin de recherche
|
|
d'applications. Pour ce faire, il crée des liens entre</para>
|
|
<para><symbol role="Variable">racine_app</symbol><filename>/dt/appconfig/appmanager/</filename><symbol role="Variable">langue</symbol>/<symbol role="Variable">groupe_app</symbol></para>
|
|
<para>et</para>
|
|
<para><filename>/etc/dt/appconfig/appmanager/</filename><symbol role="Variable">langue</symbol>/<symbol role="Variable">groupe_app</symbol></para>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="SAG.RegAp.div.38">
|
|
<title id="SAG.RegAp.mkr.30">Exemple de création d'un module d'enregistrement<indexterm>
|
|
<primary><$startrange>Enregistrement</primary><secondary>exemple</secondary>
|
|
</indexterm><indexterm><primary>Module d'enregistrement</primary><secondary>exemple de création</secondary></indexterm></title>
|
|
<para>Les étapes suivantes créent un module d'enregistrement
|
|
pour une application non CDE appelée BestTextEditor.</para>
|
|
<sect2 id="SAG.RegAp.div.39">
|
|
<title>Informations sur ”BestTextEditor”</title>
|
|
<para>L'exemple s'appuie sur les hypothèses suivantes à propos
|
|
de l'application (fictive) BestTextEditor:</para>
|
|
<itemizedlist remap="Bullet1">
|
|
<listitem><para>elle est installée dans le répertoire <filename>/usr/BTE</filename></para>
|
|
</listitem>
|
|
<listitem><para>la langue de session de l'utilisateur est la valeur par défaut,
|
|
C</para>
|
|
</listitem>
|
|
<listitem><para>la syntaxe de lancement de BestTextEditor est:</para>
|
|
<para remap="CodeIndent1"><programlisting>BTEd [<symbol role="Variable">nom_fichier</symbol>]</programlisting></para>
|
|
<para>où <symbol role="Variable">nom_fichier</symbol> est le nom du
|
|
fichier de données à ouvrir dans la nouvelle fenêtre.
|
|
BestTextEditor crée sa propre fenêtre — c'est-à-dire
|
|
qu'elle ne s'exécute pas dans une fenêtre d'émulateur
|
|
de terminal.</para>
|
|
</listitem>
|
|
<listitem><para>BestTextEditor crée et utilise deux type de fichiers
|
|
de données:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>Fichiers de documentation. Ils utilisent la convention de
|
|
dénomination <filename>*.bte</filename>. BestTextEditor dispose d'une
|
|
ligne de commande pour l'impression de ses fichiers de données <filename>.bte</filename>. La syntaxe de cette commande est:</para>
|
|
<para remap="CodeIndent2"><programlisting>BTEPrint [-d <symbol role="Variable">destination</symbol>] [-s] <symbol role="Variable">nom_fichier</symbol></programlisting></para>
|
|
<para>où:</para>
|
|
</listitem>
|
|
<listitem>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="106*">
|
|
<colspec colwidth="422*">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>-d</filename> <symbol role="Variable">destination</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Indique l'imprimante de destination.
|
|
</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><filename>-s</filename></para></entry>
|
|
<entry align="left" valign="top"><para>Indique une impression directe. La
|
|
boîte de dialogue Imprimer de l'application ne s'affiche pas.</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_fichier</symbol></para></entry>
|
|
<entry align="left" valign="top"><para>Indique le fichier à imprimer.
|
|
</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>Fichiers modèles. Ils utilisent la convention de dénomination <filename>*.tpl</filename>. Les fichiers modèles ne peuvent être imprimés.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para>Les fichiers app-defaults existant pour BestTextEditor, qui
|
|
ne figurent pas dans le Bureau, contiennent des ressources pour les polices
|
|
d'interface et les couleurs de premier plan et d'arrière-plan.</para>
|
|
</listitem>
|
|
<listitem><para>Un volume d'aide en ligne pour BestTextEditor a été
|
|
créé à l'aide du kit du développeur du Bureau
|
|
CDE. Lors de sa construction, ce volume a utilisé les fichiers source
|
|
suivants:</para>
|
|
<para remap="CodeIndent1"><filename>…/BTEHelp.htg</filename></para>
|
|
<para><filename>…/graphics/BTE1.xwd</filename></para>
|
|
<para><filename>…/graphics/BTE2.xwd</filename></para>
|
|
<para>et génère le fichier <filename>…/BTEHelp.sdl</filename>.
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<sect3 id="SAG.RegAp.div.40">
|
|
<title>Etapes d'enregistrement de ''BestTextEditor''</title>
|
|
<para>Les étapes ci-dessous permettent d'enregistrer BestTextEditor.
|
|
</para>
|
|
<orderedlist>
|
|
<listitem><para><emphasis id="sag.regap.mkr.31" role="Lead-in">Modification
|
|
des ressources polices et couleurs</emphasis></para>
|
|
<para>Dans le fichier app-defaults de BestTextEditor, supprimez les ressources
|
|
qui définissent:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>les polices de texte,</para>
|
|
</listitem>
|
|
<listitem><para>les couleurs d'avant- et d'arrière-plan.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.32" role="Lead-in">Création
|
|
de la racine de l'application</emphasis></para>
|
|
<para>Créez le répertoir:</para>
|
|
<para remap="CodeIndent1"><filename>/desktop_approots/BTE</filename></para>
|
|
<para>Si vous intégrez une application existante, vous devez créer
|
|
un répertoire racine différent du répertoire d'installation
|
|
de l'application, faute de perdre les fichiers de configuration créés
|
|
lorsque vous mettrez l'application à jour.</para>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.33" role="Lead-in">Création
|
|
des répertoires du module d'enregistrement</emphasis></para>
|
|
<para>Créez les répertoires suivants:</para>
|
|
<para remap="CodeIndent1"><programlisting>/desktop_approots/BTE/dt/appconfig/types/C
|
|
/desktop_approots/BTE/dt/appconfig/help/C
|
|
/desktop_approots/BTE/dt/appconfig/icons/C
|
|
/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor</programlisting></para>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.34" role="Lead-in">Création
|
|
des actions et des types de données de l'application</emphasis></para>
|
|
<orderedlist>
|
|
<listitem><para>Créez le fichier de configuration des définitions
|
|
d'actions et de types de données:</para>
|
|
<programlisting remap="CodeIndent2">/desktop_approots/BTE/dt/appconfig/types/C/BTE.dtn
|
|
</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez la définition d'action pour l'exécution
|
|
de BestTextEditor:</para>
|
|
<programlisting>ACTION BTEditor
|
|
{
|
|
WINDOW_TYPE NO_STDIO
|
|
ICON BTERun
|
|
DESCRIPTION Cliquez deux fois sur cette icône ou posez\
|
|
dessus un fichier de données pour exécuter\
|
|
BestTextEditor.
|
|
EXEC_STRING /usr/BTE/BTEd %Arg_1%
|
|
}</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez le type de données des fichiers <filename>*.bte</filename>:</para>
|
|
<programlisting>DATA_ATTRIBUTES BTEDataFile
|
|
{
|
|
DESCRIPTION Fichier de données de BestTextEditor.
|
|
ICON BTEData
|
|
ACTIONS Ouvrir,Imprimer
|
|
}
|
|
DATA_CRITERIA BTEDataFileCriteria1
|
|
{
|
|
DATA_ATTRIBUTES_NAME BTEDataFile
|
|
NAME_PATTERN *.bte
|
|
MODE f
|
|
}</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez le type de données des fichiers <filename>*.tpl</filename>:</para>
|
|
<para remap="CodeIndent2"><programlisting>DATA_ATTRIBUTES BTETemplateFile
|
|
{
|
|
DESCRIPTION Fichier modèles de BestTextEditor.
|
|
ICON BTETempl
|
|
ACTIONS Ouvrir
|
|
}
|
|
DATA_CRITERIA BTETemplateFileCriteria1
|
|
{
|
|
DATA_ATTRIBUTES_NAME BTETemplateFile
|
|
NAME_PATTERN *.tpl
|
|
MODE f
|
|
}</programlisting></para>
|
|
</listitem>
|
|
<listitem><para>Créez l'action Ouvrir pour les fichiers <filename>*.bte</filename>.</para>
|
|
<programlisting>ACTION Ouvrir
|
|
{
|
|
ARG_TYPE BTEDataFile
|
|
TYPE MAP
|
|
MAP_ACTION BTEditor
|
|
}</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez l'action Imprimer pour les fichiers <filename>*.bte</filename>.</para>
|
|
<para>Des actions Imprimer simples figurent ci-dessous. Ces actions requièrent
|
|
la saisie d'une valeur pour la variable d'environnement <systemitem>LPDEST</systemitem> et ne tiennent pas compte de l'option d'impression <command>-s</command>. Si <systemitem>LPDEST</systemitem> n'est pas définie,
|
|
l'action peut échouer.</para>
|
|
<programlisting>ACTION Imprimer
|
|
{
|
|
ARG_TYPE BTEDataFile
|
|
TYPE MAP
|
|
MAP_ACTION BTEPrintData
|
|
}
|
|
ACTION BTEPrintData
|
|
{
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING BTEPrint -d $LPDEST %Arg_1%
|
|
}</programlisting>
|
|
<para>Voici une autre version de l'action BTEPrintData et du script l'accompagnant.
|
|
Ensemble, ils gèrent les situations où <systemitem role="resource">
|
|
LPDEST</systemitem>
|
|
n'est pas définie et lorsque l'impression directe est demandée.
|
|
</para>
|
|
<programlisting>ACTION BTEPrintData
|
|
{
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING /usr/BTE/bin/BTEenvprint %(File)Arg_1%
|
|
}</programlisting>
|
|
<para>Le contenu du script <filename>/usr/BTE/bin/BTEenvprint</filename> est
|
|
:</para>
|
|
<programlisting># BTEenvprint
|
|
#!/bin/sh
|
|
DEST=“ ”
|
|
SILENT=“ ”
|
|
if [ $LPDEST ]; then
|
|
DEST=“-d $LPDEST”
|
|
fi
|
|
BTEPrint $DEST $SILENT $1</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez l'action Ouvrir pour les fichiers <command>*.tpl</command>:</para>
|
|
<programlisting>ACTION Ouvrir
|
|
{
|
|
ARG_TYPE BTETemplateFile
|
|
TYPE MAP
|
|
MAP_ACTION BTEditor
|
|
}</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez l'action Imprimer pour les fichiers <filename>*.tpl</filename>:</para>
|
|
<programlisting>ACTION Imprimer
|
|
{
|
|
ARG_TYPES BTETemplateFile
|
|
TYPE MAP
|
|
MAP_ACTION NoPrint
|
|
}</programlisting>
|
|
<para>NoPrint est une action intégrée qui affiche une boîte
|
|
de dialogue indiquant à l'utilisateur que le fichier ne peut être
|
|
imprimé.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.35" role="Lead-in">Insertion des
|
|
fichiers d'aide dans le module d'enregistrement</emphasis></para>
|
|
<orderedlist>
|
|
<listitem><para>Placez les fichiers d'aide aux emplacements suivants:</para>
|
|
<para remap="CodeIndent2"><programlisting>/desktop_approots/BTE/dt/appconfig/help/C/BTEHelp.sdl
|
|
/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE1.xwd
|
|
/desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE2.xwd</programlisting></para>
|
|
</listitem>
|
|
<listitem><para>Créez le fichier:</para>
|
|
<para remap="CodeIndent2"><filename>/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt</filename>.</para>
|
|
<para>Placez la définition d'action ci-dessous dans le fichier:</para>
|
|
<programlisting>ACTION BTEHelp
|
|
{
|
|
WINDOW_TYPE NO_STDIO
|
|
EXEC_STRING /usr/dt/bin/dthelpview -helpVolume \BTEHelp.sdl
|
|
DESCRIPTION Ouvre le volume d'aide de BestTextEditor.
|
|
}</programlisting>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.36" role="Lead-in">Créations
|
|
d'icônes pour l'application</emphasis></para>
|
|
<para>Utilisez l'Editeur d'icônes. Voici quelques indications relatives
|
|
à la taille:</para>
|
|
<informaltable>
|
|
<tgroup cols="2" colsep="0" rowsep="0">
|
|
<colspec colwidth="156*">
|
|
<colspec colwidth="372*">
|
|
<thead>
|
|
<row><entry align="left" valign="bottom"><para>Nom</para></entry><entry align="left"
|
|
valign="bottom"><para>Taille</para></entry></row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.t.pm</filename></para></entry>
|
|
<entry align="left" valign="top"><para>16 x 16</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.m.pm</filename></para></entry>
|
|
<entry align="left" valign="top"><para>32 x 32</para></entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top"><para><symbol role="Variable">nom_base</symbol><filename>.l.pm</filename></para></entry>
|
|
<entry align="left" valign="top"><para>64 x 64</para></entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
<para>Créez ces fichiers d'icônes dans le répertoire <filename>/desktop_approots/BTE/dt/appconfig/icons/C</filename>:</para>
|
|
<itemizedlist remap="Bullet2">
|
|
<listitem><para>Icônes représentant l'action: <filename>BTERun.t.pm</filename>, <filename>BTERun.m.pm</filename>, <filename>BTERun.l.pm</filename></para>
|
|
</listitem>
|
|
<listitem><para>Icônes représentant les fichiers <filename>*.bte</filename>: <filename>BTEData.t.pm</filename>, <filename>BTEData.m.pm</filename>,
|
|
</para>
|
|
</listitem>
|
|
<listitem><para>Icônes représentant les fichiers <filename>*.tpl</filename>: <filename>BTETempl.t.pm</filename>, <filename>BTETempl.m.pm</filename></para>
|
|
</listitem>
|
|
<listitem><para>Icônes représentant le groupe d'applications
|
|
(utilisé à l'étape 7): <filename>BTEApp.t.pm</filename>, <filename>BTEApp.m.pm</filename></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.37" role="Lead-in">Création
|
|
du groupe d'applications</emphasis><indexterm><primary>Groupes d'applications</primary><secondary>exemple de création</secondary></indexterm></para>
|
|
<orderedlist>
|
|
<listitem><para>Si cela n'est pas déjà fait, créez le
|
|
répertoire:</para>
|
|
<para remap="CodeIndent2"><filename>/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor</filename></para>
|
|
</listitem>
|
|
<listitem><para>Cette étape est facultative. Elle attribue une icône
|
|
unique au groupe d'applications en créant pour ce dernier un type de
|
|
données et les actions associées. Si vous omettez cette étape,
|
|
le groupe d'applications utilisera l'icône par défaut.</para>
|
|
<para>Ajoutez les définitions de types de données et d'actions
|
|
suivantes au fichier <filename>/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt</filename>. Le type de données indique l'icône que le groupe
|
|
d'applications BestTextEditor utilisera. Les actions proposent le même
|
|
comportement Ouvrir et Imprimer que les groupes d'applications intégrés.
|
|
</para>
|
|
<programlisting>DATA_ATTRIBUTES BestTextEditorAppGroup
|
|
{
|
|
ACTIONS OpenInPlace,OpenNewView
|
|
ICON BTEApp
|
|
}
|
|
DATA_CRITERIA BestTextEditorAppGroupCriterial
|
|
{
|
|
DATA_ATTRIBUTES_NAME BestTextEditorAppGroup
|
|
MODE d
|
|
PATH_PATTERN */appmanager/*/BestTextEditor
|
|
}
|
|
ACTION Ouvrir
|
|
{
|
|
ARG_TYPE BestTextEditorAppGroup
|
|
TYPE MAP
|
|
MAP_ACTION OpenAppGroup
|
|
}
|
|
ACTION Imprimer
|
|
{
|
|
ARG_TYPE BestTextEditorAppGroup
|
|
TYPE MAP
|
|
MAP_ACTION PrintAppGroup
|
|
}</programlisting>
|
|
</listitem>
|
|
<listitem><para>Créez, dans le groupe d'applications, une icône
|
|
qui lancera l'application. Pour ce faire, créez le fichier:</para>
|
|
<programlisting><filename>/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor/BTEditor</filename></programlisting>
|
|
<para>et faites-en un fichier exécutable.</para>
|
|
</listitem>
|
|
<listitem><para>Créez le fichier d'action du groupe d'applications
|
|
qui ouvrira le volume d'aide. Pour ce faire, créez le fichier:</para>
|
|
<programlisting><filename>/desktop_approots/BTE/dt/appconfig/appmanager/C/BestTextEditor/BTEHelp</filename></programlisting>
|
|
<para>et faites-en un fichier exécutable.</para>
|
|
</listitem>
|
|
<listitem><para>Placez les autres fichiers dans le groupe d'applications,
|
|
par exemple les fichiers ”read me”, de données échantillons
|
|
et modèles.</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
<listitem><para><emphasis id="sag.regap.mkr.38" role="Lead-in">Enregistrement
|
|
de l'application</emphasis></para>
|
|
<para>Dans une fenêtre d'émulateur de terminal:</para>
|
|
<orderedlist>
|
|
<listitem><para>Connectez-vous en tant qu'utilisateur root.</para>
|
|
</listitem>
|
|
<listitem><para>Exécutez la commande:</para>
|
|
<para remap="CodeIndent2"><command>/usr/dt/bin/dtappintegrate -s /desktop_approots/BTE</command></para>
|
|
</listitem>
|
|
<listitem><para>Ouvrez le groupe d'applications Outils_Bureau et cliquez deux
|
|
fois sur Recharger applications.<indexterm><primary><$endrange>Enregistrement</primary><secondary>exemple</secondary></indexterm></para>
|
|
</listitem>
|
|
</orderedlist>
|
|
</listitem>
|
|
</orderedlist>
|
|
</sect3>
|
|
</sect2>
|
|
</sect1>
|
|
</chapter>
|
|
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 15:21:25-->
|
|
<?Pub *0000100517>
|