Esta sección explica cómo crear un archivo de configuración para una definición de acción.
Los archivos de configuración que contienen definiciones de acciones deben cumplir los siguientes requisitos:
Los archivos deben utilizar la convención de nombres nombre.dt
Los archivos deben hallarse en la ruta de búsqueda de bases de datos (acciones y tipos de datos). La ruta de búsqueda predeterminada es:
Acciones personales:DirectorioInicio/.dt/types
Acciones accesibles en el sistema: /etc/dt/appconfig/types/idioma
Acciones incorporadas: /usr/dt/appconfig/types/idioma. No se debe utilizar este directorio.
Para obtener información sobre cómo modificar la ruta de búsqueda de acciones y tipos de datos, véase "Establecimiento del valor de una ruta de búsqueda".
Abra un archivo de base de datos existente o cree uno nuevo.
Véase la sección anterior, "Archivos de configuración de acciones".
Cree la definición de la acción mediante la sintaxis:
ACTION nombre_acción { TYPE tipo_acción campo_acción ... }
donde:
nombre_acción: es el nombre utilizado para ejecutar la acción.
tipo_acción: es el COMMAND (predeterminado), MAP o TT_MSG.
campo_acción: es uno de los campos opcionales u obligatorios para este tipo de acción. Todos los campos constan de una palabra clave y un valor.
En este capítulo se tratan diversos campos de acción. Para obtener más información, véase la página de comando man dtactionfile(4).
Guarde el archivo.
Si quiere que el icono de la acción sea exclusivo, cree un icono específico para la acción. La ubicación predeterminada para los iconos es:
Iconos personales: DirectorioInicio/.dt/icons
Iconos accesibles en el sistema: /etc/dt/appconfig/icons/idioma. El idioma predeterminado es C.
Para obtener más información, véase "Especificación de la imagen de icono utilizada por una acción".
Haga doble clic en Recargar acciones en el grupo de aplicaciones Herramientas_Escritorio.
Cree un archivo de acción para la acción; éste crea un icono en el Gestor de archivos o el Gestor de aplicaciones que representa la acción. (Si la acción inicia una aplicación, el icono se llama icono de aplicación.)
Para crear el archivo de acción, cree un archivo ejecutable con el nombre nombre_acción. Puede colocar el archivo en cualquier directorio para el que tenga permiso de escritura. Puede crear tantos archivos de acción como desee.
Siga estos pasos para crear una acción personal que inicia una aplicación de fax en el sistema remoto AppServerA. El comando para iniciar la aplicación de fax es:
/usr/fax/bin/faxcompose [nombre_archivo]
Cree el archivo DirectorioInicio/.dt/types/Fax.dt.
Escriba en el archivo la siguiente definición de acción:
ACTION FaxComposer { TYPE COMMAND ICON fax WINDOW_TYPE NO_STDIO EXEC_STRING /usr/fax/bin/faxcompose -c %Arg_1% EXEC_HOST AppServerA DESCRIPTION Ejecuta el creador de fax
}
Los campos WINDOW_TYPE y EXEC_STRING describen el comportamiento del sistema.
WINDOW_TYPE: la palabra clave NO_STDIO especifica que no tiene que ejecutarse la acción en una ventana de emulador de terminal.
Véase "Especificación del soporte de ventanas para la acción".
EXEC_STRING: la sintaxis %Arg_1% acepta un archivo soltado sobre el icono. Si se pulsa dos veces el icono de la acción, ésta abre una ventana vacía del editor de faxes.
Véase "Creación de la cadena de ejecución para una acción COMMAND".
Guarde el archivo.
Utilice el editor de iconos para crear las siguientes imágenes de iconos en el directorio DirectorioInicio/.dt/icons:
fax.m.pm, tamaño 32 por 32 píxels
fax.t.pm, tamaño 16 por 16 píxels
Haga doble clic en Recargar acciones en el grupo de aplicaciones Herramientas_Escritorio.
Cree un archivo ejecutable llamado FaxComposer en un directorio para el que disponga de permiso de escritura (por ejemplo, su directorio de inicio).
Suponga que la mayoría de los archivos que envía por fax se crean con el editor de texto y son del tipo de datos TEXTFILE (archivos de nombre * .txt).
Los pasos siguientes agregan el elemento de menú "Fax" en el menú Seleccionada del tipo de datos.
Abra el archivo DirectorioInicio/.dt/types/Fax.dt creado en el ejemplo anterior.
Agregue al archivo la siguiente definición de acción map:
ACTION Fax { ARG_TYPE TEXTFILE TYPE MAP MAP_ACTION FaxComposer }
Guarde el archivo.
Copie la definición de atributos de datos de TEXTFILE desde /usr/dt/appconfig/types/idioma/dtpad.dt a un nuevo archivo, DirectorioInicio/.dt/types/textfile.dt. Agregue la acción Fax en el campo ACTIONS.
DATA_ATTRIBUTES TEXTFILE { ACTIONS Open,Print,Fax ICON Dtpenpd ... }
Guarde el archivo.
Abra el Gestor de aplicaciones y haga doble clic en Recargar acciones en el grupo de aplicaciones Herramientas_Escritorio.
Para que las acciones nuevas o modificadas surtan efecto, el escritorio debe volver a leer la base de datos.
Abra el grupo de aplicaciones Herramientas_Escritorio y haga doble clic en Recargar acciones
O bien, ejecute el comando:
dtaction ReloadActions
ReloadActions es el nombre de la acción cuyo icono está etiquetado como ``Recargar acciones''.
Así se vuelve a leer la base de datos de acciones cuando el usuario:
Inicia la sesión
Reinicia el Gestor de área de trabajo
Guarda una acción en la ventana Crear acción, seleccionando Guardar en el menú Archivo.
Un archivo de acción es un archivo creado para proporcionar una representación visual de la acción en el Gestor de archivos o el Gestor de aplicaciones.
Dado que el icono de un archivo de acción representa una acción, se denomina a veces icono de acción, pero si la acción subyacente inicia una aplicación, recibe el nombre de icono de aplicación.
Al hacer doble clic en el icono de acción, ésta se ejecuta. También se puede soltar archivos sobre el icono de acción.
Por ejemplo, si la definición de la acción es:
ACTION MiAplFavorita { EXEC_STRING Maf -file %Arg_1% DESCRIPTION Ejecuta MiAplFavorita ICON MAplf }
el archivo de acción será un archivo ejecutable llamado MiAplFavorita, el cual, en el Gestor de archivos y el Gestor de aplicaciones, utilizará la imagen de icono Maplf.tamaño. tipo. Si pulsa dos veces el icono de MiAplFavorita, se ejecutará la cadena de ejecución de la acción y la ayuda sobre el tema del icono será el contenido del campo DESCRIPTION ("Ejecuta MiAplFavorita").
Si la definición de la acción incluye el campo LABEL, el archivo de acción estará etiquetado en el Gestor de archivos y el Gestor de aplicaciones con el contenido de este campo en lugar del nombre de archivo (action_name). Por ejemplo, si la definición de acción incluye:
ACTION MiAplFavorita { LABEL Aplicación Favorita ... }
el icono de acción se etiquetará "Aplicación favorita".
Utilice el campo ICON para especificar el icono usado en el Gestor de archivos y el Gestor de aplicaciones para los iconos creados para la acción.
Si no especifica ningún icono, el sistema utilizará los archivos de imágenes de iconos de acción predeterminados /usr/dt/appconfig/icons/idioma/Dtactn.*.
El icono de acción predeterminado puede cambiarse mediante el recurso:
*actionIcon: nombre_archivo_icono
donde nombre_archivo_icono puede ser un nombre base o una ruta absoluta.
El valor del campo ICON puede ser:
Un nombre de archivo base
El nombre de archivo base es el nombre del archivo que contiene la imagen del icono menos los sufijos de tamaño (m y t) y tipo de imagen (bm y pm). Por ejemplo, si los archivos se llaman GameIcon.m.pm y GameIcon.t.pm, utilice GameIcon.
Si utiliza el nombre de archivo base, los archivos de iconos deben estar ubicados en la ruta de búsqueda de iconos:
Iconos personales: DirectorioInicio/.dt/icons
Iconos accesibles en el sistema: /etc/dt/appconfig/icons/idioma
Una ruta absoluta al archivo del icono, que incluya el nombre de archivo completo
Deberá utilizar la ruta absoluta sólo si el icono no está ubicado en la ruta de búsqueda de iconos. Por ejemplo, si se coloca el archivo de icono GameIcon.m.pm en el directorio /doc/projects, que no está en la ruta de búsqueda de iconos, el valor del campo ICON sería /doc/projects/GameIcon.m.pm.
Tabla 12-1 muestra una lista de los tamaños de icono que debe crear y los nombres de archivo correspondientes.
Tamaño en píxels |
Nombre del mapa de bits |
Nombre del mapa de píxels |
---|---|---|
48 por 48 |
nombre.l.bm |
nombre.l.pm |
32 por 32 |
nombre.m.bm |
nombre.m.pm |
16 por 16 |
nombre .t.bm |
nombre .t.pm |
Se puede modificar cualquiera de las acciones disponibles en el sistema, incluidas las incorporadas.
Tenga cuidado al modificar la base de datos de acciones incorporadas, ya que están diseñadas para funcionar correctamente con las aplicaciones de escritorio.
Localice la definición de la acción que desea modificar.
Las ubicaciones predeterminadas para las definiciones de acciones son:
Acciones incorporadas: /usr/dt/appconfig/types/idioma
Acciones accesibles en el sistema: /etc/dt/appconfig/types/idioma
Acciones personales: DirectorioInicio/.dt/types
Posiblemente su sistema incluya ubicaciones adicionales. Para ver una lista de las ubicaciones que el sistema utiliza para las acciones, ejecute el comando:
dtsearchpath -v
Su sistema utiliza los directorios listados en DTDATABASESEARCHPATH.
Si es necesario, copie el texto de la definición de acción en un archivo nuevo o existente de uno de estos directorios:
Acciones accesibles en el sistema: /etc/dt/appconfig/types/idioma
Acciones personales: DirectorioInicio/.dt/types
Debe copiar las acciones incorporadas, ya que no es aconsejable editar los archivos del directorio /usr/dt/appconfig/types/idioma.
Edite la definición de la acción.
Cuando haya terminado, guarde el archivo.
Haga doble clic en Recargar acciones en el grupo de aplicaciones Herramientas_Escritorio.
Cuando el usuario invoca una acción, el sistema busca en la base de datos un nombre de acción que coincida. Si existe más de una acción con el mismo nombre, el sistema utiliza reglas de prioridad para decidir cuál debe utilizar.
Si no es aplicable ninguna otra regla, la prioridad se basa en la ubicación de la definición. La lista siguiente está ordenada de la prioridad más alta a la más baja:
Acciones personales (DirectorioInicio/.dt/types)
Acciones locales accesibles en el sistema (/etc/dt/appconfig/types/idioma)
Acciones remotas accesibles en el sistema (nombre de sistema:/etc/dt/appconfig/types/idioma). Los sistemas remotos en los que se realiza la búsqueda son los listados en la ruta de búsqueda de aplicaciones.
Acciones incorporadas (/usr/dt/appconfig/types/idioma)
Dentro de un directorio determinado, los archivos *.dt se leen por orden alfabético.
Las acciones restringidas por ARG_CLASS, ARG_TYPE, ARG_MODE o ARG_COUNT tienen prioridad sobre las no restringidas. (El valor predeterminado para estos cuatro campos es *.)
Cuando es aplicable más de una restricción, la prioridad en orden descendente es:
ARG_CLASS
ARG_TYPE
ARG_MODE
ARG_COUNT
Cuando existe más de un ARG_COUNT restringido, el orden de preferencia es, de mayor a menor:
Valor entero específico n
<n
>n
*
Por ejemplo, consideremos los siguientes fragmentos de definiciones de acciones:
ACTION EditarGráficos # EditarGráficos-1 { ARG_TYPE XWD ... }
ACTION EditarGráficos # EditarGráficos-2 { ARG_COUNT 0 ... }
ACTION EditarGráficos # EditarGráficos-3 { ARG_TYPE * ... }
Si se pulsa dos veces el icono de acción EditarGráficos se iniciará EditarGráficos-2, porque no se ha proporcionado ningún argumento y ARG_COUNT 0 tiene prioridad. Si se proporciona un argumento de archivo del tipo XWD, se utilizará EditarGráficos-1, porque especifica ARG_TYPE XWD. Para todos los demás argumentos de archivo se utiliza EditarGráficos-3.