Solaris CDE - Guide avancé de l'utilisateur et de l'administrateur système

Création manuelle d'une action : étapes principales

La présente section explique comment créer un fichier de configuration pour une définition d'action.

Fichiers de configuration 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.

Création manuelle

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.

Exemple de création d'action COMMAND

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).

Exemple de création d'action MAP

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.

Rechargement de la base de données des actions et des types de données

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.

Création d'un fichier (icône) d'action

Un fichier d'action permet de créer une représentation visuelle d'une action dans le Gestionnaire de fichiers ou d'applications.

Figure 12–1 Fichiers d'action (icônes d'action) dans le Gestionnaire 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.

Création d'un fichier d'action (icône d'action)

Créez un fichier exécutable portant le même nom que l'action ; son contenu n'a pas d'importance.

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”).

Libellés d'actions

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".

Définition d'une icône d'action

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.*.

Figure 12–2 Icône d'action par défaut

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–1répertorie les tailles d'icônes que vous devez créer et les noms de fichiers correspondants.

Tableau 12–1 Nom et taille des icônes d'action


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`

Modification d'une définition d'action existante

Toutes les actions installées sur le système peuvent être modifiées, y compris les actions intégrées.

Remarque :

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.

Priorité des définitions d'action

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).