La présente section explique comment créer un fichier de configuration pour une définition d'action.
Les fichiers de configuration contenant des définitions d'actions doivent respecter les règles ci-dessous.
Respecter la convention d'appellation nom.dt.
Les fichiers doivent se trouver dans le chemin de recherche de la base de données des actions et des types de données. Les chemins de recherche par défaut sont les suivants :
Actions personnelles : RépPersonnel/.dt/types ;
Actions système : /etc/dt/appconfig/types/langue ;
Actions intégrées : /usr/dt/appconfig/types/langue. Vous ne devez pas utiliser ce répertoire.
Pour plus de détails sur la modification du chemin de recherche des actions et des types de données, reportez-vous à la section "Définition de la valeur d'un chemin de recherche".
Ouvrez un fichier de base de données existant ou créez-en un nouveau.
Pour plus d'informations, reportez-vous à la section précédente, "Fichiers de configuration d'action".
Créez la définition de l'action en utilisant la syntaxe :
ACTION nom_action { TYPE type_action zone_action ... }
où :
nom_action : nom utilisé pour appeler l'action.
type_action : COMMAND (défaut), MAP ou TT_MSG.
zone_action : une ou plusieurs des zones requises ou facultatives pour ce type d'action. Toutes les zones se composent d'un mot clé et d'une valeur.
La plupart des zones d'action sont décrites dans ce chapitre. Pour plus de détails, consultez la page de manuel dtactionfile(4).
Sauvegardez le fichier.
Pour associer des icônes particulières à l'action, créez-les. Par défaut, les icônes se trouvent dans les répertoires suivants :
Icônes personnelles : RépPersonnel/.dt/icons ;
icônes système : /etc/dt/appconfig/icons/langue. La langue par défaut est C.
Pour plus d'informations, reportez-vous à la section "Définition d'une icône d'action".
Cliquez deux fois sur Recharger actions dans le groupe d'applications Outils_Bureau.
Créez un fichier d'action, pour qu'une icône représentant l'action soit ajoutée dans le Gestionnaire de fichiers ou dans le Gestionnaire d'applications. Si l'action est destinée à lancer une application, l'icône est appelée icône d'application.
Pour créer le fichier d'action, créez un fichier exécutable portant le même nom que l'action (nom_action), dans n'importe quel répertoire auquel vous pouvez accéder en écriture. Vous pouvez créer autant de fichiers d'action que nécessaire.
Les étapes suivantes créent une action personnelle permettant de lancer une application de télécopie sur un système distant appelé Serveur_AppA. La commande de lancement de cette application est la suivante :
/usr/fax/bin/faxcompose [nom_fichier]
Créez le fichier RépPersonnel/.dt/types/Fax.dt.
Entrez la définition d'action suivante dans le fichier :
ACTION Compo_télécopie { TYPE COMMAND ICON fax WINDOW_TYPE NO_STDIO EXEC_STRING /usr/fax/bin/faxcompose -c %Arg_1% EXEC_HOST Serveur_AppA DESCRIPTION Lance le programme de composition des télécopies
}
Les zones WINDOW_TYPE et EXEC_STRING décrivent le comportement de l'action.
WINDOW_TYPE : le mot clé NO_STDIO indique que l'action ne doit pas nécessairement être exécutée dans une fenêtre d'émulation de terminal.
Pour plus d'informations, reportez-vous à la section "Définition du support de fenêtrage".
EXEC_STRING : la syntaxe %Arg_1% accepte le dépôt d'un fichier. Lorsque l'utilisateur clique deux fois sur l'icône d'action, une fenêtre de composition de télécopie vide s'affiche.
Pour plus d'informations, reportez-vous à la section "Création de la chaîne d'exécution d'une action COMMAND".
Sauvegardez le fichier.
A l'aide de l'Editeur d'icônes, créez les icônes suivantes dans le répertoire RépPersonnel/.dt/icons :
Télécopie.m.pm (32 x 32 pixels)
Télécopie.t.pm (16 x 16 pixels)
Cliquez deux fois sur Recharger actions dans le groupe d'applications Outils_Bureau.
Créez un fichier exécutable appelé Compo_télécopie dans un répertoire auquel vous avez accès en écriture (votre répertoire personnel, par exemple).
Supposons que vous créez la plupart des fichiers que vous télécopiez à l'aide de l'Editeur de texte et qu'ils ont le type de données TEXTFILE (leur extension est *.txt).
La procédure ci-après permet d'ajouter une option Télécopier au menu Sélectionné(s) associé à ce type de données.
Ouvrez le fichier RépPersonnel/.dt/types/Fax.dt créé précédemment.
Ajoutez-y la définition d'action MAP suivante :
ACTION Télécopier { ARG_TYPE TEXTFILE TYPE MAP MAP_ACTION Compo_télécopie }
Sauvegardez le fichier.
Copiez la définition des attributs des données TEXTFILE de /usr/dt/appconfig/types/langue/dtpad.dt dans un nouveau fichier, RépPersonnel/.dt/types/textfile.dt. Ajoutez l'action Télécopier à la zone ACTIONS.
DATA_ATTRIBUTES TEXTFILE { ACTIONS Ouvrir,Imprimer,Télécopier ICON Dtpenpd ... }
Sauvegardez le fichier.
Ouvrez le Gestionnaire d'applications et cliquez deux fois sur Recharger applications, dans le groupe d'applications Outils_Bureau.
Pour que les nouvelles définitions d'action ou les actions modifiées prennent effet, le bureau doit relire la base de données.
Ouvrez le groupe d'applications Outils_Bureau et cliquez deux fois sur Recharger actions.
Ou lancez la commande suivante :
dtaction ReloadActions
ReloadActions est le nom de l'action correspondant à l'icône Recharger actions.
La base de données est également relue lorsque l'utilisateur :
se connecte ;
relance le Gestionnaire de l'espace de travail ;
sauvegarde une action à l'aide de l'option Sauvegarder du menu Fichier de la fenêtre Créer action.
Un fichier d'action permet de créer une représentation visuelle d'une action dans le Gestionnaire de fichiers ou d'applications.
Les icônes des fichiers d'action représentant des actions, elles sont parfois appelées icônes d'action. Si les actions associées permettent de lancer une application, ces icônes sont appelées icônes d'application.
Lorsque vous cliquez deux fois sur une icône d'action, l'action correspondante est lancée. Une icône d'action peut également être une zone de pose.
Par exemple, dans le cas d'une action définie comme suit :
ACTION Mon_application { EXEC_STRING Mfa -file %Arg_1% DESCRIPTION Lance Mon_application ICON Mfapp }
le fichier d'action est un fichier exécutable appelé Mon_application. Dans le Gestionnaire de fichiers et le Gestionnaire d'applications, ce fichier utilise l'icône Mfapp.taille.type. Si vous cliquez deux fois sur cette icône, le système lance la chaîne d'exécution de l'action. Lorsque vous demandez l'aide sur l'élément de l'action, le contenu de la zone DESCRIPTION apparaît ("exécute Mon_application").
Si la zone LABEL figure dans la définition d'action, sa valeur sera utilisée comme libellé du fichier d'action dans le Gestionnaire de fichiers et le Gestionnaire d'applications, à la place du nom du fichier (nom_action). Par exemple, si la définition d'action comporte les zones suivantes :
ACTION Mon_application { LABEL Mon application ... }
Le libellé de l'icône d'action sera "Mon application".
Utilisez la zone ICON pour indiquer l'icône utilisée dans le Gestionnaire de fichiers et le Gestionnaire d'applications pour les icônes d'action créées.
Si vous ne spécifiez pas d'icône, le système utilise les fichiers d'icônes d'action par défaut situés dans le répertoire /usr/dt/appconfig/icons/langue/Dtactn.*.
Pour modifier l'icône d'action, utilisez la ressource suivante :
*actionIcon: nom_fichier_icône
où nom_fichier_icône peut être un nom de base ou un chemin d'accès absolu.
La valeur de la zone ICON peut être :
Un nom de base de fichier.
Le nom de base du fichier est le nom du fichier contenant l'icône moins les suffixes de taille (m et t) et de type (bm et pm). Par exemple, si des fichiers s'appellent IcôneJeu.m.pm et IcôneJeu.t.pm, utilisez IcôneJeu.
Si vous utilisez un nom de fichier de base, les fichiers d'icône doivent être copiés dans un répertoire figurant dans le chemin de recherche des icônes.
Icônes personnelles : RépPersonnel/.dt/icons ;
Icônes système : /etc/dt/appconfig/icons/langue.
Un chemin d'accès absolu, comprenant le nom complet du fichier.
Utilisez le chemin absolu uniquement si le fichier d'icône ne figure pas dans le chemin de recherche de l'icône. Par exemple, si le fichier IcôneJeu.m.pm se trouve dans le répertoire /doc/projects, qui ne figure pas dans le chemin de recherche, la valeur de la zone ICON sera /doc/projects/GameIcon.m.pm.
Le Tableau 12-1 répertorie les tailles d'icônes que vous devez créer et les noms de fichiers correspondants.
Taille en pixels |
Nom bitmap |
Nom pixmap |
---|---|---|
48 x 48 |
nom.l.bm |
nom.l.pm |
32 x 32 |
nom.m.bm |
nom.m.pm |
16 x 16 |
nom.t.bm |
nom.t.pm |
Toutes les actions installées sur le système peuvent être modifiées, y compris les actions intégrées.
toute modification de la base de données des actions intégrées doit être effectuée avec précaution, en veillant à ne pas compromettre la compatibilité des actions intégrées avec les applications du bureau.
Repérez la définition de l'action à modifier.
Les emplacements par défaut des définitions d'action sont les suivants :
actions intégrées : /usr/dt/appconfig/types/langue ;
Actions système : /etc/dt/appconfig/types/langue ;
Actions personnelles : RépPersonnel/.dt/types.
Il est possible que des emplacements supplémentaires soient disponibles sur votre système. Pour en afficher la liste, entrez la commande suivante :
dtsearchpath -v
Votre système utilise les répertoires indiqués par la variable DTDATABASESEARCHPATH.
S'il y a lieu, copiez la définition d'action dans un fichier (nouveau ou existant) de l'un des répertoires suivants :
Actions système : /etc/dt/appconfig/types/langue ;
Actions personnelles : RépPersonnel/.dt/types.
Les fichiers situés dans /usr/dt/appconfig/types/langue ne pouvant pas être modifiés, vous devez copier les actions intégrées.
Effectuez les modifications voulues.
Une fois cette opération terminée, sauvegardez le fichier.
Cliquez deux fois sur Recharger actions dans le groupe d'applications Outils_Bureau.
Lorsque l'utilisateur lance une action, le système recherche une entrée correspondante dans la base de données. Lorsqu'il existe plusieurs occurrences, des règles de priorité sont appliquées pour sélectionner l'action à utiliser.
La priorité est déterminée par l'emplacement de la définition d'action, si aucune autre règle ne s'applique. La liste suivante indique les répertoires d'actions, dans l'ordre décroissant des priorités :
actions personnelles (RépPersonnel/.dt/types).
actions système locales (/etc/dt/appconfig/types/langue).
actions système distantes (nom_hôte:/etc/dt/appconfig/types/langue). Les systèmes hôtes distants recherchés sont ceux définis dans le chemin de recherche des applications.
actions intégrées (/usr/dt/appconfig/types/langue).
Dans un même répertoire, les fichiers *.dt sont lus dans l'ordre alphabétique.
Les actions restreintes par ARG_CLASS, ARG_TYPE, ARG_MODE ou ARG_COUNT ont priorité sur les actions non restreintes. La valeur par défaut de ces zones est *.
Lorsque plusieurs restrictions s'appliquent, l'ordre (décroissant) de priorité est le suivant :
ARG_CLASS ;
ARG_TYPE ;
ARG_MODE ;
ARG_COUNT.
Lorsque plusieurs restrictions ARG_COUNT s'appliquent, l'ordre (décroissant) de priorité est le suivant :
Valeur entière n
<n
>n
*
Prenons par exemple la définition d'action (partielle) suivante :
ACTION Editer_graphiques # Editer_graphiques-1 { ARG_TYPE XWD ... }
ACTION Editer_graphiques # Editer_graphiques-2 { ARG_COUNT 0 ... }
ACTION Editer_graphiques # Editer_graphiques-3 { ARG_TYPE * ... }
Lorsque vous cliquez deux fois sur l'icône d'action Editer_graphiques, l'action Editer_graphiques-2 est lancée. En effet, aucun argument n'ayant été indiqué, ARG_COUNT 0 est prioritaire. Lorsqu'un argument (fichier de type XWD) est spécifié, Editer_graphiques-1 est lancée car la zone ARG_TYPE est définie (sa valeur est XWD). Editer_graphiques-3 est utilisée pour tous les autres arguments (fichiers).