home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / toolmana.lha / ToolManager / Docs / TM_Deutsch.doc < prev    next >
Encoding:
Text File  |  1992-09-26  |  48.9 KB  |  1,324 lines
  1.  
  2. ToolManager 2.0 Dokumentation
  3. ******************************
  4.  
  5.  
  6. Copyright und andere rechtliche Dinge
  7. **************************************
  8.  
  9.    Copyright (C) 1990-92 Stefan Becker
  10.  
  11.    Diese Dokumentation darf kopiert und weitergegeben werden solange die
  12. Copyright-Notiz und diese Erlaubnis unverΣndert auf allen Kopien
  13. enthalten ist.
  14.  
  15.    Es wird keine Garantie gegeben, da▀ die Programme, die in dieser
  16. Dokumentation beschrieben werden, 100%ig zuverlΣssig sind. Sie
  17. benutzen diese Programme auf eigene Gefahr. Der Autor kann auf *keinen*
  18. Fall fⁿr irgendwelche SchΣden verantwortlich gemacht werden, die
  19. durch die Anwendung dieser Programme entstehen.
  20.  
  21.    Das Paket ist "freely distributable", aber das Copyright liegt
  22. weiterhin bei Stefan Becker. Dies bedeutet, da▀ es von jedem kopiert
  23. werden darf solange er nicht mehr als eine angemessene Kopiergebⁿhr
  24. dafⁿr verlangt. Diese Gebⁿhr *darf nicht* h÷her sein als US $5 oder
  25. 5 DM.
  26.  
  27.    *Dieses Limit gilt auch fⁿr deutsche Public-Domain HΣndler!!*
  28.  
  29.    Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden,
  30. insbesondere in Fred Fishs Amiga Disk Library (CD ROM Versionen dieser
  31. Sammlung eingeschlossen). Die Distributionsdatei darf in
  32. Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
  33. Paket weitergeben wollen, dann *mⁿssen* Sie die originale
  34. Distributionsdatei `ToolManager2_0.lha' benutzen.
  35.  
  36.    Weder die Programme noch der Quelltext (oder Teile davon) dⁿrfen
  37. ohne eine schriftliche Genehmigung des Autors in kommerziellen
  38. Programmen benutzt werden.
  39.  
  40.    Die Programme und der Quelltext (oder Teile davon) dⁿrfen *auf
  41. keinen Fall* auf irgendeiner Maschine benutzt werden, die fⁿr die
  42. Forschung, Entwicklung, Konstruktion, Tests oder Produktion von Waffen
  43. oder anderen militΣrischen Gⁿtern benutzt wird. Dies gilt natⁿrlich
  44. auch fⁿr alle Maschinen, die fⁿr das Training von Personen in
  45. *irgendeiner* der obengenannten TΣtigkeiten benutzt werden.
  46.  
  47.  
  48. Wichtige Bemerkungen
  49. *********************
  50.  
  51.    Willkommen zur wundervollen Welt von ToolManager 2.0 :-)
  52.  
  53.    - ToolManager und seine Konzepte wurden drastisch verΣndert (siehe
  54.      Geschichte) seit der letzten Version (1.5).
  55.  
  56.    - Beginnend mit der Version 2.0 ist ToolManager *GiftWare*. Wenn
  57.      Ihnen dieses Programm gefΣllt und Sie es sehr oft benutzen, dann
  58.      sollten Sie darⁿber nachdenken, ob sie dem Autor eine kleine
  59.      Spende schicken um die Arbeit zu honorieren, die er in dieses
  60.      Programm gesteckt hat. Ich schlage eine Spende in der
  61.      Gr÷▀enordnung von US $10-$20 oder 10-20 DM vor. Bitte schicken Sie
  62.      mir au▀erhalb Europas keine Schecks, da es meistens mehr Geld
  63.      kostet, diesen Scheck einzul÷sen, als ⁿberhaupt Geld darauf ist.
  64.  
  65.      Wenn Sie keine Spende schicken oder es sich nicht erlauben
  66.      k÷nnen, dann mⁿssen sie sich nicht schuldig fⁿhlen. Sie sollten
  67.      mir aber trotzdem einen Brief schicken, wenn sie ToolManager
  68.      benutzen (Ich liebe es Post zu bekommen :-). Siehe Adresse des
  69.      Autors.
  70.  
  71.    - Benutzer von ToolManager 1.X k÷nnen mit dem Kapitel ⁿber die
  72.      Schnellinstallation beginnen (siehe Schnellinstallation). Einige
  73.      Merkmale haben sich nicht geΣndert und der Rest ist relativ
  74.      einfach durch Ausprobieren herauszufinden. Fⁿr eine genaue
  75.      Beschreibung des neuen Konzeptes und der neuen Merkmale schlagen
  76.      sie bitte in dem Referenzteil dieser Dokumentation nach (siehe
  77.      Objekte).
  78.  
  79.      Jede noch laufende ToolManager 1.X Version *muss* entfernt werden
  80.      oder die neue Version wird nicht funktionieren. Die neue Version
  81.      kann leider die Konfigurationsdatei der alten Version nicht lesen.
  82.  
  83.    - Erstbenutzer sollten die ganze Dokumentation lesen, um das Konzept
  84.      und den Zweck des Programmes zu verstehen. Beginnen sie mit
  85.      Einfⁿhrung.
  86.  
  87.    - ToolManager 2.0 benutzt einige Merkmale der AmigaOS Version V38,
  88.      die (hoffentlich) fⁿr alle Benutzer zugΣnglich ist zu dem
  89.      Zeitpunkt, an dem sie dies hier lesen. Wenn sie noch die Version
  90.      2.0 benutzen (sie wird in dieser Dokumentation als V37
  91.      bezeichnet), dann brauchen sie keine Angst zu haben, denn
  92.      ToolManager arbeitet auch ohne diese neue Version. Alle
  93.      erweiterten V38 Merkmale sind in dieser Dokumentation markiert.
  94.  
  95.  
  96. Wohin man Bug reports, Kommentare & Spenden schickt
  97. ****************************************************
  98.  
  99.    Der Autor kann unter folgenden Adressen erreicht werden:
  100.  
  101. Postadresse:
  102.                Stefan Becker
  103.                Holsteinstrasse 9
  104.           5100 Aachen
  105.                GERMANY
  106.  
  107. InterNet Electronic Mail:
  108.  
  109.           stefanb@pool.informatik.rwth-aachen.de
  110.  
  111.  
  112. Wie man ToolManager 2.0 schnell installiert
  113. ********************************************
  114.  
  115.    Die grundlegende ToolManager 2.0 Installation besteht aus den
  116. folgenden vier Teilen:
  117.  
  118. `Libs/toolmanager.library' => `LIBS:'
  119.      Dies ist das Hauptprogramm von ToolManager. Es verwaltet alle
  120.      Programme, Menⁿs, Piktogramme und Docks (siehe Library).
  121.  
  122. `Prefs/ToolManager*' => `SYS:Prefs'
  123.      Dies ist der Voreinsteller fⁿr die Konfiguration (siehe
  124.      Voreinstellungen).
  125.  
  126. `WBStartup/ToolManager*' => `SYS:WBStartup'
  127.      Mit diesem Hilfsprogramm kann ToolManager gestartet und gestoppt
  128.      werden. Wenn es in der WBStartup Schublade liegt, dann wird
  129.      ToolManager immer automatisch beim Starten der Maschine geladen.
  130.  
  131. `L/WBStart-Handler' => `L:'
  132.      Dieses Programm startet Programme mit der Workbench-Startmethode.
  133.      Es ist ein eigener Prozess, so da▀ man ToolManager auch dann noch
  134.      verlassen kann, wenn man Workbenchprogramme gestartet hat.
  135.  
  136.  
  137. Was ist ToolManager?
  138. *********************
  139.  
  140.    ToolManager ist ein flexibles Programm zur Verwaltung von
  141. Hilfsprogrammen in Ihrer Arbeitsumgebung. Es kann sowohl Workbench-
  142. oder CLI-Programme starten als auch ARexx-Skripte ausfⁿhren. Die
  143. BenutzeroberflΣche besteht aus Menⁿs, Piktogrammen und Dock-Fenstern.
  144. Wenn Sie einen lauten Computer m÷gen, dann k÷nnen Sie zu jedem dieser
  145. Dinge einen Ton hinzufⁿgen. Siehe Ton.
  146.  
  147.    ToolManger kann EintrΣge zu dem Workbench `Tools' Menⁿ
  148. hinzufⁿgen. Wenn Sie einen dieser EintrΣge auswΣhlen, dann wird das
  149. dazugeh÷rige Programm gestartet. Jedes Piktogramm, das zu diesem
  150. Zeitpunkt auf der Workbench ausgewΣhlt ist, wird als Argument fⁿr
  151. dieses Programm benutzt. MenⁿeintrΣge sind nur dann m÷glich, wenn
  152. die Workbench lΣuft. Siehe Menⁿ.
  153.  
  154.    ToolManager kann Piktogramme zum Workbench-Fenster hinzufⁿgen.
  155. Falls Sie ein solches Piktogramm doppelklicken, dann wird das
  156. dazugeh÷rige Programm gestartet. Wenn Sie einige Piktogramme auf dieses
  157. Piktogramm schieben, dann wird das Programm mit diesen Piktogrammen als
  158. Argumenten gestartet. Piktogramme sind nur dann m÷glich, wenn die
  159. Workbench lΣuft. Siehe Piktogramm.
  160.  
  161.    ToolManager kann ein Dock-Fenster aus einer Zusammenfassung von
  162. Programmen erstellen. Dieses Fenster kann auf jedem ÷ffentlichen
  163. Schirm ge÷ffnet werden. Jedes Programm wird durch ein Bild oder ein
  164. Textgadget reprΣsentiert. Um ein Programm zu starten brauchen Sie nur
  165. auf das Bild oder das Textgadget zu klicken. Falls das Fenster auf der
  166. Workbench ge÷ffnet wurde und die Workbench lΣuft, dann k÷nnen Sie
  167. auch einige Piktogramme auf das Bild oder das Textgadget schieben, um
  168. das Programm mit Argumenten zu starten. Siehe Dock.
  169.  
  170.    Weiterhin k÷nnen Sie jedem Programm einen Tastenbefehl zuweisen.
  171. Wenn Sie diesen Tastenbefehl benutzen, dann wird das Programm
  172. gestartet. Beachten Sie dabei, da▀ in diesem Fall *keine* Argumente an
  173. das Programm ⁿbergeben werden k÷nnen. Siehe Programm.
  174.  
  175.  
  176. Die Konzepte hinter ToolManager
  177. ********************************
  178.  
  179.    ToolManager 2.0 benutzt einen neuen objektorientierten Ansatz um ein
  180. flexibles und erweiterbares System zu erm÷glichen. Dieser Ansatz
  181. machte viele Verbesserungen an den ToolManager 1.X Merkmalen m÷glich,
  182. z.B. man kann jetzt mehrere Dock-Fenster haben.
  183.  
  184.    Ein Objekt ist eine Zusammenfassung von Daten, die seine Merkmale
  185. beschreiben. Jedes Objekt hat einen Namen und einen Typ. Sie k÷nnen
  186. von jedem Typ so viele Objekte erzeugen wie sie m÷chten, allerdings
  187. mu▀ der Name jedes Objektes eindeutig sein, da er dazu benutzt wird um
  188. das Objekt anzusprechen.
  189.  
  190.    Momentan gibt es sechs verschiedene Objekttypen: Programm, Bild,
  191. Ton, Menⁿ, Piktogramm und Dock. Die ersten drei Typen sind einfache
  192. Objekte, d.h. sie verweisen auf keine anderen Objekte. Sie stellen den
  193. komplexen Objekten Daten oder Dienste zur Verfⁿgung.
  194.  
  195.    Die letzten drei Typen sind komplexe Objekte, d.h. sie verweisen auf
  196. einfache Objekte und ben÷tigen deren Daten oder Dienste. Der Verweis
  197. geschieht aufgrund des Namens und falls kein einfaches Objekt mit
  198. diesem Namen existiert, dann ignoriert das komplexe Objekt es. Beachten
  199. Sie dabei, da▀ dies die FunktionalitΣt des komplexen Objektes
  200. beeintrΣchtigen kann, z.B. ben÷tigt ein Piktogrammobjekt die Daten
  201. eines Bildobjekts, anderenfalls wird es kein Piktogramm erzeugen.
  202.  
  203.    Fⁿr eine detailierte Beschreibung aller Objektparameter siehe
  204. Objekte.
  205.  
  206.  
  207. Beschreibungen fⁿr alle Dateien in der Distribution
  208. ****************************************************
  209.  
  210.    Die ToolManager 2.0 Distribution besteht aus mehreren
  211. Verzeichnissen, die alle weiter unten erlΣutert werden.
  212.  
  213.  
  214. Das Docs Verzeichnis
  215. =====================
  216.  
  217.    Dieses Verzeichnis enthΣlt die Dokumentation fⁿr ToolManager. Die
  218. Dokumentation ist in vier verschiedenen Formaten und verschiedenen
  219. Sprachen vorhanden. Weiterhin existiert eine Datei in dem
  220. AutoDoc-Format, die die ToolManager shared library Schnittstelle
  221. beschreibt.
  222.  
  223. Prefix `TM_<Sprache>'
  224.      Diese Datei enthΣlt die Dokumentation in der angegebenen Sprache.
  225.      Momentan sind folgende Sprachen vorhanden: Deutsch, English,
  226.      Svenska.
  227.  
  228. Postfix `.doc'
  229.      Diese Datei enthΣlt die Dokumentation als einfacher ASCII-Text.
  230.  
  231. Postfix `.dvi'
  232.      Diese Datei enthΣlt die Dokumentation in TeXs DVI-Format. Um
  233.      daraus eine gedruckte Dokumentation zu erstellen, mⁿssen sie
  234.      diese Datei durch einen TeX Druckertreiber schicken.
  235.  
  236. Postfix `.guide'
  237.      Diese Datei enthΣlt die Dokumentation im AmigaGuide-Format.
  238.      Obwohl dieses Format nur aus einfachem ASCII-Text mit ein paar
  239.      Befehlen besteht, ben÷tigen Sie AmigaGuide um die Hypertext
  240.      Verkettungen nutzen zu k÷nnen. Der Autor hofft, da▀ AmigaGuide
  241.      bald allen Amiga-Besitzern zur Verfⁿgung steht.
  242.  
  243. Postfix `.tex'
  244.      Diese Datei enthΣlt die Dokumentation im Texinfo-Format. Dieses
  245.      Format wurde von der Free Software Foundation (FSF) erfunden.
  246.      Zusammen mit dem `texinfo.tex' Makropaket k÷nnen sie TeX und
  247.      `texindex' benutzen, um eine Datei im DVI-Format zu erstellen
  248.      (siehe oben).
  249.  
  250. `toolmanager.doc'
  251.      Diese Datei beschreibt die ToolManager shared library
  252.      Schnittstelle im AutoDoc-Format.
  253.  
  254.  
  255. Das Goodies Verzeichnis
  256. ========================
  257.  
  258.    Dieses Verzeichnis enthΣlt zusΣtzliche Programmpakete, die
  259. nⁿtzlich fⁿr ToolManager sind.
  260.  
  261. `GetPubName.lha'
  262.      Dieses kleine Programm gibt den Namen des obersten ÷ffentlichen
  263.      Schirms auf die Standardausgabe oder in eine Umgebungsvariable
  264.      aus. Es wurde geschrieben von Michael "Mick" Hohmann.
  265.  
  266. `upd1_20.lha'
  267.      Das Programm `upd' wurde geschrieben von Jonas Petersson. Es ist
  268.      ein kleines Program, da▀ einen ARexx-Port ÷ffnet und auf Befehle
  269.      wartet. Mit Hilfe von ARexx k÷nnen Sie `upd' veranlassen
  270.      digitalisierte T÷ne und GerΣusche abzuspielen. ToolManager
  271.      benutzt diese Eigenschaft um seine Tonobjekte zu realisieren. Siehe
  272.      Ton.
  273.  
  274.    ToolManager 1.5 Benutzer m÷gen sich wundern, wo das Hilfsprogramm
  275. `DeleteTool' geblieben ist. Es kann durch das Program `BlackHole' von
  276. der Fish Disk #622 ersetzt werden.
  277.  
  278.  
  279. Das Graphics Verzeichnis
  280. =========================
  281.  
  282.    Dieses Verzeichnis enthΣlt eine reichhaltige Sammlung von Bildern
  283. aus denen Sie wΣhlen k÷nnen. Laden Sie sie einfach als Bildobjekte in
  284. ToolManager (siehe Bild).
  285.  
  286.    Die Dateien wurden von verschiedenen Personen zur Verfⁿgung gestellt
  287. (siehe Danksagungen). Jeder von ihnen hat ein eigenes Unterverzeichnis
  288. erhalten. Da diese Dateien von verschieden Personen erstellt wurden,
  289. stammen sie aus verschiedenen Umgebungen (Farbpalette, Tiefe,
  290. Aufl÷sung, Gr÷▀e) und haben unterschiedliche Desginstile. Es kann
  291. also durchaus vorkommen, da▀ sie nicht gut auf Ihrer Maschine aussehen.
  292.  
  293.    Damit man die unterschiedlichen Formate, die von ToolManager
  294. unterstⁿtzt werden, unterscheiden kann, hat jeder Dateiname einen
  295. speziellen Postfix:
  296.  
  297. `.anmb'
  298.      Dies ist eine IFF ANIM Datei, die von einem Mal- oder
  299.      Animationsprogramm erstellt wurde. Sie kann mehrere Bilder
  300.      enthalten. Obwohl ToolManager komplette ANIM Dateien laden kann,
  301.      sollten sie eine Σhnliche Funktion wie DPaints "AnimBrush"
  302.      benutzen, um den interessanten Teil aus der Animation
  303.      herauszuschneiden.
  304.  
  305. `.brush'
  306.      Dies ist eine IFF ILBM Datei, die von einem Malprogramm erzeugt
  307.      wurde. Sie enthΣlt nur ein Bild.
  308.  
  309. `.info'
  310.      Dies ist eine normale Amiga Piktogrammdatei, die durch IconEdit
  311.      (oder etwas Σhnliches) erzeugt wurde. Sie kann zwei Bilder
  312.      enthalten.
  313.  
  314.  
  315. Das L Verzeichnis
  316. ==================
  317.  
  318.    Dieses Verzeichnis enthΣlt nur eine Datei, nΣmlich
  319. `WBStart-Handler'. Sie *mⁿssen* diese Datei in das `L:' Verzeichnis
  320. kopieren, sonst kann ToolManager keine Programmobjekte mit der
  321. Workbench-Startmethode starten (siehe Programm).
  322.  
  323.    Das komplette WBStart 1.2 Paket wird auf einer Fish Disk erscheinen.
  324.  
  325.  
  326. Das Libs Verzeichnis
  327. =====================
  328.  
  329.    Dieses Verzeichnis enthΣlt nur eine Datei, `toolmanager.library'.
  330. Dies ist das Hauptprogramm von ToolManager und mu▀ in das `LIBS:'
  331. Verzeichnis kopiert werden.
  332.  
  333.  
  334. Das Locale Verzeichnis
  335. =======================
  336.  
  337.    Dieses Verzeichnis enthΣlt alle Dateien fⁿr die Lokalisation von
  338. ToolManager. Da die locale.library erst in V38 enthalten ist, brauchen
  339. Sie keine dieser Dateien zu kopieren, falls sie noch V37 benutzen. Wenn
  340. Sie schon V38 benutzen, dann wΣhlen Sie die Ihrer Sprache
  341. entsprechende Datei.
  342.  
  343. `Catalogs/<Sprache>/toolmanager.catalog'
  344.      Dies ist eine ▄bersetzungsdatei fⁿr die angegebene Sprache.
  345.      Kopieren Sie die Datei fⁿr Ihre Sprache in das Verzeichnis
  346.      `LOCALE:Catalogs/<Sprache>'.
  347.  
  348. `Languages/<Sprache>.language'
  349.      Einige Sprachen werden noch nicht unterstⁿtzt von der Standard
  350.      V38 Locale Distribution. Daher haben einige ▄bersetzer eine
  351.      `.language' Datei mitgeliefert, damit ToolManager ihre
  352.      ▄bersetzungsdateien benutzen kann. Kopieren Sie die Datei fⁿr
  353.      Ihre Sprache in das Verzeichnis `LOCALE:Languages'. Es sind
  354.      folgende zusΣtzlichen Sprachen verfⁿgbar: Finnish (suomi),
  355.      Eefeler Platt (eifel).
  356.  
  357.  
  358. Das Prefs Verzeichnis
  359. ======================
  360.  
  361.    Der ToolManager Voreinsteller und sein Icon befinden sich in diesem
  362. Verzeichnis. Kopieren Sie beide Dateien in das Verzeichnis `SYS:Prefs'.
  363. Fⁿr weitere Informationen siehe Voreinstellungen.
  364.  
  365.  
  366. Das Programmers Verzeichnis
  367. ============================
  368.  
  369.    Dieses Verzeichnis enthΣlt alle Dateien, die von den verschiedenen
  370. Programmiersprachen und deren Compilern ben÷tigt werden, um die
  371. ToolManager shared library Schnittstelle zu benutzen. Das
  372. Unterverzeichnis `examples' enthΣlt mehrere Beispiele dazu. Fⁿr eine
  373. komplette Beschreibung der Schnittstelle lesen Sie bitte die Datei
  374. `Docs/toolmanager.doc'.
  375.  
  376.    Momentan werden die folgenden Sprachen bzw. Compiler unterstⁿtzt:
  377. AmigaOberon, DICE C, M2Amiga Modula, MANX Aztec C and SAS C.
  378.  
  379.  
  380. Das Scripts Verzeichnis
  381. ========================
  382.  
  383.    Dieses Verzeichnis enthΣlt eine Sammlung von ARexx- und
  384. Shell-Skripten, die in ToolManager Programmobjekten benutzt werden
  385. k÷nnen. Beachen Sie, da▀ diese Skriptdateien an Ihre pers÷nliche
  386. Arbeitsumgebung oder Shell angepasst werden mⁿssen.
  387.  
  388.  
  389. Das Source Verzeichnis
  390. =======================
  391.  
  392.    Dieses Verzeichnis enthΣlt den kompletten Quelltext zu ToolManager
  393. 2.0 und seinen Hilfsprogrammen. Jedes Programm hat sein eigenes
  394. Unterverzeichnis. Der Autor stellt den Quelltext als Beispiel fⁿr die
  395. Programmierung unter OS 2.0 zur Verfⁿgung.
  396.  
  397.    Das Unterverzeichnis `locale' ist fⁿr ▄bersetzer interessant.
  398. Falls Ihre Sprache in dieser Version nicht unterstⁿtzt wird und Sie
  399. eine ▄bersetzung machen m÷chten, dann sollten Sie sich die Datei
  400. `empty.ct' anschauen. Sie mⁿssen nur die Leerzeilen fⁿllen und die
  401. Datei zu mir senden. Die ▄bersetzung wird dann eventuell in der
  402. nΣchsten Version enthalten sein.
  403.  
  404.  
  405. Das WBStartup Verzeichnis
  406. ==========================
  407.  
  408.    Dieses Verzeichnis enthΣlt nur ein Programm: `ToolManager'. Dieses
  409. Hilfsprogramm startet und stoppt ToolManager 2.0. Meistens wird dieses
  410. Programm in das Verzeichnis `SYS:WBStartup' kopiert, aber man kann es
  411. auch von der Shell aus benutzen.
  412.  
  413.  
  414. Beschreibung der ToolManager-Objekte
  415. *************************************
  416.  
  417.    Dieses Kapitel beschreibt die ToolManager-Objekte im einzelnen.
  418. Jedes Objekt hat einen Typ und einen Namen. Der Name wird benutzt, um
  419. das Objekt anzusprechen. Es gibt sechs verschiedene Typen von Objekten:
  420.  
  421.  
  422. Programmobjekte
  423. ================
  424.  
  425.    Programmobjekte beschreiben Programme, die von ToolManager gestartet
  426. werden sollen. Es werden drei verschiedene Typen von Programmen
  427. unterstⁿtzt: CLI, Workbench und ARexx. Jedes Programmobjekt hat die
  428. folgenden Parameter. Die Vorgabewerte sind in Klammern gesetzt:
  429.  
  430. `Aktuelles Verzeichnis' (`SYS:')
  431.      Der Name des aktuellen Verzeichnisses fⁿr das Programm.
  432.      ARexx-Programme ignorieren diesen Parameter.
  433.  
  434. `Argumente' (Ja)
  435.      Dieser Schalter kontrolliert die Argumentⁿbergabe an das
  436.      Programm. Falls ein Programm keine Argumente annimmt oder sie
  437.      nicht ben÷tigt, dann k÷nnen Sie hiermit die Argumentⁿbergabe
  438.      abschalten.
  439.  
  440. `Ausgabedatei' (`NIL:')
  441.      Der Dateiname fⁿr die Ausgabedatei. Dieser Parameter ist nur
  442.      sinnvoll fⁿr CLI Programme.
  443.  
  444. `Befehl'
  445.      Der Dateiname fⁿr das zu startende Programm. Der Name kann
  446.      relativ zum aktuellen Verzeichnis sein.
  447.  
  448. `Befehlspfad' (Pfad des ToolManager-Prozesses)
  449.      Dieser Parameter setzt den Befehlspfad fⁿr das Programm. Es
  450.      k÷nnen mehrere Verzeichnisse angegeben werden in dem man sie mit
  451.      ";" trennt. Dieser Parameter ist nur sinnvoll fⁿr CLI Programme.
  452.  
  453. `Nach vorne' (Nein)
  454.      Wenn dieser Parameter gesetzt ist, dann wird der mit `╓ffentlicher
  455.      Schirm' angegebene ÷ffentliche Schirm nach vorne geholt, bevor
  456.      das Programm gestartet wird.
  457.  
  458. `╓ffentlicher Schirm' (Default)
  459.      Sie k÷nnen mit diesem Parameter angeben, welcher ÷ffentlicher
  460.      Schirm nach vorne geholt werden soll, bevor das Programm gestartet
  461.      wird. Dieser Parameter funktioniert nur im Zusammenhang mit `Nach
  462.      vorne'.
  463.  
  464. `PrioritΣt' (0)
  465.      Dieser Parameter setzt die PrioritΣt des neuen Prozesses, in dem
  466.      das Programm lΣuft.
  467.  
  468. `Programmtyp' (CLI)
  469.      Dies gibt den Typ des Programmes an. Es kann einer der drei
  470.      folgenden Typen angegeben werden: CLI, WB oder ARexx.
  471.  
  472. `Stack' (4096)
  473.      Dieser Parameter setzt die Stackgr÷▀e des neuen Prozesses, in
  474.      dem das Programm lΣuft.
  475.  
  476. `Tastenbefehl'
  477.      Sie k÷nnen fⁿr jedes Programmobjekt einen Tastenbefehl angeben.
  478.      Wenn Sie diesen Tastenbefehl benutzen wird das Programm gestartet.
  479.      Beachten Sie: Das Programm wird ohne Argumente gestartet.
  480.  
  481. `Verz÷gerung' (0)
  482.      Nach der Aktivierung eines Programmobjekts wartet ToolManager
  483.      `Verz÷gerung' Sekunden bevor er das Programm startet. Wenn dieser
  484.      Wert negativ ist, dann wird das Programm alle `Verz÷gerung'
  485.      Sekunden gestartet. Falls Sie ein Programmobjekt stoppen wollen,
  486.      das auf die Ausfⁿhrung wartet, aktivieren Sie es einfach noch
  487.      einmal. Beachten Sie: Wenn `Verz÷gerung' gesetzt ist, dann wird
  488.      das Programm ohne Argumente gestartet.
  489.  
  490.  
  491. Bildobjekte
  492. ============
  493.  
  494.    Bildobjekte geben die Bilddaten an, die von ToolManager fⁿr
  495. Piktogramme und Dock-Fenster benutzt werden. Dieser Objekttyp hat nur
  496. einen Parameter:
  497.  
  498. `Dateiname'
  499.      Dieser Parameter gibt den Namen der Datei an, aus der ToolManager
  500.      die Bilddaten lesen soll. ToolManager versucht den Typ der
  501.      Bilddaten automatisch zu erkennen:
  502.  
  503.        1. Er versucht die Daten als IFF Daten zu laden. Momentan kann
  504.           ToolManager ILBM (ein Bild) oder ANIM (zwei oder mehr Bilder)
  505.           Dateien lesen.
  506.  
  507.        2. Er versucht die Datei als Piktogrammdatei zu lesen. Ein
  508.           Piktogramm kann ein oder zwei Bilder enthalten.
  509.  
  510.    Animation werden momentan nur von Dock-Objekten unterstⁿtzt.
  511. Piktogrammobjekte entnehmen momentan nur das erste und das zweite Bild
  512. einer Animation um ein Piktogramm aus 2 Bildern zu erstellen. Wenn Sie
  513. eine Animation fⁿr ToolManager erstellen wollen, dann sollten Sie sich
  514. an folgende Regeln halten:
  515.  
  516. Bild 1
  517.      Dieses Bild sollte den inaktiven Zustand reprΣsentieren.
  518.  
  519. Bild 2
  520.      Dieses Bild sollte den selektierten Zustand reprΣsentieren.
  521.      Normalerweise ist es eine invertierte Kopie des ersten Bildes.
  522.  
  523. Bild 3 bis N-1
  524.      Dies sind die Bilder der eigentlichen Animation. Jedes Bild wird
  525.      fⁿr eine 1/3 Sekunde angezeigt.
  526.  
  527. Bild N
  528.      Das letzte Bild der Animation wird fⁿr eine Sekunde angezeigt.
  529.      Danach wird wieder das erste Bild angezeigt.
  530.  
  531.  
  532. Tonobjekte
  533. ===========
  534.  
  535.    Ein Tonobjekt wird benutzt, wenn ToolManager laut werden soll.
  536. ToolManager hat selber keinen eingebauten Spieler fⁿr digitalisierte
  537. GerΣusche. Er benutzt ARexx, um einen externen GerΣuscheabspieler
  538. anzusteuern. Dieser Objekttyp hat zwei Parameter:
  539.  
  540. `Befehl'
  541.      Dieser Parameter gibt den ARexx-Befehl an, den ToolManager an den
  542.      externen GerΣuscheabspieler senden soll. Fⁿr `upd' k÷nnte dies
  543.      etwas Σhnliches wie `file samples:boing' sein, was `upd' anweist
  544.      die IFF Datei `samples:boing' abzuspielen. Siehe Goodies.
  545.  
  546. `ARexx-Port'
  547.      Dieser Parameter gibt den Namen des ARexx-Ports an, an den
  548.      ToolManager `Befehl' senden soll. Der voreingestellte Name ist
  549.      `PLAY', der Name fⁿr das Programm `upd'.
  550.  
  551.  
  552. Menⁿobjekte
  553. ============
  554.  
  555.    Menⁿobjekte erzeugen MenⁿeintrΣge im Workbench Tools Menⁿ. Der
  556. Objektname wird benutzt als Menⁿtext. Um ein solches Objekt zu
  557. aktivieren mⁿssen Sie einfach den entsprechenden Menⁿeintrag
  558. selektieren. Menⁿobjekte sind nur verfⁿgbar wenn die Workbench lΣuft.
  559.  
  560.    Dieser Objekttyp hat zwei Parameter:
  561.  
  562. `Programmobjekt'
  563.      Dies ist der Name eines Programmobjektes, das aktiviert werden
  564.      soll, wenn der Menⁿeintrag selektiert wurde. Jedes Piktogramm,
  565.      das zu diesem Zeitpunkt ausgewΣhlt ist, wird als Argument fⁿr
  566.      das Programm benutzt.
  567.  
  568. `Tonobjekt'
  569.      Dies ist der Name eines Tonobjekts, das aktiviert werden soll,
  570.      wenn der Menⁿeintrag selektiert wurde.
  571.  
  572.    ToolManager 1.X Benutzer: Wenn Sie den alten Tooltyp "Dummy"
  573. simulieren wollen, dann erzeugen Sie einfach eine Menⁿobjekt und geben
  574. *kein* Programm- oder Tonobjekt an.
  575.  
  576.  
  577. Piktogrammobjekte
  578. ==================
  579.  
  580.    Piktogrammobjekte beschreiben Applikationspiktogramme im
  581. Workbench-Fenster. Solch ein Objekt kann aktiviert werden durch
  582. Doppelklicken des Piktogramms oder indem einige Piktogramme auf das
  583. Applikationspiktogramm geschoben werden. Piktogrammobjekte sind nur
  584. verfⁿgbar wenn die Workbench lΣuft.
  585.  
  586.    Die Parameter fⁿr diesen Objekttyp sind wie folgt:
  587.  
  588. `Bildobjekt'
  589.      Dies ist der Name eines Bildobjekts. Die Bilddaten dieses Objektes
  590.      werden dazu benutzt das Applikationspiktogramm zu erstellen.
  591.  
  592. `Linke Kante' (Vorgabe: 0)
  593.      Dies setzt die linke Kante fⁿr das Applikationspiktogramm.
  594.  
  595. `Obere Kante' (Vorgabe: 0)
  596.      Dies setzt die obere Kante fⁿr das Applikationspiktogramm.
  597.  
  598. `Programmobjekt'
  599.      Dies ist der Name eines Programmobjektes, das aktiviert werden
  600.      soll wenn das Piktogramm selektiert wurde. Jedes Piktogramm, das
  601.      auf das Applikationspiktogramm geschoben wurde, wird als Argument
  602.      fⁿr das Programm benutzt.
  603.  
  604. `Tonobjekt'
  605.      Dies ist der Name eines Tonobjekts, das aktiviert werden soll wenn
  606.      das Piktogramm selektiertiert wurde.
  607.  
  608. `Zeige Namen' (Vorgabe: Ja)
  609.      Wenn dieser Parameter gesetzt ist, dann wird der Objektname als
  610.      Namen fⁿr das Applikationspiktogramm benutzt.
  611.  
  612.    Die Workbench ist *sehr* eigensinnig mit Piktogrammpositionen. Wenn
  613. Sie eine Position gewΣhlt haben, die der Workbench nicht zusagen, dann
  614. ignoriert sie sie einfach und legt das Piktogramm irgendwo anders hin.
  615.  
  616.  
  617. Dock-Objekte
  618. =============
  619.  
  620.    Dock-Objekte beschreiben Fenster. Diese Fenster fassen mehrere
  621. Programme zusammen, welche durch Bilder oder Textgadgets reprΣsentiert
  622. werden. Um ein Programm zu starten, braucht man nur auf das Bild oder
  623. das Textgadget zu klicken. Natⁿrlich k÷nnen auch Piktogramme auf das
  624. Bild oder das Textgadget geschoben werden, um das Programm mit
  625. Argumenten zu versorgen.
  626.  
  627.    Jedes Dock-Objekt hat die folgenden Parameter. Die Vorgaben sind in
  628. Klammern gesetzt:
  629.  
  630. `Aktiviert' (Ja)
  631.      Ein Dock-Fenster kann aktiv (offen) oder nicht aktiv (geschlossen)
  632.      sein.
  633.  
  634. `Fensternamen'
  635.      Dieser Parameter setzt den Namen des Dock-Fensters. Wenn Sie einen
  636.      Fensternamen angeben, dann ÷ffnet sich eine normales OS 2.0
  637.      Fenster mit Dragbar, Close-Gadget, Depth-Gadget und einem Rand.
  638.      Wenn Sie *keinen* Namen angeben, dann ÷ffnet sich ein Fenster,
  639.      das keinen Rahmen und nur einen Dragbar hat.
  640.  
  641. `Linke Kante' (0)
  642.      Linke Kante des Dock-Fensters. Dieser Parameter wird ignoriert,
  643.      wenn der Parameter `Zentriert' gesetzt ist.
  644.  
  645. `Menⁿ' (No)
  646.      An jedes Dock-Fenster kann ein Menⁿ angehΣngt werden. Dieses
  647.      Menⁿ hat zwei EintrΣge:
  648.  
  649.         * `Dock schliessen' Schliessen des Dock-Fensters.
  650.  
  651.         * `TM beenden' ToolManager beenden.
  652.  
  653. `Muster' (Nein)
  654.      Das Dock-Fenster richtet sich automatisch nach der Gr÷sse des
  655.      gr÷▀ten Bildes. Da jeder Eintrag die gleiche Gr÷sse hat und
  656.      kleinere Bilder zentriert werden, haben kleinere Bilder einen
  657.      leeren Rand. Falls Sie diesen Rand nicht m÷gen, dann k÷nnen Sie
  658.      mit diesem Parameter ein Muster einschalten.
  659.  
  660. `Obere Kante' (0)
  661.      Obere Kante des Dock-Fensters. Dieser Parameter wird ignoriert,
  662.      wenn der Parameter `Zentriert' gesetzt ist.
  663.  
  664. `╓ffentlicher Schirm' (Default)
  665.      Dies gibt den ÷ffentlichen Schirm an, auf dem das Dock-Fenster
  666.      ge÷ffnet werden soll. Wenn das Fenster mit Hilfe des
  667.      Tastenbefehls ge÷ffnet wurde, dann wird der ÷ffentliche Schirm
  668.      nach vorne geholt. Dieser Parameter wird ignoriert, wenn der
  669.      Parameter `Vorderster' gesetzt ist.
  670.  
  671. `PopUp' (No)
  672.      Wenn dieser Parameter gesetzt ist, dann schliesst sich das
  673.      Dock-Fenster automatisch, nachdem ein Eintrag ausgewΣhlt wurde.
  674.      Dieser Parameter ist besonders nⁿtzlich in Verbindung mit den
  675.      Parametern `Vorderster', `Zentriert' und einem Tastenbefehl der
  676.      Klasse `rawmouse' (siehe Tastenbefehle).
  677.  
  678. `Spalte' (1)
  679.      Dieser Parameter setzt die Anzahl der Spalten in dem Dock-Fenster.
  680.      Die EintrΣge werden zeilenweise einsortiert, beginnend mit der
  681.      linken Spalte und fortlaufend bis zur rechten Spalte.
  682.  
  683. `Tastenbefehl'
  684.      Sie k÷nnen fⁿr jedes Dock-Objekt einen Tastenbefehl angeben.
  685.      Wenn Sie diesen Tastenbefehl benutzen, dann wird der Status des
  686.      Dock-Fensters umgeschaltet, d.h. es wird ge÷ffnet oder
  687.      geschlossen.
  688.  
  689. `Text' (Nein)
  690.      Mit diesem Parameter k÷nnen Sie zwischen Bildern und Textgadgets
  691.      in Dock-Fenstern wΣhlen. Dock-Fenster mit Textgadgets sind
  692.      besonders nⁿtzlich in Verbindung mit dem Parameter `PopUp'.
  693.  
  694. `Vertikal' (No)
  695.      Dieser Parameter setzt die Richtung der Dragbar. Dieser Parameter
  696.      wird ignoriert, wenn Sie einen Fensternamen mit dem Parameter
  697.      `Fensternamen' angegeben haben.
  698.  
  699. `Vorderster' (Nein)
  700.      Wenn dieser Parameter gesetzt ist, dann ÷ffnet sich das
  701.      Dock-Fenster immer auf dem vordersten ÷ffentlichen Schirm.
  702.  
  703. `Zeichensatz' (Zeichensatz des Schirms)
  704.      Wenn in einem Dock-Objekt der Parameter `Text' gesetzt ist, dann
  705.      kann mit diesem Parameter der Zeichensatz fⁿr die Textgadgets
  706.      gewΣhlt werden.
  707.  
  708. `Zentriert' (Nein)
  709.      Wenn dieser Parameter gesetzt ist, dann wird das Dock-Fenster
  710.      immer zentriert zur aktuellen Mausposition ge÷ffnet.
  711.  
  712.  
  713. Der Voreinsteller fⁿr ToolManager
  714. **********************************
  715.  
  716.    Mit dem Voreinsteller k÷nnen Sie die globale Konfiguration von 
  717. ToolManager manipulieren. Diese Konfiguration wird automatisch beim
  718. Start von ToolManager geladen. Um den Voreinsteller zu starten, mⁿssen
  719. Sie sein Piktogramm doppelklicken. Danach ÷ffnet sich das Hauptfenster.
  720.  
  721.  
  722. Gadgets im Hauptfenster
  723. ========================
  724.  
  725.    Das Hauptfenster hat mehrere Gruppen von Gadgets:
  726.  
  727. Objekttyp
  728.      Mit diesem zyklischem Auswahlgadget kann der Typ der Objekte
  729.      gewΣhlt werden, die Sie erzeugen oder Σndern wollen.
  730.  
  731. Objektliste
  732.      Dieses Gadget zeigt die Liste aller Objekte des aktuellen Typs an.
  733.      Sie k÷nnen ein Objekt auswΣhlen indem sie auf seinen Namen
  734.      klicken. Wenn sie einen Eintrag doppelklicken, dann ÷ffnet sich
  735.      das Objektfenster.
  736.  
  737. Objekt verschieben
  738.      Wenn ein Objekt ausgewΣhlt worden ist, dann kann es mit diesen
  739.      Gadgets in der Liste verschoben werden. Das `Sortieren' Gadget
  740.      dient dazu, die Liste alphabetisch zu sortieren.
  741.  
  742. Objekt manipulieren
  743.      Diese Gadgets manipulieren Objekte. Das `Neu' Gadget erzeugt ein
  744.      neues Gadget vom aktuellen Typ. Dieses neue Objekt wird
  745.      automatisch selektiert. Das `─ndern' Gadget ÷ffnet das
  746.      Objektfenster. Mit dem `Kopieren' Gadget kann man eine Kopie des
  747.      selektierten Objektes erstellen. Das `Entfernen' Gadget l÷scht
  748.      das selektierte Objekt.
  749.  
  750. Konfiguration
  751.      Sie haben mehrere M÷glichkeiten die Konfiguration zu speichern.
  752.      Mit dem `Speichern' Gadget wird die Konfiguration permanent in der
  753.      Datei `ENVARC:ToolManager.prefs' gespeichert. Fⁿr eine temporΣre
  754.      ─nderung kann die Konfiguration mit dem `Benutzen' Gadget in der
  755.      Datei `ENV:ToolManager.prefs' abgespeichert werden. Diese Datei
  756.      wird bei einem Reset gel÷scht. Wenn Sie eine Konfiguration testen
  757.      wollen, ohne den Voreinsteller zu verlassen, dann benutzen Sie das
  758.      `Testen' Gadget. Mit dem `Abbrechen' Gadget k÷nnen Sie den
  759.      Voreinsteller ohne Abspeichern verlassen.
  760.  
  761.  
  762. Menⁿs des Hauptfensters
  763. ========================
  764.  
  765.    Das Hauptfenster hat mehrere Menⁿs:
  766.  
  767. `Project'
  768.      Mit den MenⁿeintrΣgen `÷ffnen' und `speichern als' k÷nnen Sie
  769.      die Konfiguration laden und speichern. Der `Information' Eintrag
  770.      ÷ffnet einen Informationsrequester. Mit dem Eintrag `beenden' kann
  771.      man den Voreinsteller ohne Abspeichern verlassen.
  772.  
  773. `Vorgaben'
  774.      Mit diesen MenⁿeintrΣgen k÷nnen Σltere Konfigurationen
  775.      wiederhergestellt werden. Der Eintrag `auf zuletzt gespeichertes'
  776.      lΣdt die Konfiguration aus der Datei `ENVARC:ToolManager.prefs'.
  777.      Mit dem Eintrag `auf vorherigen Stand' wird diejenige
  778.      Konfiguration, die vor dem Start des Voreinstellers gⁿltig war,
  779.      aus der Datei `ENV:ToolManager.prefs' geladen.
  780.  
  781. `Optionen'
  782.      Mit dem Eintrag `Piktogramme erzeugen?' k÷nnen Sie vorgeben, ob
  783.      der Eintrag `speichern als' ein Piktogramm erzeugen soll oder
  784.      nicht.
  785.  
  786.  
  787. Objektfenster
  788. ==============
  789.  
  790.    Jeder Objekttyp hat ein eigenes Objektfenster, in dem man die
  791. Objektparameter setzen kann. Fⁿr eine detailierte Liste aller
  792. Parameter siehe Objekte.
  793.  
  794.    Jedes Objektfenster hat ein Gadget fⁿr den Objektnamen. Dieser Name
  795. ist wichtig, da er dazu benutzt wird das Objekt anzusprechen. Beachten
  796. Sie, da▀ es keine Querverweise gibt, d.h. wenn Sie den Namen eines
  797. Objektes Σndern, das schon von einem anderen Objekt verwendet wird, so
  798. wird der Verweis in diesem Objekt *nicht* aktualisiert. Sie mⁿssen
  799. diesen Verweis per Hand aktualisieren.
  800.  
  801.    Die Tastengadgets in den Objektfenstern ÷ffnen verschiedene
  802. Requester. Sie k÷nnen einen Eintrag auswΣhlen, indem sie den Namen
  803. und das `Benutzen' Gadget anklicken oder indem sie den Namen
  804. doppelklicken. Um einen Requester ohne ─nderungen zu verlassen,
  805. benutzen Sie das `Abbrechen' Gadget. Wenn sie ein Feld l÷schen wollen,
  806. das nur mit einem Requester ausgewΣhlt werden kann, dann ÷ffnen Sie
  807. den Requester und klicken das `Benutzen' Gadget *ohne* vorher einen
  808. Eintrag auszuwΣhlen.
  809.  
  810.    Die Objekfenster fⁿr Programm- und Bildobjekte haben ein
  811. zusΣtzliches Merkmal. Sie k÷nnen ein Piktogramm auf diese Fenster
  812. schieben und die Parameter werden aus diesem Piktogramm entnommen.
  813.  
  814.  
  815. Tooltypes
  816. ==========
  817.  
  818.    Wenn Sie den Voreinsteller von der Workbench starten, dann k÷nnen
  819. Sie in den Piktogrammen fⁿr das Programm oder den
  820. Konfigurationsdateien verschiedene Tooltypes setzen, um den
  821. Voreinsteller zu kontrollieren.
  822.  
  823. `USE'
  824.      Wenn Sie diesen Tooltype in einem Piktogramm fⁿr eine
  825.      Konfigurationsdatei setzen, dann installiert der Voreinsteller
  826.      diese Datei als aktuelle Konfiguration.
  827.  
  828. `SAVE'
  829.      Wenn Sie diesen Tooltype in einem Piktogramm fⁿr eine
  830.      Konfigurationsdatei setzen, dann installiert der Voreinsteller
  831.      diese Datei als aktuelle und permanente Konfiguration.
  832.  
  833. `PUBSCREEN'
  834.      Dieser Tooltype gibt den Namen des ÷ffentlichen Schirms an, auf
  835.      dem der Voreinsteller seine Fenster ÷ffnen soll.
  836.  
  837. `CREATEICONS'
  838.      Wenn dieser Tooltype auf `YES' gesetzt wird, dann erzeugt der
  839.      Voreinsteller fⁿr jede Konfigurationsdatei, die mit dem
  840.      Menⁿeintrag `speichern als' erzeugt wird, ein Piktogramm.
  841.  
  842. `DEFAULTFONT'
  843.      Normalerweise benutzt der Voreinsteller den Zeichensatz des
  844.      ÷ffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen
  845.      Tooltype auf `YES' setzen, dann benutzt der Voreinsteller den
  846.      Standard Systemzeichensatz.
  847.  
  848.  
  849. CLI Argumente
  850. ==============
  851.  
  852.    Wenn der Voreinsteller von der Shell gestartet wird, dann benutzt er
  853. folgende Schablone fⁿr die Kommandozeile:
  854.  
  855.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S
  856.  
  857. `FROM'
  858.      Dieser Parameter gibt an, welche Konfigurationsdatei der
  859.      Voreinsteller laden soll.
  860.  
  861. `USE'
  862.      Wenn Sie diesen Parameter benutzen, dann installiert der
  863.      Voreinsteller die Datei, die mit dem `FROM' Parameter angegeben
  864.      wurde, als aktuelle Konfiguration.
  865.  
  866. `SAVE'
  867.      Wenn Sie diesen Parameter benutzen, dann installiert der
  868.      Voreinsteller die Datei, die mit dem `FROM' Parameter angegeben
  869.      wurde, als aktuelle und permante Konfiguration.
  870.  
  871. `PUBSCREEN'
  872.      Dieser Parameter gibt den Namen des ÷ffentlichen Schirms an, auf
  873.      dem der Voreinsteller seine Fenster ÷ffnen soll.
  874.  
  875. `DEFAULTFONT'
  876.      Normalerweise benutzt der Voreinsteller den Zeichensatz des
  877.      ÷ffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen
  878.      Parameter angeben, dann benutzt der Voreinsteller den Standard
  879.      Systemzeichensatz.
  880.  
  881.  
  882. Die ToolManager shared library Schnittstelle
  883. *********************************************
  884.  
  885.    Der ToolManager-Handler ist in eine Amiga shared library
  886. eingebettet. Diese Library bietet mehrere Funktionen an, um
  887. ToolManager-Objekte zu erzeugen und zu manipulieren, so da▀ Sie sie
  888. von Ihren Programmen aus benutzen k÷nnen.
  889.  
  890.    Momentan sind 6 Funktionen vorhanden:
  891.  
  892. `AllocTMHandle()'
  893.      Damit Sie ToolManager-Objekte erzeugen k÷nnen, mⁿssen Sie zuerst
  894.      einen TMHandle allozieren. Diese Datenstruktur speichert alle
  895.      Informationen ⁿber Ihre Objekte und sie wird dazu benutzt Ihre
  896.      Objekte anzusprechen. Beachten Sie, da▀ die Information, die in
  897.      dieser Datenstruktur gespeichert ist, *nur* dem Programm
  898.      zugΣnglich ist, das den TMHandle erzeugt hat.
  899.  
  900. `FreeTMHandle()'
  901.      Diese Funktion gibt einen TMHandle und alle mit ihm verbundenen
  902.      ToolManager-Objekte frei. Jeder `AllocTMHandle()' Aufruf mu▀ mit
  903.      einem `FreeTMHandle()' Aufruf gepaart sein!
  904.  
  905. `CreateTMObjectTags()'
  906. `CreateTMObjectTagList()'
  907.      Diese Funktion erzeugt ein ToolManager-Objekt. Sie mⁿssen einen
  908.      Namen, den Objekttyp und verschiedene Tags fⁿr die
  909.      Objektparameter angeben. Der Name des Objekts ist wichtig, da er
  910.      dazu benutzt wird, das Objekt anzusprechen.
  911.  
  912. `ChangeTMObjectTags()'
  913. `ChangeTMObjectTagList()'
  914.      Sie k÷nnen die Parameter eines ToolManager-Objekts mit dieser
  915.      Funktion verΣndern. Beachten Sie, da▀ Bildobjekte momentan nicht
  916.      geΣndert werden k÷nnen.
  917.  
  918. `DeleteTMObject()'
  919.      Diese Funktion l÷scht ein ToolManager-Objekt. Falls andere
  920.      Objekte auf dieses Objekt verweisen, dann werden diese
  921.      benachrichtigt, damit sie ihren Status erneuern k÷nen.
  922.  
  923. `QuitToolManager()'
  924.      Diese Funktion teilt dem ToolManager-Handler mit, da▀ er so bald
  925.      wie m÷glich stoppen sollte.
  926.  
  927.    Die komplette Library Schnittstellenbeschreibung ist im
  928. AutoDoc-Format vorhanden (siehe Docs).
  929.  
  930.  
  931. Wie man einen Tastenbefehl definiert
  932. *************************************
  933.  
  934.    Diese Kapitel beschreibt wie man einen Tastenbefehl als einen Input
  935. Description String definiert, der dann von Commodities ausgewertet
  936. werden kann. Jedes Mal, wenn ein Tastenbefehl ausgefⁿhrt wird, erzeugt
  937. Commodities eine Ereignis, das dann von ToolManager dazu benutzt wird
  938. Programmobjekte zu aktivieren oder Dock-Objekte umzuschalten. Ein
  939. Description String hat die folgende Syntax:
  940.  
  941.      [<Klasse>] {[-][<Qualifier>]} [-][upstroke] [<Tastenkode>]
  942.  
  943.    Alle Befehlsworte k÷nnen gro▀ oder klein geschrieben werden.
  944.  
  945.    `Klasse' beschreibt die InputEvent-Klasse. Dieser Parameter ist
  946. optional und falls er weggelassen wird, dann wird die Vorgabe `rawkey'
  947. benutzt. Siehe InputEvent-Klassen.
  948.  
  949.    Qualifier sind "Signale", die gesetzt oder nicht gesetzt sein
  950. mⁿssen zu dem Zeitpunkt, an dem der Tastenbefehl ausgefⁿhrt wird,
  951. sonst wird kein Ereignis erzeugt. Fⁿr jeden Qualifier, der gesetzt
  952. sein soll, mⁿssen Sie das Befehlswort angeben. Alle anderen Qualifier
  953. mⁿssen dann nicht gesetzt sein. Falls Sie einen Qualifier ignorieren
  954. wollen, dann setzen sie ein `-' vor sein Befehlswort. Siehe Qualifier.
  955.  
  956.    Normalerweise wird ein Ereignis erzeugt, wenn eine Taste gedrⁿckt
  957. wird. Falls das Ereignis generiert werden soll wenn die Taste
  958. losgelassen wird, dann mⁿssen Sie das Befehlswort `upstroke' angeben.
  959. Wenn sowohl beim Drⁿcken als auch beim Loslassen der Taste ein
  960. Ereignis erzeugt werden soll, dann mⁿssen sie das Befehlswort
  961. `-upstroke' angeben.
  962.  
  963.    Der Tastenkode ist abhΣngig von der InputEvent-Klasse. Siehe
  964. Tastenkodes.
  965.  
  966.    Achtung: WΣhlen Sie ihre Tastenbefehle *sorgfΣltig*, denn
  967. Commodities hat eine hohe PrioritΣt in der InputEvent-Handlerkette,
  968. d.h. vorgegebene Definitionen werden ⁿbergangen.
  969.  
  970.  
  971. InputEvent-Klassen
  972. ===================
  973.  
  974.    Commodities unterstⁿtzt die meisten der InputEvent-Klassen, die von
  975. dem input.device erzeugt werden. Diese Sektion beschreibt die Klassen,
  976. die nⁿtzlich fⁿr ToolManager sind.
  977.  
  978. `rawkey'
  979.      Dies ist die vorgegebene Klasse. Sie beschreibt alle Ereignisse,
  980.      die durch die Tastatur erzeugt werden k÷nnen. Zum Beispiel
  981.      erzeugt `rawkey a' oder `a' jedesmal ein Ereignis, wenn die Taste
  982.      "a" gedrⁿckt wird. Sie mⁿssen einen Tastenkode fⁿr diese Klasse
  983.      angeben. Siehe rawkey Tastenkodes.
  984.  
  985. `rawmouse'
  986.      Diese Klasse beschreibt alle Ereignisse, die durch die Maus
  987.      erzeugt werden k÷nnen. Sie mⁿssen einen Tastenkode fⁿr diese
  988.      Klasse angeben. Siehe rawmouse Tastenkodes.
  989.  
  990. `diskinserted'
  991.      Ereignisse dieser Klasse werden generiert, wenn eine Diskette in
  992.      ein Laufwerk gelegt wird. Diese Klasse besitzt keine Tastenkodes.
  993.  
  994. `diskremoved'
  995.      Ereignisse dieser Klasse werden generiert, wenn eine Diskette aus
  996.      einem Laufwerk genommen wird. Diese Klasse besitzt keine
  997.      Tastenkodes.
  998.  
  999.  
  1000. Qualifier
  1001. ==========
  1002.  
  1003.    Einige Befehlsworte wurden erst bei Commodities V38 eingefⁿhrt.
  1004. Diese sind mit einem `*' markiert.
  1005.  
  1006. `lshift', `left_shift' *
  1007.      Linke Shift-Taste.
  1008.  
  1009. `rshift', `right_shift' *
  1010.      Rechte Shift-Taste.
  1011.  
  1012. `shift'
  1013.      Irgendeine Shift-Taste.
  1014.  
  1015. `capslock', `caps_lock' *
  1016.      Caps-Lock-Taste.
  1017.  
  1018. `caps'
  1019.      Irgendeine Shift-Taste oder die Caps-Lock-Taste.
  1020.  
  1021. `control', `ctrl' *
  1022.      Control-Taste.
  1023.  
  1024. `lalt', `left_alt' *
  1025.      Linke Alt-Taste.
  1026.  
  1027. `ralt', `right_alt' *
  1028.      Rechte Alt-Taste.
  1029.  
  1030. `alt'
  1031.      Irgendeine Alt-Taste.
  1032.  
  1033. `lcommand', `lamiga' *, `left_amiga' *, `left_command' *
  1034.      Linke Amiga-/Kommando-Taste.
  1035.  
  1036. `rcommand', `ramiga' *, `right_amiga' *, `right_command' *
  1037.      Rechte Amiga-/Kommando-Taste.
  1038.  
  1039. `numericpad', `numpad' *, `num_pad' *, `numeric_pad' *
  1040.      Dieses Befehlswort *mu▀* angegeben werden, wenn eine Taste von der
  1041.      Zehnertastatur benutzt wird.
  1042.  
  1043. `leftbutton', `lbutton' *, `left_button' *
  1044.      Linke Maustaste. Siehe unten.
  1045.  
  1046. `midbutton', `mbutton' *, `middlebutton' *, `middle_button' *
  1047.      Mittlere Maustaste. Siehe unten.
  1048.  
  1049. `rbutton', `rightbutton' *, `right_button' *
  1050.      Rechte Maustaste. Siehe unten.
  1051.  
  1052. `repeat'
  1053.      Dieser Qualifier ist gesetzt, wenn die Tastenwiederholung aktiv
  1054.      ist. Dies ist nur sinnvoll fⁿr die InputEvent-Klasse `rawkey'.
  1055.  
  1056.    Achtung: Commodities V37 hat einen Fehler, der die Benutzung von
  1057. `leftbutton', `midbutton' und `rbutton' als Qualifier verhindert.
  1058. Dieser Fehler wurde in V38 behoben.
  1059.  
  1060.  
  1061. Tastenkodes
  1062. ============
  1063.  
  1064.    Jede InputEvent-Klasse besitzt ihre eigenen Tastenkodes:
  1065.  
  1066.  
  1067. Tastenkodes fⁿr die InputEvent-Klasse `rawkey'
  1068. -----------------------------------------------
  1069.  
  1070.    Einige Befehlsworte wurden erst bei Commodities V38 eingefⁿhrt.
  1071. Diese sind mit einem `*' markiert.
  1072.  
  1073. `a'-`z', `0'-`9', ...
  1074.      ASCII-Zeichen.
  1075.  
  1076. `f1', `f2', ..., `f10', `f11' *, `f12' *
  1077.      Funktionstasten.
  1078.  
  1079. `up', `cursor_up' *, `down', `cursor_down' *
  1080. `left', `cursor_left' *, `right', `cursor_right' *
  1081.      Cursor-Tasten.
  1082.  
  1083. `esc', `escape' *, `backspace', `del', `help'
  1084. `tab', `comma', `return', `space', `spacebar' *
  1085.      Spezial-Tasten.
  1086.  
  1087. `enter', `insert' *, `delete' *
  1088. `page_up' *, `page_down' *, `home' *, `end' *
  1089.      Tasten der Zehnertastatur. Jeder dieser Tastenkodes *mu▀* mit dem
  1090.      Qualifier `numericpad' benutzt werden!
  1091.  
  1092.  
  1093. Tastenkodes fⁿr die InputEvent-Klasse `rawmouse'
  1094. -------------------------------------------------
  1095.  
  1096.    Diese Befehlsworte wurden erst bei Commodities V38 eingefⁿhrt. Sie
  1097. sind nicht verfⁿgbar in V37.
  1098.  
  1099. `mouse_leftpress'
  1100.      Drⁿcke die linke Maustaste.
  1101.  
  1102. `mouse_middlepress'
  1103.      Drⁿcke die mittlere Maustaste.
  1104.  
  1105. `mouse_rightpress'
  1106.      Drⁿcke die rechte Maustaste.
  1107.  
  1108.    Achtung: Um einen dieser Tastenkodes zu benutzen, mⁿssen sie auch
  1109. das entsprechende Qualifier-Befehlswort angeben, z.B.
  1110.  
  1111.      rawmouse leftbutton mouse_leftpress
  1112.  
  1113.  
  1114. Beispiele fⁿr Tastenbefehle
  1115. ============================
  1116.  
  1117. `ralt t'
  1118.      Rechte Alt-Taste festhalten und "t" drⁿcken.
  1119.  
  1120. `ralt lalt t'
  1121.      Rechte *und* linke Alt-Taste festhalten und "t" drⁿcken.
  1122.  
  1123. `alt t'
  1124.      Irgendeine Alt-Taste festhalten und "t" drⁿcken.
  1125.  
  1126. `rcommand f2'
  1127.      Rechte Amiga-Taste festhalten und die zweite Funktionstaste
  1128.      drⁿcken.
  1129.  
  1130. `numericpad enter'
  1131.      Enter-Taste auf der Zehnertastatur drⁿcken.
  1132.  
  1133. `rawmouse midbutton leftbutton mouse_leftpress'
  1134.      Mittlere Maustaste festhalten und die linke Maustaste drⁿcken.
  1135.  
  1136. `diskinserted'
  1137.      Eine Diskette in ein Laufwerk einlegen.
  1138.  
  1139.  
  1140. Die Entwicklung von ToolManager
  1141. ********************************
  1142.  
  1143. 2.0, Datum 26.09.1992
  1144.         - Komplett neues Konzept (objektorientiert)
  1145.  
  1146.         - (Fast) komplette Neuprogrammierung
  1147.  
  1148.         - ToolManager ist nun in zwei Teile aufgespalten
  1149.  
  1150.         - Der Handler ist in eine shared Library eingebettet
  1151.  
  1152.         - Die Konfiguration wird nun mit einem Voreinsteller bearbeitet
  1153.  
  1154.         - Das Konfigurationsdateiformat wurde wieder geΣndert :-) Es
  1155.           ist nun eine IFF Datei und liegt in ENV:
  1156.  
  1157.         - Mehrere Docks und Docks mit mehrere Spalten sind nun m÷glich
  1158.  
  1159.         - Es gibt Docks mit neuem Aussehen
  1160.  
  1161.         - Docks richten sich nun automatisch nach der Gr÷▀e des
  1162.           gr÷▀ten Bildes
  1163.  
  1164.         - Sound Unterstⁿtzung
  1165.  
  1166.         - ARexx werden direkt in Programmobjekten unterstⁿtzt
  1167.  
  1168.         - ToolManager kann nun ohne Workbench benutzt werden. Wenn die
  1169.           Workbench nicht lΣuft, dann benutzt er keine App* Merkmale
  1170.           mehr.
  1171.  
  1172.         - Locale Unterstⁿtzung
  1173.  
  1174.         - Der Befehlspfad der Workbench wird fⁿr CLI Programme benutzt
  1175.  
  1176.         - Ein eigener Prozess startet die WB Programme
  1177.  
  1178. 1.0 bis 1.5
  1179.      Die Bemerkungen zu diesen Versionen entnehmen Sie bitte der
  1180.      englischen Dokumentation.
  1181.  
  1182.  
  1183. Der Autor m÷chte danken...
  1184. ***************************
  1185.  
  1186.    ToolManager hat mehrere gro▀e Entwicklungsphasen seit seiner ersten
  1187. Programmierung Mitte 1990 durchlebt. Diese Entwicklung wΣre unm÷glich
  1188. gewesen, wenn ich nicht den enormen Feedback von einigen ToolManager
  1189. Benutzern gehabt hΣtte. Viele Ideen & Merkmale stammen aus dieser
  1190. Quelle...
  1191.  
  1192.    Daher m÷chte ich den folgenden Personen danken:
  1193.  
  1194. Fⁿr die Alpha-/Beta-Tests, Ideen & Bug Reports:
  1195.      Die Amigagruppe unseres Computerclubs (Computerclub an der RWTH
  1196.      Aachen), Olaf 'Olsen' Barthel, Georg Hessmann (Gucky), Markus
  1197.      Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias
  1198.      Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda),
  1199.      Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler
  1200.      (stargazer) und viele andere...
  1201.  
  1202. Matthew Dillon
  1203.      Ohne dein *exzellentes* C Entwicklungssystem DICE und verschiedener
  1204.      anderer Hilfsprogramme wⁿrde es keinen ToolManager geben!
  1205.  
  1206. Fⁿr ihre hervorragenden Grafiken:
  1207.      Andreas Harrenberg, Georg Hessmann, Michael "Mick" Hohmann, Markus
  1208.      Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan
  1209.      Peter, Matthias Scheler, Brian Wright
  1210.  
  1211. Fⁿr die ▄bersetzungen:
  1212.      Tomi Blinnikka (Finnisch), Dr. Peter Kittel (Deutsch), Klaus
  1213.      Melchior (Eifel Platt), Rickard Olsson (Schwedisch), Marc Schaefer
  1214.      (Franz÷sisch & Italienisch)
  1215.  
  1216. Alle Leute in West Chester:
  1217.      Fⁿr die Entwicklung des Amigas und seines hervorragenden
  1218.      Betriebssystems.
  1219.  
  1220. Alle Benutzer, die mir Geld geschickt haben:
  1221.      Ich habe in den 1.X Versionen nicht danach gefragt, aber es ist
  1222.      erfreulich, wenn jemand meine Arbeit so sehr schΣtzt.
  1223.  
  1224. Alle Benutzer, die mir einen Brief geschickt haben:
  1225.      Ich habe es genossen, Eure Briefe zu lesen!
  1226.  
  1227. und natⁿrlich alle, die ich vergessen habe zu erwΣhnen...
  1228.  
  1229. Index
  1230. ******
  1231.  
  1232.  
  1233.  
  1234.  ▄bersetzer                            Source
  1235.  ▄bersetzungen                         Locale
  1236.  TeX                                    Docs
  1237.  ARexx-Skripte                          Scripts
  1238.  ASCII Dokumentation                    Docs
  1239.  Adresse                                Adresse des Autors
  1240.  AmigaGuide                             Docs
  1241.  Beispielbilder                         Graphics
  1242.  Beispiele fⁿr Tastenbefehle           Beispiele fⁿr Tastenbefehle
  1243.  Bildobjekte                            Bild
  1244.  Bug reports                            Adresse des Autors
  1245.  Catalog-Dateien                        Locale
  1246.  Compilerunterstⁿtzung                 Programmers
  1247.  Copyright                              Copyright
  1248.  Danksagungen                           Danksagungen
  1249.  DeleteTool                             Goodies
  1250.  Diskinserted                           InputEvent-Klassen
  1251.  Diskremoved                            InputEvent-Klassen
  1252.  Distribution                           Copyright
  1253.  Distributionsdateien                   Distributionsdateien
  1254.  Dock-Objekte                           Dock
  1255.  Docs Verzeichnis                       Docs
  1256.  Dokumentation                          Docs
  1257.  E-Mail                                 Adresse des Autors
  1258.  Einfⁿhrung zu den ToolManager-ObjektenKonzepte
  1259.  Einfⁿhrung zum ToolManager            Einfⁿhrung
  1260.  Gedruckte Dokumentation                Docs
  1261.  Genehmigungen                          Copyright
  1262.  Geschichte                             Geschichte
  1263.  GetPubName                             Goodies
  1264.  GiftWare                               Wichtig
  1265.  Goodies Verzeichnis                    Goodies
  1266.  Graphics Verzeichnis                   Graphics
  1267.  InputEvent-Klassen                     InputEvent-Klassen
  1268.  Installation (schnell)                 Schnellinstallation
  1269.  InterNet Adresse                       Adresse des Autors
  1270.  Kommentare                             Adresse des Autors
  1271.  Konfiguration                          Voreinstellungen
  1272.  Konzepte                               Konzepte
  1273.  L Verzeichnis                          L
  1274.  Library Dokumentation                  Docs
  1275.  Library Schnittstelle                  Library
  1276.  Libs Verzeichnis                       Libs
  1277.  List: Qualifier                        Qualifier
  1278.  Liste: rawkey Tastenkodes              rawkey Tastenkodes
  1279.  Liste: rawmouse Tastenkodes            rawmouse Tastenkodes
  1280.  Locale Verzeichnis                     Locale
  1281.  Lokalisation                           Locale
  1282.  Menⁿobjekte                           Menⁿ
  1283.  Objekte                                Objekte
  1284.  Piktogrammobjekte                      Piktogramm
  1285.  Postadresse                            Adresse des Autors
  1286.  Prefs Verzeichnis                      Prefs
  1287.  Programmers Verzeichnis                Programmers
  1288.  Programmkonzepte                       Konzepte
  1289.  Programmobjekte                        Programm
  1290.  Programmversionen                      Geschichte
  1291.  Qualifier                              Qualifier
  1292.  Quelltext                              Source
  1293.  Rawkey                                 InputEvent-Klassen
  1294.  Rawmouse                               InputEvent-Klassen
  1295.  Rechtliche Dinge                       Copyright
  1296.  Referenz: Distributionsdateien         Distributionsdateien
  1297.  Referenz: Library Schnittstelle        Library
  1298.  Referenz: Tastenbefehle                Tastenbefehle
  1299.  Referenz: ToolManager-Objekte          Objekte
  1300.  Referenz: Voreinsteller                Voreinstellungen
  1301.  Schnellinstallation                    Schnellinstallation
  1302.  Scripts Verzeichnis                    Scripts
  1303.  Shell-Skripte                          Scripts
  1304.  Source Verzeichnis                     Source
  1305.  Spenden                                Adresse des Autors
  1306.  Sprachdateien                          Locale
  1307.  Sprachen                               Locale
  1308.  Tastenbefehle                          Tastenbefehle
  1309.  Tastenkodes fⁿr rawkey                rawkey Tastenkodes
  1310.  Tastenkodes fⁿr rawmouse              rawmouse Tastenkodes
  1311.  Texinfo                                Docs
  1312.  Tonobjekte                             Ton
  1313.  ToolManager-Objekte                    Objekte
  1314.  UPD                                    Goodies
  1315.  V38 Merkmale                           Wichtig
  1316.  Verbote                                Copyright
  1317.  Versionen                              Geschichte
  1318.  Voreinsteller                          Voreinstellungen
  1319.  WBStart 1.2                            L
  1320.  WBStart-Handler                        L
  1321.  WBStartup Verzeichnis                  WBStartup
  1322.  Wichtige Bemerkungen                   Wichtig
  1323.  
  1324.