,--------------------------------------------------------------------.
|                                                         2.6.1995   |
| CONFFILE.TXT                                                       |
|                                                                    |
| no|Desktop - Konfigurationsdateien                                 |
|                                                                    |
| Copyright 1994,95 by no|Software GmbH                             |
|                                                                    |
| Dokumentation:                                                     |
|    Andreas Fahrig                                                  |
|    Ralph Mertens                                                   |
|    Christian Stamm                                                 |
|    Marco Zahnen                                                    |
`--------------------------------------------------------------------'


Inhalt
======
1 ................................. Die Objektdefinitionsdatei (?.NDQ)
2 ................................................ Menbaum - Resource
3 .... Die Icon-Zuordnungsdateien (?.NDI) und die Icon-Resourcedateien



Die no|Desktop - Konfigurationsdateien
======================================
Fr die Konfiguration des no|Desktop stehen eine Reihe von Dateien zur
Verfgung, deren Aufbau nun etwas nher erklrt werden soll.



1  Die Objektdefinitionsdatei (?.NDQ)
-------------------------------------
Dies ist eigentlich die wichtigste Konfigurationsdatei des no|Desktop.
Hier werden alle Objekte und die mit ihnen verknpften Kommandos
(Doppelklicks, Drag-Operationen) definiert. Die Datei NODESK.NDQ ist die
Objektdefinitionsdatei des no|Desktop im Text-Format. Sie liegt bei, um
einen Einstieg in die Anfertigung eigener Objektdefinitonsdateien zu
erleichtern.
Eigene Objektdefinitionsdateien mssen vor ihrer Verwendung im no|Desktop
mittels des Tools NDCMPLR.UTP in ein binre Form bersetzt werden
(aus ?.NDQ wird ?.NDD erstellt).
Da die Mglichkeiten, die man mit der Objektdefinitionsdatei hat, um das
Verhalten des Desktops zu steuern, SEHR umfangreich sind, mssen wir an
dieser Stelle leider auf eine eigene Dokumentationsdatei OBJEKTE.TXT
verweisen.


2  Menbaum - Resource
----------------------
Es ist mglich, mittels eines Resource-Editors (wie z.B. Interface)
einen eigenen Menbaum zu erstellen, und den einzelnen Eintrgen in
diesem Menbaum mittels des MENUEDIT.UTP eigene Kommandos bzw. Programme
zuzuordnen.
Um no|Desktop die neue Menleiste bekanntzugeben, mu dem newdesk-Kommando
der Name der PullDown-Men-Resourcedatei als Parameter bergeben werden.
Die Kommandos, die den einzelnen Meneintrgen zugeordnet sind, werden
ber 'aliase' realisiert. Diese aliase haben die Namen 'menucmdXY',
wobei X die Nummer des Mentitels in Hexadezimaldarstellung ist und Y
die Nummer des entsprechenden Eintrags unter diesem Titel ist. X und Y
knnen also Werte zwischen 1 und F haben.
Um dieses System zu verstehen, sollte man sich unsere Beispielkonfiguration
anschauen, dann ist es eigentlich kinderleicht! Besonders schn fanden wir
die Mglichkeit, auch Icons im PullDown-Men unterzubringen, wodurch sehr
hufig benutzte Tools fr den Anwender sehr einfach zu finden sind.
Setzt man im Programm-Info-Objekt (ganz links-oben in der Menleiste)
als erweiterten Objekt-Typen eine 1, so wird die Menleiste, soweit es
der AES-Screenmanager zult, im no|Look gezeichnet (3D-Darstellung).

WICHTIG! - Wenn man eine eigene Menbaum-Resource nachtrglich im
           Resource-Editor gendert hat, so mu der no|Desktop neu
           gestartet werden, um die nderungen korrekt neu einzubinden.
           Nur ein 'Desktop-Laden' reicht in diesem Fall leider nicht
           aus!


3  Die Icon-Zuordnungsdateien (?.NDI) und die Icon-Resourcedateien 
------------------------------------------------------------------

Alle no|Desktop-Icons werden aus ganz normalen GEM-Resource-Dateien geladen.
Es werden sowohl SW- als auch Farb-Icons erkannt und entsprechend
dargestellt. Man sollte jedoch nie vergessen, da Farbicons eine ganze
Menge Speicher verbrauchen knnen!
Die Icon-Zuordnungsdatei dient dazu, no|Desktop-Objekten ein Icon aus einer
Resource-Datei zuzuordnen. Die erste Zeile dieser Datei enthlt die
maximalen Anzahlen von mglichen Iconzuordnungen fr die vier verschiedenen
Objekttypen (durch Leerzeichen getrennt):

<Laufwerke> <Werkzeuge> <Ordner> <Dateien>

Die zweite Zeile enthlt die Namen der zu verwendenden Icon-Resource-Datei
mit vollem Pfad. Darauf folgen, jeweils durch Leerzeilen getrennt, die
Zuordnungsblcke fr die einzelnen Objektgruppen, und zwar wieder zuerst 
fr Laufwerke, dann Werkzeuge, dann Ordner und zuletzt Dateien.
Ein einfaches Beispiel fr eine Icon-Zuordnungsdatei wre:

      20 20 60 100
      C:\NODESK\CNF\ND_ICONS.RSC

      A           floppy
      B           floppy
      C           hddrv
      D           hddrv
      E           hddrv
      F           hddrv

      DRUCKER     printer

      *.*         ordner          # alle Ordner

      *.*@DESK    d_datei         # alle Dateien auf dem Desktop
      *.*         datei           # alle anderen Dateien

Einem Objektnamen (z.B. C fr das Laufwerk C:) wird ein Icon zugeordnet,
und zwar ber den Text, der dem Icon im Resource-Editor gegeben wurde.
Im obigen Beispiel besteht die Resource-Datei C:\NODESK\CNF\ND_ICONS.RSC
also aus 6 verschiedenen Icons mit den Texten "floppy","hddrv","printer",
"ordner","d_datei" und "datei".
Man mu im Resource-Editor darauf achten, da jedes Icon einen Text
erhlt, der aber nur einmal vorkommen darf! Dieser Text darf auerdem
keine Leerzeichen enthalten! ber die Lnge des Textes wird die minimale
Breite des Icons berechnet!
