In diesem Abschnitt wird erläutert, wie eine Konfigurationsdatei für eine Aktionsdefinition erstellt wird.
Konfigurationsdateien mit Aktionsdefinitionen müssen folgende Bedingungen erfüllen:
Die Dateien müssen die Namenskonvention name.dt verwenden.
Die Dateien müssen sich im Datenbanksuchpfad (Aktionen und Datentypen) befinden. Der Standardpfad lautet:
Persönliche Aktionen - Home-Verzeichnis/.dt/types
Systemweite Aktionen - /etc/dt/appconfig/types/Sprache
Integrierte Aktionen - /usr/dt/appconfig/types/Sprache. Dieses Verzeichnis sollte nicht verwendet werden.
Informationen über das Ändern des Suchpfads für Aktionen und Datentypen finden Sie im Abschnitt "Wert eines Suchpfads setzen".
Öffnen Sie eine vorhandene Datenbankdatei, oder erstellen Sie eine neue Datei.
Informationen finden Sie im vorhergehenden Abschnitt "Konfigurationsdateien für Aktionen "".
Erstellen Sie die Aktionsdefinition mit folgender Syntax:
ACTION Aktionsname { TYPE Aktionstyp Aktionsfeld ... }
Die Parameter haben folgende Bedeutung:
Aktionsname - Der Name, mit dem die Aktion ausgeführt wird.
Aktionstyp - COMMAND (Standardwert), MAP oder TT_MSG.
Aktionsfeld - Eines der erforderlichen oder optionalen Felder für diesen Aktionstyp. Alle Felder bestehen aus einem Schlüsselwort und einem Wert.
Viele dieser Aktionsfelder werden in diesem Kapitel beschrieben. Weitere Informationen finden Sie auf der Hilfeseite dtactionfile(4).
Speichern Sie die Datei.
Soll das Aktionssymbol eine eindeutige Grafik verwenden, erstellen Sie die Symbole für die Aktion. Die Symbole befinden sich normalerweise im folgenden Verzeichnis:
Persönliche Symbole: Home-Verzeichnis/.dt/icons
Systemweite Symbole: /etc/dt/appconfig/icons/sprache. Der Standardwert für sprache ist C.
Weitere Informationen finden Sie im Abschnitt "Das Symbol für eine Aktion festlegen ".
Doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe Desktop-Werkzeuge.
Erstellen Sie eine Aktionsdatei für die Aktion. Diese Datei erstellt für die Aktion ein Symbol im Dateimanager oder Anwendungsmanager (wird mit der Aktion eine Anwendung gestartet, heißt das Symbol Anwendungssymbol).
Um eine Aktionsdatei zu erstellen, muß eine ausführbare Datei mit dem Namen Aktionsname angelegt werden. Sie können die Datei in jedes Verzeichnis einfügen, für das Sie Schreibzugriffsrechte haben. Es können beliebig viele Aktionsdateien erstellt werden.
In diesem Beispiel wird eine persönliche Aktion erstellt, mit der eine Fax-Anwendung auf dem entfernten System AppServerA gestartet werden kann. Der Befehl zum Starten der Fax-Anwendung lautet:
/usr/fax/bin/faxcompose [Dateiname]
Erstellen Sie die Datei Home-Verzeichnis/.dt/types/Fax.dt.
Fügen Sie die folgenden Aktionsdefinitionen in die Datei ein:
ACTION FaxComposer { TYPE COMMAND ICON fax WINDOW_TYPE NO_STDIO EXEC_STRING /usr/fax/bin/faxcompose -c %Arg_1% EXEC_HOST AppServerA DESCRIPTION Startet das Faxprogramm
}
Die Felder WINDOW_TYPE und EXEC_STRING beschreiben die Funktionsweise der Aktion.
WINDOW_TYPE - Das Schlüsselwort NO_STDIO legt fest, daß die Aktion nicht in einem Terminalemulationsfenster ausgeführt werden muß.
Weitere Informationen finden Sie im Abschnitt "Fensterunterstützung für die Aktion festlegen".
EXEC_STRING - Die Syntax %Arg_1% akzeptiert eine übergebene Datei. Beim Doppelklicken auf das Aktionssymbol wird ein leeres Faxfenster geöffnet.
Weitere Informationen finden Sie im Abschnitt "Ausführungszeichenfolge für eine COMMAND-Aktion erstellen".
Speichern Sie die Datei.
Erstellen Sie mit dem Symboleditor die folgenden Symboldateien im Verzeichnis Home-Verzeichnis/.dt/icons:
fax.m.pm, Größe 32 x 32 Pixel
fax.t.pm, Größe 16 x 16 Pixel
Doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe Desktop-Werkzeuge.
Erstellen Sie eine ausführbare Datei mit dem Namen FaxComposer in einem Verzeichnis, für das Sie über Schreibzugriffsrechte verfügen (zum Beispiel in Ihrem Home-Verzeichnis).
Das Beispiel setzt voraus, daß die meisten zu faxenden Dateien mit dem Texteditor erstellt werden und den Datentyp TEXTFILE (Dateien mit dem Namen *.txt) besitzen.
Mit den folgenden Arbeitsschritten wird der Menüpunkt 'Fax' dem Menü 'Ausgewählt' des Datentyps hinzugefügt.
Öffnen Sie die im letzten Beispiel erstellte Datei Home-Verzeichnis/.dt/types/Fax.dt.
Fügen Sie folgende Zuordnungsdefinition hinzu:
ACTION Fax { ARG_TYPE TEXTFILE TYPE MAP MAP_ACTION FaxComposer }
Speichern Sie die Datei.
Kopieren Sie die Datenattributdefinition für TEXTFILE aus dem Verzeichnis /usr/dt/appconfig/types/Sprache/dtpad.dt in die neue Datei Home-Verzeichnis/.dt/types/textfile.dt. Fügen Sie die Aktion 'Fax' dem Feld ACTIONS hinzu.
DATA_ATTRIBUTES TEXTFILE { ACTIONS Open,Print,Fax ICON Dtpenpd ... }
Speichern Sie die Datei.
Öffnen Sie den Anwendungsmanager, und doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe Desktop-Werkzeuge.
Damit neue oder bearbeitete Aktionsdefinitionen wirksam werden, muß die Datenbank erneut gelesen werden.
Öffnen Sie die Anwendungsgruppe Desktop-Werkzeuge, und doppelklicken Sie auf 'Aktionen neu laden'.
Oder führen Sie den folgenden Befehl aus:
dtaction ReloadActions
ReloadActions ist der Name der Aktion mit dem Namen 'Aktionen neu laden'.
Die Datenbank wird auch erneut gelesen, wenn der Benutzer folgende Aktionen durchführt:
Anmelden
Neustarten des Workspace Manager
Speichern einer Aktion mit dem Befehl 'Speichern' im Menü 'Datei' des Fensters 'Aktion erstellen'.
Eine Aktionsdatei ist eine sichtbare Repräsentation der Aktion im Dateimanager oder Anwendungsmanager.
Da das Symbol einer Aktionsdatei eine Aktion repräsentiert, wird es manchmal als Aktionsdatei bezeichnet. Wird durch die Aktion eine Anwendung gestartet, nennt man das Symbol Anwendungssymbol .
Durch Doppelklicken auf das Aktionssymbol wird die Aktion ausgeführt. Das Aktionssymbol kann auch eine Ablagezone sein.
Erstellen Sie eine ausführbare Datei mit dem Namen der Aktion. Der Inhalt der Datei ist nicht von Bedeutung.
Ein Beispiel: Die Aktion ist folgendermaßen definiert:
ACTION MyFavoriteApp { EXEC_STRING Mfa -file %Arg_1% DESCRIPTION Startet MyFavoriteApp ICON Mfapp }
Die Aktionsdatei ist dann eine ausführbare Datei mit dem Namen MyFavoriteApp. Im Dateimanager und Anwendungsmanager wird dann für die Datei MyFavoriteApp das Symbol Mfapp Größe.Typ verwendet. Durch Doppelklicken auf das Symbol MyFavoriteApp wird die Ausführungszeichenfolge ausgeführt. Als Online-Hilfe des Symbols wird der Inhalt des Feldes DESCRIPTION angezeigt ("Startet MyFavoriteApp").
Enthält die Aktionsdefinition das Feld LABEL, erhält die Aktionsdatei im Datei- und Anwendungsmanager den Inhalt dieses Feldes als Beschriftung und nicht den Dateinamen (Aktionsname ). Enthält die Aktionsdefinition beispielsweise die Zeile
ACTION MyFavoriteApp { LABEL Lieblingsanwendung ... }
hat das Aktionssymbol die Bezeichnung "Lieblingsanwendung".
Im Feld ICON können Sie das Symbol angeben, das im Datei- und Anwendungsmanager für die Aktion verwendet wird.
Geben Sie kein Symbol an, werden die Standardsymboldateien für Aktionssymbole verwendet (/usr/dt/appconfig/icons/Sprache/Dtactn.*).
Das Standardsymbol einer Aktion kann mit folgender Ressource geändert werden:
*actionIcon: Symbol_Dateiname
Der Parameter Symbol-Dateiname kann als Basisdateiname oder als absoluter Pfad angegeben werden.
Das Feld ICON kann folgende Werte annehmen:
Basisdateiname
Der Basisdateiname ist der Name der Datei mit der Symbolgrafik ohne Namenserweiterungen für die Größe (m und t) und den Grafiktyp (bm und pm). Verwenden Sie beispielsweise für die Dateien GameIcon.m.pm und GameIcon.t.pm den Basisnamen GameIcon.
Wenn Sie einen Basisdateinamen angeben, müssen sich die Dateien im Suchpfad für Symbole befinden:
Persönliche Symbole: Home-Verzeichnis/.dt/icons
Systemweite Symbole: /etc/dt/appconfig/icons/ Sprache
Absoluter Pfad der Symboldatei (einschließlich des vollständigen Dateinamens)
Der absolute Pfad sollte nur angegeben werden, wenn sich die Symboldatei nicht im Suchpfad für Symbole befinden. Liegt die Symboldatei GameIcon.m.pm im Verzeichnis /doc/projects, das nicht im Suchpfad enthalten ist, muß für das Feld ICON der Wert /doc/projects/GameIcon.m.pm angegeben werden.
Tabelle 12-1 enthält die zu erstellenden Symbolgrößen und die zugehörigen Dateinamen.
Größe in Pixel |
Bitmap-Name |
Pixmap-Name |
---|---|---|
48 x 48 |
name.l.bm |
name.l.pm |
32 x 32 |
name.m.bm |
name.m.pm |
16 x 16 |
name.t.bm |
name.t.pm |
Sie können alle im System verfügbaren Aktionen ändern, auch die integrierten.
Gehen Sie beim Ändern der integrierten Aktionen vorsichtig vor. Sie sind genau auf die Zusammenarbeit mit den Desktop-Anwendungen abgestimmt.
Suchen Sie die Definition der zu ändernden Aktion.
Die Aktionsdefinitionen befinden sich in folgenden Standardverzeichnissen:
Integrierte Aktionen: /usr/dt/appconfig/types/Sprache
Systemweite Aktionen: /etc/dt/appconfig/types/ Sprache
Persönliche Aktionen: Home-Verzeichnis /.dt/types
Es können auch weitere Verzeichnisse im System definiert sein. Eine Liste der für Aktionen verwendeten Verzeichnisse erhalten Sie mit dem Befehl:
dtsearchpath -v
Das System verwendet die unter DTDATABASESEARCHPATH aufgeführten Verzeichnisse.
Kopieren Sie gegebenenfalls den Text der Aktionsdefinition in eine neue oder bereits vorhandene Datei in einem der folgenden Verzeichnisse:
Systemweite Aktionen: /etc/dt/appconfig/types/Sprache
Persönliche Aktionen: Home-Verzeichnis /.dt/types
Integrierte Aktionen müssen zunächst kopiert werden, da Dateien im Verzeichnis /usr/dt/appconfig/types/Sprache nicht bearbeitet werden sollten.
Bearbeiten Sie die Aktionsdefinition.
Speichern Sie anschließend die Datei.
Doppelklicken Sie auf 'Aktionen neu laden' in der Anwendungsgruppe Desktop-Werkzeuge.
Ruft der Benutzer eine Aktion auf, durchsucht das System die Datenbank nach dem betreffenden Aktionsnamen. Ist mehr als eine Aktion mit diesem Namen vorhanden, beachtet das System bestimmte Regeln, um die zu verwendende Aktion zu bestimmen.
Werden keine anderen Regeln angewendet, ist die Position der Definitionen entscheidend. In der folgenden Liste sind die Aktionen von oben nach unten angeordnet:
Persönliche Aktionen (Home-Verzeichnis/.dt/types)
Systemweite lokale Aktionen (/etc/dt/appconfig/types/ Sprache)
Systemweite entfernte Aktionen (Rechnername :/etc/dt/appconfig/types/Sprache). Es wird auf den entfernten Rechnern gesucht, die sich im Suchpfad für Anwendungen befinden.
Integrierte Aktionen (/usr/dt/appconfig/types/ Sprache)
In einem gegebenen Verzeichnis werden die *.dt-Dateien in alphabetischer Reihenfolge gelesen.
Aktionen, die durch die Felder ARG_CLASS, ARG_TYPE, ARG_MODE oder ARG_COUNT beschränkt sind, haben Vorrang vor den nicht beschränkten Aktionen (der Standardwert für diese vier Felder ist *.)
Bei mehreren Beschränkungen lautet die Rangfolge von oben nach unten:
ARG_CLASS
ARG_TYPE
ARG_MODE
ARG_COUNT
Sind mehrere einschränkende ARG_COUNT-Felder vorhanden, lautet die Rangfolge von oben nach unten:
Spezifischer ganzzahliger Wert n
<n
>n
*
Im folgenden Beispiel sind Abschnitte verschiedener Aktionsdefinitionen aufgeführt:
ACTION EditGraphics # EditGraphics-1 { ARG_TYPE XWD ... }
ACTION EditGraphics # EditGraphics-2 { ARG_COUNT 0 ... }
ACTION EditGraphics # EditGraphics-3 { ARG_TYPE * ... }
Durch das Doppelklicken auf das Aktionssymbol EditGraphics wird EditGraphics-2 gestartet, da kein Argument angegeben ist und ARG_COUNT 0 Vorrang hat. Wird ein Dateiargument des Typs XWD angegeben, wird EditGraphics-1 verwendet, da hier XWD ARG_TYPE angegeben ist. EditGraphics-3 wird für alle anderen Dateiargumente verwendet.