home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d825 / wcomm.lha / WComm / German / WComm.dok < prev    next >
Text File  |  2001-02-25  |  70KB  |  1,913 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 Dokumentation
  6.  
  7.                              WComm Version 1.80
  8.  
  9.                WComm das Fenster-Manipulations-Kommodity für den Amiga
  10.  
  11.  
  12. Index:
  13.  
  14.         Was ist WComm
  15.         System Vorraussetzungen
  16.         Rechtliches
  17.         Installation und Start
  18.         CLI-Start
  19.         WBench-Start
  20.         HotKeys
  21.         Liste der Funktionen
  22.         Allgemein
  23.         OS 2.04 Gadgets
  24.         Das Haupt Fenster
  25.         Das Ausschluß Fenster
  26.         Das Voreinsteller Fenster
  27.         Das Uhren Fenster
  28.         Das Nachrichten Fenster
  29.         Das Paletten Fenster
  30.         Die Uhr
  31.         Fehlerbehandlung
  32.         Technisches
  33.         Liste der Dateien
  34.         Adresse
  35.  
  36. Was ist WComm:
  37.  
  38.     WComm ist ein Standard-Kommodity, daß es dem Benutzer ermöglicht,
  39.     43 Fenstermanipulationsfunktionen mittels Hotkey (Tastatur-Macro)
  40.     vorzunehmen.
  41.     Fenster lassen sich
  42.  
  43.         verschieben,
  44.         vergrößern,
  45.         verkleinern,
  46.         auf bestimmte Voreinstellungen setzen,
  47.         zurücksetzen,
  48.         schließen,
  49.         zoomen,
  50.         teilen,
  51.         nach vorne oder hinten bringen,
  52.         kaskadieren,
  53.         Bildschirme und Fenster lassen sich durchblättern.
  54.  
  55.     WComm besitzt außerdem die Möglichkeit den Benutzer auf bestimmte Ereig-
  56.     nisse oder Termine aufmerksam zu machen. Dazu kann der Benutzer Daten
  57.     im Nachrichtenfenster eingeben, wenn das eingestellte Datum und/oder die
  58.     eingestellte Uhrzeit erreicht ist, öffnet WComm einen Reqüster mit der
  59.     entsprechenden Nachricht und/oder startet ein Programm (EXECUTE,RUN oder
  60.     AREXX).
  61.  
  62.     WComm bensitzt auch eine kompfortable Uhr mit verschiedenen Datums- und
  63.     Uhrenanzeigetypen. Sie besitzt eine Alarmfunktion und ist fast vollkommen
  64.     benutzerdefinierbar (Breite, Position, Anzeigeart).
  65.  
  66.     WComm kann Fenster von bestimmten Funktionen ausschließen oder nur be-
  67.     stimmte Fenster zulassen.
  68.  
  69.     WComm kann Voreinstellungswerte für jedes Fenster verwalten und mit einem
  70.     Tastaturkommando auf diese Werte (Position, Größe) setzen.
  71.  
  72.     WComm hat ein Palettenfenster, mit dem die WBenchfarben auf einfache Art
  73.     geändert werden können.
  74.  
  75.     Jedes Tastaturkommando (Hotkey) kann nach den Wünschen des Benutzers abge-
  76.     ändert werden.
  77.  
  78.     WComm gibt es in einer englischen (WComm) und einer deutschen (WComm_G)
  79.     Version.
  80.  
  81.     WComm kann mittels Hotkey eine Shell öffnen.
  82.  
  83.     WComm kann "Fensterleichen" schließen (vom System vergeßene Fenster).
  84.  
  85.     WComm ist ein Kommodity und voll durch Exchange kontrollierbar.
  86.  
  87.     WComm ist absolut Zeichensatzunabhängig. Es paßt alle Fenster und Gadgets
  88.     dem gerade aktuellen Zeichensatz an. Auch die Kaskadierungs- und Verschiebe-
  89.     funktionen benutzen die Höhe der Fenster Titelleisten als Vorgabewert.
  90.  
  91.     Man sieht WComm kann eine Menge. Da erstaunt auch die Größe von ~80 kb
  92.     nicht. Aber man kann durch die Benutzung von WComm eine Reihe anderer
  93.     Programme ersetzen, so z.B.
  94.  
  95.             IntuiHelp etc,
  96.             Uhrenprogramme,
  97.             Kronographenprogramme,
  98.             Palettenprogramme,
  99.             Tiler- Kaskadierungsprogramme,
  100.             Fensterkiller etc..
  101.  
  102.  
  103.     WComm hat eine komplette Gadtoolsbenutzeroberfläche und ermöglicht so alle
  104.     Funktionen auf den entsprechenden Fenstern mittels Maus- oder Tastaturbe-
  105.     dienung.
  106.  
  107.     Alle Fenster und Funktionen sind asyncron, d.h. die Veränderungen wirken
  108.     sich sofort, auch bei geöffneten Fenstern, aus.
  109.  
  110.     WComm wird durch verschiedene Konfigurationsdateien gesteürt.
  111.     Für jeden Teilbereich existiert eine andere Konfigurationsdatei. So wird für
  112.     die Ausschlußliste, für die Voreinstellungsliste und für die Nachrichtenliste
  113.     jeweils eine andere Datei verwendet.
  114.  
  115.     Alle Dateien besitzen zwei voreingestellte Namen, so daß der Benutzer nicht
  116.     das Problem mit nicht zu findenden Datei bekommt.
  117.  
  118.     Außerdem besitzt WComm noch eine Konfigurationsdatei, in der die Tastaurmakros
  119.     (Hotkeys), die Fensterpositionen, die Uhrenvoreinstellungen usw. abgespeichert
  120.     sind.
  121.  
  122.     WComm kann aber auch ohne jede Konfigurationsdatei gestartet und betrieben
  123.     werden. Hierbei wird WComm den Benutzer auf die fehlenden Dateien aufmerksam
  124.     machen.
  125.  
  126.     Alle Konfigurationsdateien können auf den entsprechenden Fenstern abgeändert,
  127.     editiert, neu geladen und abgespeichert werden.
  128.  
  129.     Um auch hier den Kompfort so hoch wie möglich zu halten, können die meisten
  130.     Konfigurationsdateien auch mit einem Texteditor editiert werden. Siehe nähere
  131.     Informationen bei den entsprechenden Absätzen.
  132.  
  133.     Alle HotKeys können einzeln und unabhängig voneinander abgeändert und
  134.     danach wieder abgespeichert werden, indem man das Hauptfenster benutzt.
  135.     Der voreingestellte HotKey für das Öffnen des Hauptfensters ist
  136.     `Control o`. Dieser HotKey kann natürlich auch später abgeändert werden.
  137.  
  138.     Weiteres:
  139.  
  140.     WComm unterstützt schon einige Eigenschaften von OS 3.0. Dabei kann es aber
  141.     selbst unterscheiden, ob es auf einem System mit OS 2.xx oder 3.0 läuft.
  142.  
  143.     Das Palettenfenster z.B. kann bis zu 256 Farben verwalten und anzeigen.
  144.  
  145.     Das Erscheinugsbild der Fenster unterscheidet sich unter OS 3.0 und 2.xx
  146.     in einigen Punkten:
  147.  
  148.     Das PalettenGadget hat keinen Indikator der aktuellen Farbe, die aktuelle
  149.     Farbe wird hier invertiert dargestellt.
  150.  
  151.     Die ListviewGadgets zeigen kein TextGadget, das den aktuellen Eintrag dar-
  152.     stellt, an, sondern der aktuelle Eintrag wird invertiert dargestellt.
  153.  
  154.  
  155. System Vorraussetzungen:
  156.  
  157.     Da WComm ein Standardkommodity ist, benötigt es mindestens OS 2.04.
  158.     Es wurde unter 2.04 und 3.0 getestet und läuft einwandfrei unter
  159.     beiden Betriebssystemversionen.
  160.  
  161.     Der Speicherverbrauch ist sehr abhängig von der Größe der Listen,
  162.     die WComm für die verschiedenen Funktionen benötigt. Speichermangel
  163.     sollte bei Amigas mit >= 1 MByte Memory nicht auftreten.
  164.     Um dennoch Speicher zu sparen, kann man Elemente, wie z.B. Nachrichten
  165.     melden oder Auschlußlistenfunktionen inaktivieren. Auch können Hotkeys,
  166.     die inaktiviert werden, einige Bytes an Speicher einsparen, da für jedes
  167.     aktivierte Hotkey eine zusätzliche Struktur vom System angefordert und
  168.     verwaltet werden muß.
  169.  
  170.     WComm verwaltet seinen Speicher dynamisch, d.h. Speicher wird nur dann
  171.     angefordert, wenn er benötigt wird. Er wird sofort zurückgegeben, wenn
  172.     der Speicher nicht mehr benötigt wird.
  173.  
  174. Rechtliches:
  175.  
  176.         Ich habe mich entschlossen dieses Programm und alle beigefügten
  177.         Dateien und Scripts, sowie aller Anleitungen, als FREEWARE   zu
  178.         deklarieren.
  179.  
  180.         D.h.:
  181.  
  182.             Jeder kann WComm benutzen.
  183.             Jeder darf WComm weitergeben, wenn:
  184.  
  185.                 1. Alle unten aufgeführten Programme mit  weitergegeben
  186.                    werden,
  187.  
  188.                 2. Keinerlei Veränderungen der unten aufgeführten  Pro-
  189.                    grammen (am Ende der Anleitung)  vorgenommen wurden,
  190.  
  191.                 3. Bei  Nachkompilierungen  der QüllCodes muß ein Hin-
  192.                    weis  auf  den  Orginalprogrammierer beigefügt sein,
  193.                    bei  Herausgabe  dieser,  muß  eine  Kopie  an  mich
  194.                    gesandt werden.
  195.  
  196.                 4. WComm darf nicht verkauft werden.
  197.  
  198.                        Außnahme: Es darf eine geringe  Kopiergebühr er-
  199.                                  hoben werden, die aber  5 DM  bzw. den
  200.                                  entsprechenden  Gegenwert  in  anderen
  201.                                  Währungen nicht übersteigt.
  202.  
  203.                 5. WComm  darf  nur als Teil eines kommerziellen Produktes
  204.                    herausgegeben  werden,  mit ausdrücklicher schrift-
  205.                    licher Genehmigung des Autors (Adresse siehe unten).
  206.  
  207.                 Zuwiderhandlungen  der  oben  Aufgeführten  Konditionen
  208.                 werden Zivilrechtlich verfolgt.
  209.  
  210.  
  211.         Ferner  wird  für  die Funktion des Programmes ,sowie möglicher
  212.         Folgen  der  Benutzung  des Programmes sowie der u. a. Dateien,
  213.         keinerlei Gewährleistung übernommen.
  214.  
  215.         !!! Alle Risiken trägt der Benutzer allein !!!
  216.  
  217.  
  218.  
  219. Installation und Start:
  220.  
  221.         Installation:
  222.  
  223.         Die Installation geht sehr einfach von statten. Zunächst einmal
  224.         müssen alle Konfigurationsdateien, die von WComm benötigt werden,
  225.         in das ENVARC: - Verzeichnis kopiert werden.
  226.  
  227.         1_> Copy #?.prefs ENVARC:
  228.  
  229.         Danach müssen sich im ENVARC: folgende Konfiguratiosdateien be-
  230.         finden:
  231.  
  232.                 XWindow.prefs,
  233.                 ZWindow.prefs
  234.                 WComm.prefs
  235.                 Notify.prefs
  236.  
  237.         Will man die entsprechenden Icons ebenfalls kopieren:
  238.  
  239.         1_> Copy #?.prefs.info ENVARC:
  240.  
  241.         Nun stellt sich die Frage, ob man WComm ständig oder nur gele-
  242.         gentlich benutzen möchte. Auch ist es ein Unterschied, ob man
  243.         WComm von der WBench oder vom CLI aus starten möchte.
  244.  
  245.         Will man WComm ständig benutzen, kann man einfach das Icon von
  246.         WComm (WComm_G) in das WBStartup-Verzeichnis der WBench ziehen.
  247.         (Siehe auch Kapitel über WBench-Start).
  248.  
  249.         Alternativ kann auch eine Zeile in die User-Startup-Datei ein-
  250.         fügen:
  251.  
  252.                 Run <Pfad>WComm_G >NIL: <NIL:
  253.  
  254.         WComm unterstützt auch eine Kommandozeielenargumente, die man beim
  255.         Start mitangeben kann. (Siehe Kapitel CLI-Start).
  256.  
  257.         Will man WComm nur gelegentlich benutzen, kann man es einfach mit dem
  258.         Icon in das Commodities -Verzeichnis ziehen oder mit
  259.  
  260.             1._> Copy WComm_G C:
  261.  
  262.         in das C:-Verzeichnis kopieren.
  263.  
  264.         Start:
  265.  
  266.         Da WComm ein Standardkommodity ist, wird es beim zweiten Aufruf au-
  267.         tomatisch beendet.
  268.  
  269.         Ist WComm gestartet worden bleibt es im Hintergrund und wartet
  270.         auf ankommende Nachrichten. In dieser Zeit wird keinerlei CPU-Zeit
  271.         verbaucht, außer der Zeit für das Setzen der WBenchtiteluhr.
  272.  
  273.         WComm kann auch mit dem Exchange-Kommodity kontrolliert werden. Will
  274.         man das Hauptfenster von WComm öffnen und hat den Hotkey dafür ver-
  275.         gessen, kann man dies auch von Exchange aus. Ebenfalls läßt sich WComm
  276.         von Exchange aus Aktivieren, Inaktivieren und Beenden.
  277.  
  278. CLI-Start:
  279.  
  280.         Wird WComm vom CLI aus gestartet werden folgende Kommandozeilenargumente
  281.         mit folgender Schablone (Syntax) unterstützt:
  282.  
  283.         WComm [Config][CX_POPUP=P/S][WPrefs=W/K][EPrefs=E/K][CX_Priority=C/K/N]
  284.               [Notify=N/K]
  285.  
  286.         Config
  287.  
  288.             Wird Config gefolgt mit dem Namen einer Konfigurationsdatei angege-
  289.             ben, versucht WComm diese Datei zu laden. Wird Config nicht angege-
  290.             ben, wird versucht, die voreingestellte Konfigurationsdatei zu la-
  291.             den. Diese befindet sich im ENV: Verzeichnis und heißt WComm.prefs.
  292.             Ist sie dort nicht zu finden versucht WComm diese Datei aus dem
  293.             ENVARC:-Verzeichnis zu lesen. Kann auch sie nicht geladen werden,
  294.             zeigt WComm eine entsprechende Fehlernachricht an, und ermöglicht
  295.             dem Benutzer das Programm abzubrechen oder mit den voreingestellten
  296.             Werten fortzusetzen.
  297.  
  298.             Diese Konfigurationsdatei besteht aus binären Daten und kann deshalb
  299.             nicht mit einem Texteditor abgeändert werden. Bitte nicht versuchen,
  300.             sonst riskiert man einen Systemabsturz !
  301.  
  302.  
  303.         CX_POPUP
  304.  
  305.             Dies ist ein Schalter. Wird CX_POPUP angegeben, öffnet WComm das
  306.             Hauptfenster beim Start.
  307.             Voreinstellung: Hauptfenster nicht öffnen.
  308.  
  309.         WPrefs
  310.  
  311.             Wird WPrefs gefolgt von dem Namen einer Fensterlistendatei ange-
  312.             geben, so versucht WComm dies zu laden. Wird WPrefs nicht ange-
  313.             geben so sucht WComm diese Datei im ENV: - Verzeichis mit dem
  314.             Namen `ZWindow.prefs`. Kann WComm sie nicht finden, sucht er im
  315.             ENVARC:-Verzeichnis.
  316.  
  317.             Die Fensterlistendatei enthält Voreinstellungen von Fenstern,
  318.             mit deren Hilfe WComm diese Fenster auf diese Werte setzen kann.
  319.             Siehe auch Kapitel Voreinsteller Fenster.
  320.  
  321.             Diese Datei besteht aus reinen ASCII-Daten und kann so auch mit
  322.             jedem Texteditor editiert werden. Dabei muß man das korrekte
  323.             Format der Datei beachten.
  324.  
  325.             Die Daten müssen folgender Synatx entsprechen:
  326.  
  327.             Jede Zeile antspricht einer Fenstervoreinstellung,
  328.  
  329.             der Titel darf keine Leerzeichen beinhalten,
  330.  
  331.             AmigaDos Suchmuster sind im Titel erlaubt und werden voll unter-
  332.             stützt,
  333.  
  334.             Zwischen den Angaben muß ein Leerzeichen stehen.
  335.  
  336.             Kommentare sind nicht erlaubt.
  337.  
  338.             Syntax: <Fenstername> <X> <Y> <W> <H>
  339.  
  340.             Fenstername:    Der Name mit oder ohne AmigaDOS Suchmustern.
  341.  
  342.             Die Benutzung von Suchmustern ermöglicht eine Erkennung von
  343.             Fenstertiteln, die sich mit der Zeit verändern. So z.B. ver-
  344.             ändert sich die Titelzeile eines WBenchfensters, wenn man
  345.             etwas hinainkopiert oder löscht.
  346.             Beispiel:
  347.                         RAM#?
  348.                                 erkennt
  349.  
  350.                         Ram Disk 100% voll 0 % frei ...
  351.                         RAMDISK ...
  352.                         RaMDisK ...
  353.  
  354.             Es wird also auch keine Unterscheidung zwischen Groß- und
  355.             Kleinschreibung vorgenommen.
  356.  
  357.             X:              Die linke Position des Fensters.
  358.             Y:              Die obere Position des Fensters.
  359.             W:              Die Breite des Fensters.
  360.             H:              Die Höhe des Fensters.
  361.  
  362.  
  363.             Die in dieser Datei stehenden Werte können mit der Funktion
  364.             `Setze nach Preferences` (siehe Liste der Funktionen) abge-
  365.             rufen werden. Entspricht das aktuelle Fenster dann dem Titel-
  366.             muster, wird versucht das Fenster auf die angegebe Position
  367.             zu verschieben und die Größe auf die angegebenen Werte zu än-
  368.             dern.
  369.  
  370.             Verschoben werden allerdings nur Fenster mit einer DragBar,
  371.             und Vergrößert bzw. Verkleinert werden nur Fenster mit einem
  372.             SizeGadget.
  373.  
  374.             Mit dieser Datei kann man also für jedes Fenster eine andere
  375.             Voreinstellung abspeichern.
  376.  
  377.             Es ist hiermit auch möglich eine Übergruppe zu definieren.
  378.             Wenn man einige Fenstertitel mit den gleichen ersten Buchstaben
  379.             hat, und jedes eine andere Voreinstellung benutzen soll, z.B.:
  380.  
  381.             man hat `Shell1`, `Shell2` und `Shell`, kann man einen
  382.             Eintrag in die Datei mit Shell1 Shell2 und Shell#? eingeben.
  383.             Öffnet man ein Fenster, daß z.B. Shell4 heißt, benutzt es
  384.             die Voreinstellung von Shell#?, während die Shell1 die Werte
  385.             für Shell1 benutzt.
  386.  
  387.  
  388.         EPrefs
  389.  
  390.             Wird EPrefs gefolgt von dem Namen einer Ausschlußdatei angegeben,
  391.             versucht WComm dies Ausschlußdatei zu laden. Schlägt dies fehl, ver-
  392.             sucht WComm die Datei `XWindow.prefs` im ENV:-Verzeichnis zu laden.
  393.             Kann auch sie nicht gefunden werden, sucht WComm sie im ENVARC:-
  394.             Verzeichnis.
  395.  
  396.             Die Fenster, die in dieser Datei angegeben sind, werden  von einigen
  397.             Funktionen ausgeschlossen. So kann z.B. ein Uhrenfenster von der
  398.             Kaskadierung, dem Vor- und Zurückblättern usw. ausgeschlossen werden.
  399.  
  400.             Auch diese Datei besteht aus reinen ASCII-Daten und kann mit einem
  401.             Editor abgeändert werden. Natürlich kann sie auch von dem Ausschluß
  402.             Fenster aus abgespeichert werden.
  403.  
  404.             Dabei muß folgendes Format benutzt werden:
  405.             (Siehe Kapitel `Liste der Funktionen` und `Auschluß Fenster`)
  406.  
  407.             Syntax:  <Fenster Titel>
  408.  
  409.             In jeder Zeile steht ein Fenstertitel. Er darf keine Leerzeichen ent-
  410.             halten, aber AmigaDOS Suchmuster.
  411.  
  412.  
  413.         CX_Priority
  414.  
  415.  
  416.             Die hinter CX_Priority angegebene Zahl, entspricht der Kommodity-Priorität,
  417.             die WComm benutzen soll. Voreingestellt ist 0. Läuft ein anderes Kommodity
  418.             gleichzeitig, einen gleichen Hotkey benutzt, bekommt nur das Kommodity mit
  419.             der höcherenn Priorität, die Nachricht. Das mit der geringeren Priorität
  420.             bleibt weiter im Hintergrund.
  421.  
  422.             Man sollte keine Prioritäten über 5 oder unter -5 benutzen.
  423.  
  424.  
  425.         Notify
  426.  
  427.             Wird Notify gefolgt von dem Namen einer Nachrichtendatei angegeben,
  428.             versucht WComm dies nachrichtendatei zu laden. Schlägt dies fehl, ver-
  429.             sucht WComm die Datei `Notify.prefs` im ENV:-Verzeichnis zu laden.
  430.             Kann auch sie nicht gefunden werden, sucht WComm sie im ENVARC:-
  431.             Verzeichnis.
  432.  
  433.             Diese Nachrichtendatei enthält alle Daten der Nachrichten, auf die
  434.             WComm den Benutzer aufmerksam machen soll.
  435.  
  436.             Diese Datei besteht aus reinen ASCII-Daten und kann auch von einem Editor
  437.             aus abgeändert werden. Das Format ist allerdings so kompliziert, daß ich
  438.             in dieser Version von WComm, den Benutzer raten möchte, dies beqüm vom
  439.             Nachrichten Fenster aus vorzunehmen.
  440.  
  441.             Aus diesem Grund werde ich auch die Synatx nicht bekanntgeben.
  442.  
  443.             Für Profis, die dies aber dennoch möchten:
  444.  
  445.             Schreibt an meine Adreese und schickt mir eine Leerdiskette und einen
  446.             frankierten und an sich selbst adressierten Rückumschlag und ich sende
  447.             euch  die neuste Version von WComm zusammen mit der Syntaxbeschreibung
  448.             zu.
  449.  
  450.  
  451. WBench-Start:
  452.  
  453.     Wenn man WComm von der WBench aus starten will, kann man anstelle der
  454.     Cli-Argumente auch ToolTypes benutzen. Die folgenden ToolTypes werden
  455.     von WComm unterstützt.
  456.  
  457.                CONFIG
  458.                CX_POPUP
  459.                WPREFS
  460.                EPREFS
  461.                CX_PRIORITY
  462.                NOTIFY
  463.  
  464.     Die Bedeutung der Argumente ist dieselbe, wie die, der Cli-Argumente.
  465.     Allerdings muß man beachten, daß sie alle `großgeschrieben` werden
  466.     müssen oder ansonsten einfach ignoriert werden.
  467.  
  468.     Die Systax: (Die <>`s bitte nicht eingeben)
  469.  
  470.                 CONFIG=<Name der Konfigurationsdatei>
  471.  
  472.                 CX_POPUP=<YES|NO>
  473.  
  474.                     Man kann hier nur YES oder NO angeben.
  475.  
  476.                 WPREFS=<Name der Fensterlistendatei>
  477.  
  478.                 EPREFS=<Name der Ausschlußdatei>
  479.  
  480.                 CX_PRIORITY=<#> # Muß eine Nummer sein.
  481.  
  482.                 NOTIFY=<Name der Nachrichtendatei>
  483.  
  484.     Das System erkennt und benutzt auch noch folgende ToolTypes:
  485.  
  486.  
  487.                TOOLPRI=<#> Das ist die Priorität, die die WBench dem
  488.                            aufgerufenen Programm zuteilt. Bitte nicht
  489.                            mit der Commodity-Priorität verwechseln.
  490.  
  491.                CLI         Dieses ToolType hat keiee weiteren Angaben.
  492.                            Ist CLI angegeben öffnet die WBench sein
  493.                            `command execute` Fenster und ermöglicht so
  494.                            eine Eingabe von CLI-Argumenten. Dann startet
  495.                            die WBench das Program als CLI-Programm.
  496.  
  497.                DONOTWAIT   Dieses ToolType muß beim automatischen Start
  498.                            vom WBStartup Verzeichnis aus angegeben werden.
  499.                            Dies ist ähnlich dem CLI-Kommando Run und er-
  500.                            möglicht so ein starten des Programmes im
  501.                            Hintergrund. Wird dieses Argument nicht ange-
  502.                            geben, wartet die WBench auf die Beendigung
  503.                            des Programmes, bevor die Startup weitergeführt
  504.                            wird.
  505.  
  506.  
  507. HotKeys:
  508.  
  509.     Die schon erwähnten Hotkeys müssen bestimmten Konventionen folgen.
  510.     Jedes Hotkey besteht aus einem Qualifier und einem KeyCode.
  511.  
  512.     Qualifier sind Tasten, wie Shift, Alt Control etc.
  513.     KeyCodes sind alle anderen Tasten.
  514.  
  515.     Ein Hotkey kann auch nur aus einem KeyCode bestehen, aber nicht aus
  516.     nur einem Qualifier.
  517.  
  518.     Für jede Funktion des Programmes muß eine andere HotKey-Kombination
  519.     benutzt werden.
  520.  
  521.     Es folgt nun eine Liste möglicher Hotkeys:
  522.  
  523.     Mögliche Qualifier sind:
  524.  
  525.         lshift              : Linke Shift
  526.         rshift              : Rechte Shift
  527.         shift               : Irgendeine Shift
  528.         lalt                : Linke Alt
  529.         ralt                : Rechte Alt
  530.         alt                 : Irgendeine Alt
  531.         lcommand            : Linke Amiga (Commodore)
  532.         rcommand            : Rechte Amiga (Vorsicht bei Konflikten mit Menü-
  533.                                             shortcuts)
  534.         command             : Irgendeine Amiga
  535.         control             : Control Taste
  536.  
  537.         lbutton             : drücken der linken Maustaste
  538.         rbutton             : drücken der rechten Maustaste
  539.         midbutton           : drücken der mittleren Maustaste (falls man
  540.                               eine Maus mit 3 Tasten besitzen sollte)
  541.         diskinserted        : Diskette einlegen
  542.         diskremove          : Diskette herausnehmen
  543.  
  544.     Mögliche Keycodes sind:
  545.  
  546.         a,b ... z           : jede alphanumerische
  547.         0,1 ... 9           :  Taste
  548.         üäö?                : auch Umlaute
  549.         +-.,*/|\?...        : oder jedes andere  Zeichen
  550.         f1,f2 ... f10       : Die Funktions-Tasten
  551.         space               : Leer Taste
  552.         backspace           : Backspace Taste
  553.         up,down,left,right  : Die Pfeiltasten
  554.         esc                 : Die Escape Taste
  555.         del                 : Die Delete Taste
  556.         numericpad          : Achtung: Es gibt eienen Unterschied
  557.                             : zwischen Tasten auf der normalen Tastatur
  558.                             : und den Tasten auf dem Numerischen Ziffern-
  559.                             : block. Soll eine Taste des Ziffernblobks
  560.                             : angegeben werden, muß man `numericpad #`
  561.                             : eingeben, wobei # eine Taste des Ziffern-
  562.                             : blocks sein muß. Z.B. `numericpad 8` ist
  563.                             : nur die Taste `8` des Ziffernblocks und
  564.                             : nicht die Taste `8` der normalen Tastatur.
  565.         return              : Die Return Taste
  566.         esc                 : Die Escape Taste
  567.  
  568.     Beispiele:
  569.  
  570.  
  571.         shift control lbutton
  572.  
  573.         Wird die Shift- zusammen mit der Control- Taste gedrückt und dann
  574.         die linke Maustaste betätigt.
  575.  
  576.         f10
  577.  
  578.         Die Funktionstaste f10.
  579.  
  580.         ralt numericpad 9
  581.  
  582.         Die rechte Alt-Taste mit der 9 des Ziffernblocks.
  583.  
  584.  
  585.  
  586. Liste der Funktionen:
  587.  
  588.     Hier folgt nun eine Liste aller Funktionen von WComm und deren
  589.     voreingestellten HotKeys. Bei jeder neün Version von WComm wird
  590.     diese Liste erweitert.
  591.  
  592.     Wie das Hauptfenster funktioniert, wird später noch erklärt.
  593.  
  594.     Einige Funktionen z.B. die Kaskadierungsfunktionen benutzen einen
  595.     vertikalen und horizontalen Wert für ihre Bewegunsfunktonen.
  596.     Die Werte hängen aber vom gerade benutzten Zeichensatz der WBench ab.
  597.     Da ich nicht weiß welcher Font gerade benutzt wird, spreche ich bei
  598.     diesen Werten von Linker bzw. Oberer Offset.
  599.  
  600.  
  601.     POPUP: (Voreingestellt: `control o`)
  602.  
  603.         Dieser Hotkey öffnet das Haupt Fenster von WComm.
  604.         Auf diesem Fenster kan man alle Hotkeys editieren, aktivieren und
  605.         deaktivieren.
  606.         Die Konfiguarionsdatei kann abgespeichert weren und eine neü ge-
  607.         laden werden.
  608.  
  609.         Dieses Fenster öffnet sich auch, wenn man das Exchange-Programm
  610.         zum Anzeigen von WComm benutzt.
  611.  
  612.  
  613.     ENDE: (Voreingestellt: `control q`)
  614.  
  615.         Dieser HotKey beendet WComm sofort ohne Nachfrage usw.
  616.         Ob dies funktioniert hat, kann man mit dem Exchange Programm
  617.         kontrollieren.
  618.  
  619.     Schließe Fenster: (Voreingestellt: `control esc`)
  620.  
  621.         Dieser HotKey versucht das momentan aktive Fenster zu schließen,
  622.         indem es dem Fenster einen InputEvent mit CLOSEWINDOW flag sendet.
  623.  
  624.         Dies funktioniert natürlich nur bei einem Fenster, mit Schließ-
  625.         Gadget.
  626.  
  627.     Maximal Fenster: (Voreingestellt: `control f1`)
  628.  
  629.         Dies vergrößert ein Fenster zu seinem Maximum, daß in der Fenster-
  630.         struktur in den MaxWidth und MaxHeight Variablen definiert ist.
  631.         Dies funktioniert natürlich nur bei Fenster, die ein SizeGadget
  632.         haben.
  633.  
  634.     Minimal Fenster: (Voreingestellt: `control f2`)
  635.  
  636.         Dies verkleinert ein Fenster zu seinem Minimum, daß in der Fenster-
  637.         struktur in den MinWidth und MinHeight Variablen definiert ist.
  638.         Geht nur bei Fenstern mit SizeGadget.
  639.  
  640.     Zurücksetzen: (Voreingestellt: `control f3`)
  641.  
  642.         Wenn WComm zum Ersten mal irgendetwas an einem Fenster ändert,
  643.         speichert WComm seine Ursprungswerte. Mit dieser Funktion wird
  644.         der ursprüngliche Platz und die ursprüngliche Größe eines manipu-
  645.         lierten Fensters wiederhergestellt.
  646.         Dies funktioniert nur bei Fenstern, die schon mit WComm geändert
  647.         wurden.
  648.  
  649.     Zoom Window: (Voreingestellt: `control f5`)
  650.  
  651.         Zoomen eines Fensters. Dies ist dasselbe, als wenn man auf das
  652.         ZipGadget (Links neben dem DepthGadget) klickt. Die System Zip-
  653.         Funktion speichert den Wert vor dem `Zippen`. Bei einem erneuten
  654.         `Zippen`, befindet sich das Fenster wieder auf dem Platz und mit
  655.         der gleichen Größe, wie vor dem ersten `Zippen`.
  656.  
  657.     Verkleinere Breite: (Voreingestellt: shift alt left`)
  658.  
  659.         Dies verkleinert das Fenster horizontal. D.H. die Breite des Fenster
  660.         wird um Linker Offset kleiner.
  661.  
  662.     Verkleinere Höhe: (Voreingestellt: shift alt up`)
  663.  
  664.         Dies verkleinert das Fenster vertikal. D.h. die Höhe des Fenster wird
  665.         um Oberer Offset verkleinert.
  666.  
  667.     Verkleinere Beides: (Voreingestellt: shift alt backspace`)
  668.  
  669.         Die Breite wird um Linker Offset und die Höhe um Oberer Offset
  670.         verkleinert.
  671.  
  672.     Vergrößere Breite: (Voreingestellt: shift alt right`)
  673.  
  674.         Die Breite des Fenster wird um Linker Offset vergrößert.
  675.  
  676.     Vergrößere Höhe: (Voreingestellt: shift alt down`)
  677.  
  678.         Dies vergrößert die Höhe des Fenster um Oberer Offset.
  679.  
  680.     Vergrößere Beides: (Voreingestellt: shift alt space`)
  681.  
  682.         Dies vergrößert die Breite des Fensters um Linker Offset und die
  683.         Höhe um Oberer Offset.
  684.  
  685.     Bewegen zu links oben: (Voreingestellt: `lalt numericpad 7`)
  686.  
  687.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  688.         schirmbreite und -höhe und platziert es in der linken oberen Ecke
  689.         des Bildschirms.
  690.  
  691.     Bewegen zu rechts oben: (Voreingestellt: `lalt numericpad 9`)
  692.  
  693.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  694.         schirmbreite und -höhe und platziert es in der rechten oberen Ecke
  695.         des Bildschirms.
  696.  
  697.     Bewegen zu links unten: (Voreingestellt: `lalt numericpad 1`)
  698.  
  699.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  700.         schirmbreite und -höhe und platziert es in der linken unteren Ecke
  701.         des Bildschirms.
  702.  
  703.     Bewegen zu rechts unten: (Voreingestellt: `lalt numericpad 3`)
  704.  
  705.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  706.         schirmbreite und -höhe und platziert es in der rechten unteren Ecke
  707.         des Bildschirms.
  708.  
  709.     Bewegen zum Zentrum: (Voreingestellt: `lalt numericpad 5`)
  710.  
  711.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  712.         schirmbreite und -höhe und platziert es in der Mitte des Bild-
  713.         schirms.
  714.  
  715.     Bewegen zum linken Zentrum: (Voreingestellt: `lalt numericpad 4`)
  716.  
  717.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  718.         schirmbreite und -höhe und platziert es an dem linken Rand des
  719.         Bildschirms vertikal zentriert.
  720.  
  721.     Bewegen zum rechten Zentrum: (Voreingestellt: `lalt numericpad 6`)
  722.  
  723.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  724.         schirmbreite und -höhe und platziert es an dem rechten Rand des
  725.         Bildschirms vertikal zentriert.
  726.  
  727.     Bewegen zum oberen Zentrum: (Voreingestellt: `lalt numericpad 8`)
  728.  
  729.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  730.         schirmbreite und -höhe und platziert es an dem oberen Rand des
  731.         Bildschirms horizontal zentriert.
  732.  
  733.     Bewegen zun unteren Zentrum: (Voreingestellt: `lalt numericpad 4`)
  734.  
  735.         Dies vergrößert/verkleinert das Fenster auf die Hälfte der Bild-
  736.         schirmbreite und -höhe und platziert es an dem unteren Rand des
  737.         Bildschirms horizontal zentriert.
  738.  
  739.     Bewegen nach oben: (Voreingestellt: `shift control up`)
  740.  
  741.         Dies schiebt das Fenster um Oberer Offset nach oben.
  742.  
  743.     Bewegen nach links: (Voreingestellt: `shift control left`)
  744.  
  745.         Dies schiebt das Fenster um Linker Offset nach links.
  746.  
  747.     Bewegen nach rechts: (Voreingestellt: `shift control right`)
  748.  
  749.         Dies schiebt das Fenster um Linker Offset nach rechts.
  750.  
  751.     Bewegen nach unten: (Voreingestellt: `shift control down`)
  752.  
  753.         Dies schiebt das Fenster um Oberer Offset nach unten.
  754.  
  755.     Setze nach Preferences: (Voreingestellt: `control f4`)
  756.  
  757.         Dies setzt ein Fenster zu den in der Voreinstellerdatei angegeben
  758.         Werten zurück. Findet WComm keinen entsprechenden Eintrag in
  759.         dieser Datei, passiert nichts.
  760.  
  761.     Vergrößere bis rechts: (Voreingestellt: `control f6`)
  762.  
  763.         Dies vergrössert die Breite des Fenster bis zur rechten Bildschirm-
  764.         grenze.
  765.  
  766.     Vergrößere bis unten: (Voreingestellt: `shift control f6`)
  767.  
  768.         Dies vergrössert die Höhe des Fenster bis zur unteren Bildschirm-
  769.         grenze.
  770.  
  771.     Vergrößere zu Grenzen: (Voreingestellt: `control f7`)
  772.  
  773.         Dies vergrössert die Breite des Fenster bis zur rechten Bildschirm-
  774.         grenze und die Höhe zur unteren Bildschirmgrenze.
  775.  
  776.     Fenster aufteilen (Tiling): (Voreingestellt: `control f8`)
  777.  
  778.         Wenn man diese Funktion aufruft, versucht WComm alle Fenster des
  779.         aktuellen Bildschirms so zu verschieben, dass es keine Überlappungs-
  780.         zonen der Fenster mehr gibt.
  781.         Z.B. hat man 4 Shell Fenster auf dem WBench Screen, werden die Fenster
  782.         auf die Hälfte der Breite und Höhe des Screens vergrössert/verkleinert
  783.         und dann in die vier Ecken des Bildschirms verschoben. Hat man stattdessen
  784.         8 Fenster werden sie auf ein Viertel der Breite und Höhe gebracht. Die
  785.         Positionen werden entsprechend angepasst.
  786.         Diese Funktion kann bis zu 16 (!) Fenster überlappungsfrei positionieren.
  787.  
  788.         Ausprobiert ?
  789.  
  790.         Man sieht, dass alle ungeraden Zahlen von Fenstern zürst die oberen Reihen
  791.         füllen. Hat man mehr als 16 Fenster werden die anderen einfach über die
  792.         breits verschobenen platziert.
  793.         Tiling bringt ausserdem das gerade platzierte Fenster in den Vordergrund.
  794.         Dies ist kein Standard und wird bei anderen Programmen dieser Art meistens
  795.         nicht gemacht.
  796.  
  797.         Ein weiterer Aspekt ist, dass wenn man viele Fenster (Shell oder Verzeich-
  798.         nisfenster) benutzt, muss man unter OS 2.xx eine ganze Zeit warten, bis
  799.         das gerade verschobene Fenster wiederhergestellt worden ist. In dieser Zeit
  800.         muss eine Tiling Funktion normalerweise warten, bis der Refresh Vorgang ab-
  801.         geschlossen ist. Stellt man sich vor man hat 10 Fenster, dann kann das schon
  802.         eine geraume Zeit daürn (zum Mindest bei einem Standard Amiga).
  803.         Aus diesem Grund habe ich mich entschlossen, die Geschwindigkeit ein bisschen
  804.         zu erhöhen und setzte Kurzfristig das NOCAREREFRESH Bit der Fensterstruktur.
  805.  
  806.         Nach Beendigung der Funktion werden die Fensterbits wiederhergestellt.
  807.  
  808.         Alle Fenster, die mit den Auschlußdateieinträgen übereinstimmen, werden von
  809.         dieser Funkton ausgeschlossen.
  810.  
  811.  
  812.     Kaskading von links nach rechts: (Voreingestellt: `shift control f8`)
  813.  
  814.         Hier werden alle Fenster des aktuellen Bildschirms in Kaskadenart
  815.         positioniert. Angefangen von links oben nach rechts oben. Dabei
  816.         wird jedes Fenster um Linker Offset mehr nach rechts verschoben.
  817.  
  818.         Alle Fenster, die mit den Auschlußdateieinträgen übereinstimmen, werden von
  819.         dieser Funkton ausgeschlossen.
  820.  
  821.     Kaskade von oben nach unten: (Voreingestellt: `control f9`)
  822.  
  823.         Hier werden alle Fenster des aktuellen Bildschirms in Kaskadenart
  824.         positioniert. Angefangen von links oben nach links unten. Dabei
  825.         wird jedes Fenster um Oberer Offset unter das vorherige verschoben.
  826.  
  827.         Alle Fenster, die mit den Auschlußdateieinträgen übereinstimmen, werden von
  828.         dieser Funkton ausgeschlossen.
  829.  
  830.     Kaskade hor&vertikal: (Voreingestellt: `shift control f9`)
  831.  
  832.         Hier werden alle Fenster des aktuellen Bildschirms in Kaskadenart
  833.         positioniert. Angefangen von links oben nach rechts unten. Dabei
  834.         wird jedes Fenster um Linker Offset mehr nach links und um Oberer
  835.         Offset mehr nach unten verschoben.
  836.  
  837.         Alle Fenster, die mit den Auschlußdateieinträgen übereinstimmen, werden von
  838.         dieser Funkton ausgeschlossen.
  839.  
  840.     Kaskade von unten nach oben: (Voreingestellt: `control f10`)
  841.  
  842.         Hier werden alle Fenster des aktuellen Bildschirms in Kaskadenart
  843.         positioniert. Angefangen von rechts unten nach rechts oben. Dabei
  844.         wird jedes Fenster um Oberer Offset mehr über das vorherige ver-
  845.         schoben.
  846.  
  847.         Alle Fenster, die mit den Auschlußdateieinträgen übereinstimmen, werden von
  848.         dieser Funkton ausgeschlossen.
  849.  
  850.     Akt. vorherigen Fenster: (Voreingestellt: `lcommand left`)
  851.  
  852.         Diese Funktion aktiviert das vorherige Fenster in der Fensterliste
  853.         des aktuellen Bildschirms. Dabei werden nur Fenster berücksichtigt,
  854.         die nicht in der Fenster Ausschlussdatei angegeben sind.
  855.  
  856.     Akt. nächstes Fenster: (Voreingestellt: `lcommand right`)
  857.  
  858.         Diese Funktion aktiviert das nächste Fenster in der Fensterliste
  859.         des aktuellen Bildschirms. Dabei werden nur Fenster berücksichtigt,
  860.         die nicht in der Fenster Ausschlussdatei angegeben sind.
  861.  
  862.     Vorh. Fenster nach vorn: (Voreingestellt: `shift lcommand left`)
  863.  
  864.         Diese Funktion aktiviert das vorherige Fenster in der Fensterliste
  865.         des aktuellen Bildschirms und bringt es in den Vordergrund. Dabei
  866.         werden nur Fenster berücksichtigt, die nicht in der Fenster
  867.         Ausschlussdatei angegeben sind.
  868.  
  869.     Nächs. fenster nach vorn: (Voreingestellt: `shift lcommand right`)
  870.  
  871.         Diese Funktion aktiviert das nächste Fenster in der Fensterliste
  872.         des aktuellen Bildschirms und bringt es in den Vordergrund. Dabei
  873.         werden nur Fenster berücksichtigt, die nicht in der Fenster
  874.         Ausschlussdatei angegeben sind.
  875.  
  876.     Fenster nach vorn: (Voreingestellt: `lcommand return`)
  877.  
  878.         Dies bringt das aktuelle Fenster in den Vordergrund.
  879.  
  880.     Fenster nach hinten: (Voreingestellt: `lcommand esc`)
  881.  
  882.         Dies bringt das aktuelle Fenster in den Hintergrund.
  883.  
  884.     Nächster Screen: (Voreingestellt: `lcommand up`)
  885.  
  886.         Dies bringt den vordersten Bildschirm ganz nach hinten.
  887.  
  888.     Kill Window: (Voreingestellt: `shift control esc`)
  889.  
  890.         Diese Funktion schließt das aktuelle Fenster nach einer Sicher-
  891.         heitsabfrage.
  892.  
  893.         !!! Vorsicht !!!
  894.  
  895.         Bei dieser Funktion werden Fenster geschlossen, die von anderen Programmen
  896.         hinterlassen wurden, die z.B. durch einen Programmfehler beendet wurden oder
  897.         Ähnliches.
  898.  
  899.         Wenn man Fenster von laufenden Programmen schließt, kann dies zu einem
  900.         Systemabsturz führen. Also sollte diese Funktionen nur in Notfällen benutzt
  901.         werden.
  902.  
  903.     Öffne Shell: (Voreingestellt: `shift control s`)
  904.  
  905.         Diese Funktion öffnet eine NewShell. Dabei benutzt die Shell den Pfad, der
  906.         in der Startup-Seqünce angegeben wurde. Auch der Systemstack wird benutzt.
  907.  
  908.     Öffne Ausschluß Fenster: (Voreingestellt: `shift control x`)
  909.  
  910.         Öffnet das Ausschluß Fenster ohne das Hauptfenster zu öffnen.
  911.  
  912.     Öffne Voreinsteller Fenster: (Voreingestellt: `shift control l`)
  913.  
  914.         Öffnet das Voreinsteller Fenster ohne das Hauptfenster zu öffnen.
  915.  
  916.     Öffne Uhren Fenster: (Voreingestellt: `shift control c`)
  917.  
  918.         Öffnet das Uhren Fenster ohne das Hauptfenster zu öffnen.
  919.  
  920.     Öffne Paletten Fenster: (Voreingestellt: `shift control p`)
  921.  
  922.         Öffnet das Paletten Fenster ohne das Hauptfenster zu öffnen.
  923.  
  924.     Öffne Nachrichten Fenster: (Voreingestellt: `shift control n`)
  925.  
  926.         Öffnet das Nachrichten Fenster ohne das Hauptfenster zu öffnen.
  927.  
  928.  
  929.     Zusammenfassung:
  930.  
  931.         Das Verschieben von Fenstern funktioniert nur bei Fenstern mit
  932.         einer DRAG_BAR (lässt sich herrausfinden, indem man versucht mit
  933.         der Maus das Fenster zu verschieben).
  934.  
  935.         Das Vergrössern und Verkleinern funktioniert nur bei Fenstern
  936.         die ein GrössenGadget haben (unten rechts).
  937.  
  938.         Die Zoom (Zip) Funktion funktioniert nur bei Fenstern mit ZipGadget.
  939.  
  940.         In den Vordergrund/Hintergrung bringen funktioniert nur bei Nicht-
  941.         Backdrop-Fenstern (Ein Backdrop Fenster ist z.B. das WorkBench Fenster
  942.         der WBench 1.3).
  943.  
  944.         Die Funktionen zum Aktivieren des nächsten und vorherigen Fensters
  945.         und die Tiling und Kaskadierungsfunktionen funktionieren nur bei
  946.         Fenster, die nicht in der Ausschlussliste stehen.
  947.  
  948.         Die Setzte nach Preferences Funktion funktioniert nur bei Fenstern,
  949.         die in der Fensterlistendatei stehen.
  950.  
  951.         Die Reset Funktion funktioniert nur, wenn das Fenster vorher von WComm
  952.         manipuliert worden ist (ausgenommen Kaskadieren und Tiling Manipulationen).
  953.  
  954.         Tiling und Kaskadierung Funktionen versuchen Fenster zu verschieben und
  955.         in ihrer Grösse zu verändern. Hat ein Fenster kei GrössenGadget,
  956.         wird das Fenster nur verschoben. Backdrop Fenster werden nicht berück-
  957.         sichtigt.
  958.  
  959.         Die Voreinsteller- und die Ausschlussliste können ein Fenstertitel bei
  960.         Angabe der ersten unverwechselbaren Buchstaben angeben. Man kann auch
  961.         `Super` Gruppen angeben.
  962.  
  963.  
  964. Allgemein:
  965.  
  966.     Bevor ich die Fenster näher erkläre, möchte ich noch etwas algemeines zu
  967.     der Benutzung der Benutzeroberfläche sagen.
  968.  
  969.     Alle Funktionen können über Gadgets gestartet werden.
  970.  
  971.     Für fast alle Gadgets existiert eine Taste, die man betätigen  kann
  972.     anstatt das Gadget mit der Maus zu aktivieren.
  973.     Diese Taste ist unterstrichen dargestellt. Für einige wichtige Gadgets
  974.     existiert eine solche Keyboardunterstützung nicht. Dies ist besonders bei
  975.     wichtigen Funktionen implementiert, damit nicht aus Versehen wichtige Funk-
  976.     tionen abgerufen werden können.
  977.  
  978.     Die unterstrichenen Tasten unterscheiden nur dann zwischen Groß- und Klein-
  979.     schreibung, wenn es beide Versionen mit unterschiedlichen Bedeutungen gibt.
  980.  
  981.     Auf das Schließgadget des Fensters zu klicken ist genauso, als wenn
  982.     man das Beenden Gadget benutzt.
  983.  
  984.     Alle Funktionen sind jederzeit benutzbar. Jedes Fenster arbeitet
  985.     asyncron. D.H. Man kann eine Einstellungen verändern und dies wird
  986.     sofort sichtbar.
  987.  
  988.     Für jedes Fenster existiert ein Hotkey, mit dem man ohne Umwege auf dieses
  989.     Fenster gelangen kann. Ist ein Fenster schon geöffnet aber im Hintergrund,
  990.     kann man das Fenster mit erneutem Betätigen des Hotkeys aktivieren und
  991.     nach Vorne bringen.
  992.  
  993.  
  994. OS 2.04 Gadgets:
  995.  
  996.     Da unter OS 2.04 eine Reihe neür Gadgets eingeführt wurden, werde ich
  997.     hier eine kurze Beschreibung geben.
  998.  
  999.     BUTTON_GADGET:
  1000.  
  1001.         Knopf Gadget - Wird durch einmaligen Druck mit der linken Maustaste
  1002.         invers dargestellt. Läßt man die Taste über dem Gadget los, wird die
  1003.         jeweilige Funktion gestartet.
  1004.  
  1005.         Drücken der unterstrichenen Taste bewirkt das Gleiche.
  1006.  
  1007.     CHECKBOX_GADGET:
  1008.  
  1009.         Haken-Box - Dieses Gadget besitzt zwei Zustände aktiviert und nicht-
  1010.         aktiviert. Ist es aktiviert, ist eine kleiner Haken sichtbar, sonst
  1011.         nicht.
  1012.  
  1013.         Drücken der unterstrichenen Taste bewirkt das Gleiche wie Anklicken
  1014.         mit Maus.
  1015.  
  1016.     STRING_GADGET:
  1017.  
  1018.         Texteingabefeld - Ermöglicht die Edititerung des im Gadget stehenden
  1019.         Textes. Durch Drücken der RETURN - Taste, wird der Editiervorgang ab-
  1020.         geschlossen.
  1021.  
  1022.         Das Drücken der unterstrichenen Taste entspricht einem Aktivieren
  1023.         dieses Gadgets mit der Maus.
  1024.  
  1025.     CYCLE_GADGET:
  1026.  
  1027.         Hier wird eine Auswahl aus mehreren getroffen. Die momentane Auswahl
  1028.         wird angezeigt. Durch Klicken mit der linken Maustaste wird die
  1029.         nächste Auswahlmöglichkeit angezeigt.
  1030.  
  1031.         Benutzt man die unterstrichene Taste, hat das denselben Effekt, wie
  1032.         ein Mausklick. Drückt man hingegen die unterstrichene Taste zusammen
  1033.         mit der Shift-Taste, wird nicht zur nächsten Auswahl, sondern zur
  1034.         vorherigen Auswahl gewechselt.
  1035.  
  1036.     MX_Gadget:
  1037.  
  1038.         Auswahl Gadget - Hier hat man die Alternative zwischen den darge-
  1039.         stellten Möglichkeiten. Die eingedrückt dargestellte Möglichkeit
  1040.         ist aktiv. Ein Aktivieren einer anderen Auswahl, deaktiviert die
  1041.         erste.
  1042.  
  1043.     SLIDER_GADGET:
  1044.  
  1045.         Rollbalken - Der Körper (meist in schwarz) zeigt das Verhältinis der
  1046.         Anzahl aller Elemente zu den derzeitig dargestellten Elementen an.
  1047.         Durch Klicken unterhalb oder oberhalb des Körpers aber innerhalb der
  1048.         Umrandung, läßt sich einen Ausschnitt weiter nach oben (links) oder
  1049.         nach unten (rechts) rollen. Hält man die Maustaste gedrückt, während
  1050.         der Mauszeiger bewegt wird, kann man eine kontinuierliche Bewegung
  1051.         erreichen.
  1052.  
  1053.         Auch hier hat die unterstrichene Taste, zusammen mit der Umschalte-
  1054.         taste, eine Bewegung des Rollbalkens nach oben (links) zur Folge.
  1055.  
  1056.     LISTVIEW_GADGET
  1057.  
  1058.         Listengadget - Zeigt eine Liste an. Aktivierung mittels Mausklick.
  1059.  
  1060.         Kein Tastaturäquivalent.
  1061.  
  1062.  
  1063. Das Haupt Fenster:
  1064.  
  1065.  
  1066.     Wenn man den HotKey für das POPUP des Haupt Fensters benutzt,
  1067.     (Voreingestellt `control o`), öffnet sich das Haupt Fenster.
  1068.     Dies kann ebenfalls mit dem Exchange Programm durchgeführt werden,
  1069.     wenn man WComm auswählt und dann Show anklickt. Dieses Fenster
  1070.     wird auch beim Start geöffnet, wenn man CX_POPUP als CLI-Argument
  1071.     oder ToolType angibt.
  1072.  
  1073.     Auf dem Haupt Fenster kann man die Konfigurationsdatei laden und ab-
  1074.     speichern. Man kann alle anderen Fenster aufrufen und die Hotkeys ab-
  1075.     ändern.
  1076.  
  1077.     LISTVIEW Gadget
  1078.  
  1079.     Das ListenGadget zeigt eine Liste aller Funktionen von WComm an.
  1080.     Man kann die Pfeil Gadgets benutzen, um in der Liste nach oben
  1081.     bzw. unten zu rollen. Klickt man auf eine dieser Zeilen, wird im
  1082.     Jetzige Textgadget die momentan benutzte HotKey-Kombination für die
  1083.     jeweilige Funktion angezeigt.
  1084.  
  1085.     Edit (`e`)
  1086.     Neu (`w`)
  1087.  
  1088.     Klickt man auf Edit wird das Neu StringGadget aktiviert, in das man
  1089.     dann eine neü HotKey-Kombination eingeben kann, die dann die alte,
  1090.     bisher benutzte, ersetzen soll.
  1091.  
  1092.     WComm versucht nun diesen neün HotKey vom System anzufordern.
  1093.  
  1094.     Gelingt dies, wird die neü Kombination im Jetzige Textgadget ange-
  1095.     zeigt und das StringGadget wird wieder inaktiviert.
  1096.  
  1097.     Wird hingegen eine fehlerhafte Kombination eingegeben, oder kann
  1098.     WComm aus irgendeinen anderen Grund dieses HotKey nicht benutzen,
  1099.     so wird der voreingestellte HotKey benutzt. Auch dieser wird dann im
  1100.     TextGadget dargestellt.
  1101.  
  1102.     Unter dem ListView Gadget sind noch zwei weitere Gadgets. Ist ein
  1103.     Eintrag des ListView Gadgets aktiviert, kann man auf Deaktiv drücken,
  1104.     um den HotKey zu deaktivieren. Aktiviren läßt sich ein Hotkey nur,
  1105.     wenn er deaktiviert ist.
  1106.  
  1107.     Die Gadgets auf der rechten Seite des Fensters:
  1108.  
  1109.     Öffnen ('o')
  1110.     Auswahl ('s')
  1111.     Sichern ('v')
  1112.     Sich Als('a')
  1113.  
  1114.     Das Öffnen Gadget lädt die voreingestellte Konfigurationsdatei mit
  1115.     dem Namen `env:WComm.prefs`. Das Auswahl Gadget öffnet den Asl-
  1116.     Filereqüster, mit dem man dann eine andere Konfigurationsdatei
  1117.     auswählen kann. Voreingestellt ist hier: `envarc:WComm.prefs`.
  1118.  
  1119.     Mit dem Sichern Gadget werden die momentan benutzten HotKeys als
  1120.     Konfigurationsdatei unter den Namen `env:WComm.prefs` abgespei-
  1121.     chert. Das SichAls Gadget öffnet wieder den AslFilereqüster mit
  1122.     voreingestelltem Namen `envarc:WComm.prefs`.
  1123.  
  1124.     Zurück ('r')
  1125.     Normal ('f')
  1126.  
  1127.     Das Zurück Gadget benutzt den letzten HotKey, bevor er durch den
  1128.     Benutzer geändert wurde, während das Normal Gadet alle HotKeys
  1129.     zu den Voreingestellten Werten zurücksetzt und diese dann an-
  1130.     schließend wieder aktiviert.
  1131.  
  1132.     Es folgt nun eine Liste der Gadgets mit denen man auf die anderen
  1133.     Fenster von WComm gelangt.
  1134.  
  1135.     Öffne Ausschluß Fenster ('×')
  1136.  
  1137.     Dies öffnet das Ausschlussfenster, das später noch beschrieben wird.
  1138.  
  1139.     Öffne Voreinsteller Fenster ('.')
  1140.  
  1141.     Dies Gadget öffnet das Voreinstellerfenster. Auch dieses Fenster wird
  1142.     noch beschrieben.
  1143.  
  1144.     Öffne Uhren Fenster (';')
  1145.  
  1146.     Dies Gadget öffnet das Uhren Fenster. Später mehr dazu.
  1147.  
  1148.     Öffne Paletten Fenster ('p')
  1149.  
  1150.     Dies öffnet das Paletten Fenster, das später noch beschrieben wird.
  1151.  
  1152.  
  1153.     Die nun folgenden zwei Gadget besitzt jedes Gadget in der ein oder
  1154.     anderen Form. Jedes dieser zwei Gadgets schließt das aktuelle Fenster.
  1155.  
  1156.     Verbergen ('h')
  1157.     Beenden ('q')
  1158.  
  1159.     Mit Verbergen kann man das Fenster schließen und WComm bleibt weiterhin
  1160.     im Hintergrund aktiv.
  1161.     Im Gegensatz dazu wird mit dem Beenden Gadget das ganze Programm beendet.
  1162.     Hat man die Einstellungen verändert und klickt man auf Beenden, öffnet sich
  1163.     ein Reqüster, der fragt, ob man die Konfigurationen vorher abspeichern will
  1164.     oder nicht. Hat man die Konfiguration nicht verändert fragt der Reqüster
  1165.     lediglich, ob man das Programm auch wirklich beenden will.
  1166.  
  1167.     Der Hotkey für das Beenden von WComm entspricht im Wesentlichen dem
  1168.     Beenden Gadget, mit der Ausnahme, daß kein Reqüster dargestellt wird,
  1169.     egal ob irgendeine Einstellung verändert wurde oder nicht.
  1170.  
  1171. Das Ausschluß Fenster:
  1172.  
  1173.     In diesem Fenster kann man die Ausschlussliste abändern, erweitern, spei-
  1174.     chern und laden.
  1175.  
  1176.     Das Fenster kann sowohl vom Einsteller Fenster oder per Hotkey geöffnet
  1177.     werden.
  1178.  
  1179.     Fenstertitel, die mit den in der Liste stehenden Fenstertiteln übereinstim-
  1180.     men, werden von bestimmten Funktionen wie z.B.
  1181.  
  1182.         Tilen, Kaskadieren, Vor-, Zurückblättern etc.
  1183.  
  1184.     ausgeschlossen.
  1185.  
  1186.     Die Listeneinträge bestehen aus AmigaDOS Suchmustern. Dabei muß man
  1187.     beachten, daß keine doppelten Einträge verwendet werden, da die Liste
  1188.     von WComm immer von oben nach unten auf Übereinstimmungen untersucht
  1189.     wird. Bei zwei gleichnamigen Einträgen wird also immer nur die obere
  1190.     benutzt.
  1191.  
  1192.     Die Gadgets des Fensters:
  1193.  
  1194.  
  1195.     LISTVIEW:
  1196.  
  1197.         Dieses ListenGadget zeigt alle momentanen Ausschlussfenster an.
  1198.         Wählt man einen Eintrag aus, so wird er in das StringGadget unter
  1199.         dem ListenGadget kopiert und gleichzeitig wird das Gadget aktiviert.
  1200.         Wenn man eine Veränderung nun mit Return abschliesst, wird der alte
  1201.         Name durch die neü Eingabe ersetzt und in die Liste aufgenommen.
  1202.  
  1203.  
  1204.     NEU:
  1205.  
  1206.         Hiermit wird ein neür Eintrag am Ende der Liste eingefügt, der
  1207.         unnamed genannt wird. Zugleich wird er in das StringGadget kopiert,
  1208.         das dann auch gleich aktiviert wird. Es steht also sofort zur Edi-
  1209.         tierung bereit.
  1210.  
  1211.     WEG:
  1212.  
  1213.         Hiermit wird der gerade dargestellte Eintrag von der Liste entfernt.
  1214.  
  1215.     DEAKTIV:
  1216.  
  1217.         Man kann einen Eintrag hiermit deaktivieren. Wird ein Eintrag
  1218.         deaktiviert, erscheint am Anfang des Namens ein `>>`.
  1219.         Man kann nur Einträge deaktivieren, die vorher aktiviert sind.
  1220.         Auch die Aktivierung bzw. Deaktivierung eines Eintrages wird in der
  1221.         Ausschlußdatei mit abgespeichert.
  1222.  
  1223.     AKTIV:
  1224.  
  1225.         Dies (re)aktiviert einen vorher deaktivierten Eintrag. Das
  1226.         `>>` verschwindet. Es lassen sich nur Einträge aktivieren, die
  1227.         vorher deaktiviert wurden.
  1228.  
  1229.     OEFFNE:
  1230.  
  1231.         WComm versucht die voreingestellte Ausschlussdatei zu laden.
  1232.         (`env:XWindow.prefs`,`envarc:XWindow.prefs`). Kann sie nicht
  1233.         geladen werden, bekommt der Benutzer eine Fehlernachricht.
  1234.  
  1235.     AUSWAHL:
  1236.  
  1237.         Dies öffnet den FileReqüster, um eine Datei zum Laden auszuwählen.
  1238.  
  1239.     SAVE:
  1240.  
  1241.         Dies speichert die aktuelle Ausschlußliste unter dem voreingestellten
  1242.         Namen `env:XWindow.prefs` ab.
  1243.  
  1244.     SICHALS:
  1245.  
  1246.         Dies öffnet den FileReqüster, um einen Dateinamen zum Speichern
  1247.         auszuwählen. Voreingestellt ist hier envarc:XWindow.prefs.
  1248.         Man kann natürlich auch einen anderen Namen wählen.
  1249.  
  1250.     BENUTZE:
  1251.  
  1252.         Dies schliesst das Fenster.
  1253.  
  1254.     QUIT:
  1255.  
  1256.         Dies schliesst das Fenster und fragt nach, ob man WComm beenden
  1257.         will.
  1258.  
  1259.  
  1260. Das Voreinsteller Fenster:
  1261.  
  1262.     In diesem Fenster kann man die Voreinstellungsliste erweitern,
  1263.     speichern und laden usw.
  1264.  
  1265.     Man kann hier Fenstertitel mit Koordinaten und Größenangaben angeben, die
  1266.     mittels der `Setze nach Preferences` Funktion benutzt werden.
  1267.  
  1268.     Das Fenster kann sowohl vom Einsteller Fenster als auch per Hotkey geöff-
  1269.     net werden.
  1270.  
  1271.     Die Gadgets des Fensters:
  1272.  
  1273.     LISTVIEW:
  1274.  
  1275.         Dieses ListenGadget zeigt alle momentan bekannten Voreinstellungen
  1276.         an.
  1277.  
  1278.         Wählt man einen Eintrag aus, so wird er in das StringGadget unter
  1279.         dem ListenGadget kopiert und gleichzeitig wird das Gadget aktiviert.
  1280.         Die Linke -,Obere Ecke-, die Breite- und Höhe- Werte werden in die
  1281.         IntegerGadgets kopiert und dargestellt.
  1282.         Wenn man nun eine Änderung mit Return abschliesst, wird die Änderung
  1283.         übernommen.
  1284.  
  1285.         Die Fenstertitel dürfen AmigaDOS Suchmuster enthalten, aber keine
  1286.         Leerzeichen.
  1287.  
  1288.     NEU:
  1289.  
  1290.         Hiermit wird ein neür Eintrag am Ende der Liste eingefügt, der
  1291.         unnamed genannt wird. Zugleich wird er in das StringGadget kopiert,
  1292.         das dann auch gleich aktiviert wird. Es steht also sofort zur Edi-
  1293.         tierung bereit.
  1294.  
  1295.     WEG:
  1296.  
  1297.         Hiermit wird der gerade dargestellte Eintrag von der Liste entfernt.
  1298.         Auch hier gilt: zwei gleichenamige Einträge sollten vermieden werden.
  1299.  
  1300.     DEAKTIV:
  1301.  
  1302.         Man kann einen Eintrag hiermit deaktivieren. Wird ein Eintrag
  1303.         deaktiviert, erscheint am Anfang des Namens ein `>>`.
  1304.         Man kann nur Einträge deaktivieren, die vorher aktiv sind.
  1305.  
  1306.     AKTIV:
  1307.  
  1308.         Dies (re)aktiviert einen vorher deaktivierten Eintrag. Das
  1309.         `>>` verschwindet. Es lassen sich nur Einträge aktivieren, die
  1310.         vorher deaktiviert wurden.
  1311.  
  1312.     ÖFFNEN:
  1313.  
  1314.         WComm versucht die voreingestellte Voreinstellerdatei zu laden.
  1315.         (`env:ZWindow.prefs`,`envarc:ZWindow.prefs`). Kann sie nicht geladen
  1316.         werden, bekommt der Benutzer eine Nachricht.
  1317.  
  1318.     AUSWAHL:
  1319.  
  1320.         Dies öffnet den FileReqüster, um eine Datei zum Laden auszuwählen.
  1321.  
  1322.     SICHERN:
  1323.  
  1324.         Dies speichert die aktuelle Liste unter dem voreingestellten Namen
  1325.         `env:ZWindow.prefs`
  1326.  
  1327.     SICHALS:
  1328.  
  1329.         Dies öffnet den FileReqüster, um einen Dateinamen zum Speichern
  1330.         auszuwählen. Voreingestellt ist hier `envarc:ZWindow.prefs`.
  1331.         Man kann natürlich auch einen anderen Namen wählen.
  1332.  
  1333.     LIECKE,T ECKE,WEITE,HOEHE:
  1334.  
  1335.         Diese Gadgets zeigen die Werte für den aktuellen Fenstereintrag dar.
  1336.  
  1337.         LI ECKE:
  1338.  
  1339.         Die linke Position des Fensters.
  1340.  
  1341.         T ECKE:
  1342.  
  1343.         Die obere Position des Fensters.
  1344.  
  1345.         WEITE:
  1346.  
  1347.         Die Weite des Fensters.
  1348.  
  1349.         HOEHE:
  1350.  
  1351.         Die Höhe des Fensters.
  1352.  
  1353.         Alle Eingaben werden sofort übernommen.
  1354.  
  1355.     USE:
  1356.  
  1357.         Dies schließt das Fenster.
  1358.  
  1359.     QUIT:
  1360.  
  1361.         Dies schließt das Fenster und fragt nach, ob man WComm beenden
  1362.         will.
  1363.  
  1364. Das Uhren Fenster:
  1365.  
  1366.     Das Fenster kann sowohl vom Hauptfenster oder per Hotkey geöffnet werden.
  1367.  
  1368.     Mit diesem Fenster kann man das Aussehen der Bildschirmuhr verändern oder
  1369.     sie schließen. Voreinstellungsmäßig ist die Uhr angeschaltet und zeigt
  1370.     kein Datum an und die Zeit wird in Stunden:Minuten angezeigt.
  1371.  
  1372.     Bemerkung:  Will man die Nachrichtenfunktionen (siehe NAchrichten Fenster)
  1373.                 benutzen, muß die Uhr eingeschaltet sein.
  1374.  
  1375.     Alle Änderungen werden in der folgenden Sekunde auf die Titeluhr über-
  1376.     tragen.
  1377.  
  1378.  
  1379.     Nun zur Erklärung der einzelnen Gadgets:
  1380.  
  1381.  
  1382.     Uhren Typ ('T' oder 't')
  1383.  
  1384.         Die Stellung dieses CycleGadgets bestimmt, ob die Uhr
  1385.         geöffnet werden soll oder nicht. Voreinstellung: ein.
  1386.  
  1387.     Zeit Format ('f' oder 'F')
  1388.  
  1389.         Hiermit kann man die Darstellung der Zeit bestimmen.
  1390.         Als Auswahl hat man hier:
  1391.  
  1392.             ST:MI       - Stunden:Minuten (VOREINSTELLUNG)
  1393.             ST:MI:SE    - Stunden:Minuten:Sekunden
  1394.           24ST:MI       - 24-Stunden:Minuten
  1395.           24ST:MI:SE    - 24-Stunden:Minuten:Sekunden
  1396.  
  1397.     Datum Typ ('y' oder 'Y')
  1398.  
  1399.         Hiemit kann man die Darstellung des Datums bestimmen.
  1400.         Mögliche Darstellungsformen:
  1401.  
  1402.             Kein Datum      - es wird kein Datum angezeigt (VOREIN-
  1403.                               STELLUNG)
  1404.             WT Tag-Mon-Jahr - Wochentag Tag-Monat-Jahr
  1405.         KurzWT Tag-Mon-Jahr - kurzer Wochentag Tag-Monat-Jahr
  1406.                Tag-Mon-Jahr - kein Wochentag Tag-Monat-Jahr
  1407.  
  1408.     Weite ('w' oder 'W')
  1409.  
  1410.         Dies ist die Breite des Fensters. Man kann hier einen Wert
  1411.         zwischen 150 und 450 bestimmen. Voreingestellt: 150
  1412.  
  1413.     Linke Ecke ('l' oder 'L')
  1414.  
  1415.         Dies ist die linke Position der Uhr.
  1416.         Voreingestellt: 0
  1417.  
  1418.     Obere Ecke ('o' oder 'O')
  1419.  
  1420.         Dies ist die obere Position der Uhr.
  1421.         Voreingestellt: 0
  1422.  
  1423.     Alarm ein ('n' oder 'N')
  1424.  
  1425.         Die Uhr hat die Möglichkeit zu einer bestimmten Uhrzeit einen Alarm
  1426.         auszulösen. Der Bildschirm blinkt dann kurz auf und kann so den
  1427.         Benutzer auf eine bestimmte Uhrzeit aufmerksam machen. Dieses Gadget
  1428.         entscheidet, ob die Alarmfunktion eingeschaltet ist oder nicht.
  1429.         Voreingestellt: aus
  1430.  
  1431.     Beep jede Std ('p' oder 'P')
  1432.  
  1433.         Zusätzlich zur Alarmfunktion kann WComm auch jede Stunde den Bild-
  1434.         schirm kurz aufblitzen lassen.
  1435.         Voreingestellt: aus
  1436.  
  1437.     Al Std ('a' oder 'A')
  1438.  
  1439.         Dies ist die Stunde, an der der Alarm ausgelöst werden soll.
  1440.         Voreingestellt: 0
  1441.  
  1442.     Al Min ('m' oder 'M')
  1443.  
  1444.         Dies ist die Minute, an der der Alarm ausgelöst werden soll.
  1445.         Voreingestellt: 0
  1446.  
  1447.     Benutzen ('u' oder 'U')
  1448.  
  1449.         Die aktuellen Werte werden benutzt.
  1450.  
  1451.     Abbruch ('c' oder 'C')
  1452.  
  1453.         Die aktuellen Werte werden nicht benutzt, stattdessen werden die Werte
  1454.         benutzt, die vor dem Aufruf dieses Fensters aktuell waren.
  1455.  
  1456.     Alle Einstellungen dieses Fenster werden in die Konfigurationsdatei mit
  1457.     abgespeichert.
  1458.  
  1459.     Wird die Uhr durch betätigen des Schließgadgets geschlossen, hat dies auf
  1460.     das geöffnete Fenster keinen Einfluß. Wird das Fenster aber erneut aufge-
  1461.     rufen, ist der Uhrentyp auf `keine Uhr` eingestellt.
  1462.  
  1463.  
  1464.  
  1465.  
  1466. Das Nachrichten Fenster:
  1467.  
  1468.     Dieses Fenster kann auch vom Haupt Fenster oder per Hotkey gestartet
  1469.     werden.
  1470.  
  1471.     Alle Funktionen dieses Fensters beschäftigen sich mit der Nachrichten-
  1472.     liste. Sie kann hier geändert, geladen und abgespeichert werden.
  1473.  
  1474.     Die Nachrichtenliste beinhaltet einen Titel, einen Nachrichtentext,
  1475.     das Datum und die Uhrzeit der Nachricht und ein optionales Kommando,
  1476.     daß auf dreierlei Arten aufgerufen werden kann (EXECUTE, RUN und
  1477.     AREXX).
  1478.  
  1479.     Ein Nachrichtenrequester kann zu einer bestimmten Zeit geöffnet werden
  1480.     und eine Nachricht mitteilen. Optional kann dieser Requester auch ein
  1481.     vorher eingegebenes Kommando ausführen. Der Zetipunkt des Requesters
  1482.     kann mit den Stunden, Minuten, Monat oder Tag Slidergadgets eingestellt
  1483.     werden. Jedes einzelne dieser Angaben kann dabei unabhängig voneinander
  1484.     aktiviert und deaktiviert werden. Eines dieser Angaben muß aber immer
  1485.     aktiviert sein, sonst wird es einfach ignoriert. Mit diesem Konzept ist
  1486.     es möglich, eine Nachricht jede Stunde oder nur einmal anzeigen zu
  1487.     lassen.
  1488.  
  1489.     Gadget Beschreibung:
  1490.  
  1491.     LISTVIEW Gadget:
  1492.  
  1493.     Dieses Gadget stellt die Titel der Requester dar. Dieser Titel wird dann
  1494.     in der Titelzeile der Requester angezeigt.
  1495.  
  1496.     NEU:
  1497.  
  1498.     Dieses Gadget fügt einen neuen leeren Eintrag an das Ende der Liste an.
  1499.  
  1500.     WEG:
  1501.  
  1502.     Dieses Gadget entfernt den aktuellen Eintrag aus der Liste.
  1503.  
  1504.     AKTIV:
  1505.  
  1506.     Dieses Gadget aktiviert den aktuellen Eintrag. Das geht nur bei zuvor
  1507.     deaktivierten Einträgen.
  1508.  
  1509.     INAKTIV:
  1510.  
  1511.     Dieses Gadget deaktiviert den aktuellen Eintrag. Dies funktioniert nur
  1512.     bei aktiven Einträgen.
  1513.  
  1514.     NAME:
  1515.  
  1516.     Dieses StringGadget enthält den Namen des aktuellen Eintrages.
  1517.  
  1518.     NACHRICHT:
  1519.  
  1520.     Dieses StringGadget enthält den Text des Nachrichtenrequesters. Dabei
  1521.     können mehrere Zeilen mittels einem `|` angegeben werden. Die Nachricht
  1522.     darf bis zu 256 Zeichen lang sein.
  1523.  
  1524.     KOMMANDO:
  1525.  
  1526.     Soll ein Kommando ausgeführt werden, kann man es hier angeben. Um dieses
  1527.     Kommando benutzen zu können, muß aber noch die Aktion CheckBox aktiviert
  1528.     sein.
  1529.  
  1530.     REQUESTER ZEIT/DATUM:
  1531.  
  1532.     Wenn diese CheckBox aktiviert ist, wird der Requester angezeigt.
  1533.  
  1534.     STD und 1:
  1535.  
  1536.     Dies ist die Stundenangabe, die für das Erscheinen des Requesters
  1537.     benutzt werden soll. Dieser Wert wird nur benutzt, wenn die `1` CheckBox
  1538.     aktiviert ist.
  1539.  
  1540.     MIN und 2:
  1541.  
  1542.     Dies ist die Minutenangabe, die für das Erscheinen des Requesters
  1543.     benutzt werden soll. Dieser Wert wird nur dann benutzt, wenn die `2`
  1544.     CheckBox aktiviert ist.
  1545.  
  1546.     MON und 3:
  1547.  
  1548.     Dies ist die Monatsangabe, die für das Erscheinen des Requesters benutzt
  1549.     werden soll. Dieser Wert wird nur dann benutzt, wenn die `3` CheckBox
  1550.     aktiviert ist.
  1551.  
  1552.     TAG und 4:
  1553.  
  1554.     Dies ist die Tagesangabe, die für das Erscheinen des Requesters benutzt
  1555.     werden soll. Dieser Wert wird nur dann benutzt, wenn die `4` CheckBox
  1556.     aktiviert ist.
  1557.  
  1558.     BEMERKUNG: Es  muß zumindest einer dieser Werte benutzt werden.
  1559.  
  1560.     START:
  1561.  
  1562.     Dieses CycleGadget entscheidet, wie das Kommando gestartet werden soll.
  1563.     Dabei gibt es drei Arten:
  1564.  
  1565.  
  1566.         EXECUTE
  1567.  
  1568.             Dies startet das angegebene Kommando als ein Programm oder als
  1569.             CLI Kommando. Dabei wartet WComm, bis das Kommando ausgeführt
  1570.             worden ist. Alle evtl. Ausgaben werden zu einem dann
  1571.             erscheinenden CLI Fenster kopiert. Werden keine Ausgaben
  1572.             gemacht, bleibt das Fenster geschlossen (AUTO SHELL).
  1573.  
  1574.         BACKGROUND
  1575.  
  1576.             Dies startet ein Kommando als Hintergrundprozeß. Somit ist
  1577.             keinerlei Ein- und Ausgabe mehr möglich.
  1578.  
  1579.         AREXX
  1580.  
  1581.             Dies startet RX mit der angegebenen Kommandozeile.
  1582.  
  1583.         Beachten: Alle drei dieser Möglichkeiten, benutzen den Pfad und
  1584.         Stack der BootShell.
  1585.  
  1586.  
  1587.     EINM:
  1588.  
  1589.     Wenn diese CheckBox aktiviert ist, wird die Nachricht nur einmal
  1590.     angezeigt. Man kann auch Nachrichten benutzen, die z.B. jede Stunde
  1591.     angezeigt werden. Wenn man dieses nicht wünscht, kann man Einm
  1592.     aktivieren. Erst bei einem erneuten Start von WComm wird dieser
  1593.     Requester erneut aktiviert (Siehe auch Beispiele).
  1594.  
  1595.     AKTION:
  1596.  
  1597.     Wenn diese CheckBox aktiviert ist, wird das Kommando, daß in dem Kom-
  1598.     mandoStringgadget steht, beim Aufruf der Nachricht gestartet.
  1599.  
  1600.     ÖFFNE:
  1601.  
  1602.     Dies lädt die voreingestellte Nachrichtendatei mit dem Namen
  1603.     `env:notify.prefs`. kann sie nicht gefunden werden, wird versucht die
  1604.     `envarc:notify.prefs` Datei zu laden.
  1605.  
  1606.     WÄHLE:
  1607.  
  1608.     Dies öffnet den FileRequester, und ermöglicht so daß Laden einer anderen
  1609.     Nachrichtendatei.
  1610.  
  1611.     SICHERN:
  1612.  
  1613.     Dies speichert die Nachrichtendatei unter den voreingestellten Namen ab.
  1614.  
  1615.     SICHALS:
  1616.  
  1617.     Dies öffnet den FileRequester und ermöglicht so die Daten unter einem
  1618.     anderen Namen abzuspeichern.
  1619.  
  1620.     BENUTZE:
  1621.  
  1622.     Dies benutzt die Veränderungen und schließt das Fenster.
  1623.  
  1624.     ENDE:
  1625.  
  1626.     Dies fragt den Benutzer, ob er WComm beenden möchte.
  1627.  
  1628.  
  1629.     BEISPIELE:
  1630.     ==========
  1631.  
  1632.     Da die Nachrichtenverwaltung etwas komplizierter ist, möchte ich hier
  1633.     einige mehr oder weniger sinnvolle Beispiele zeigen.
  1634.  
  1635.     1. WComm soll zu Weihnachten eine Nachricht ausgeben. Dabei soll kein
  1636.     Kommando ausgeführt werden:
  1637.  
  1638.         Name: !!! FROHE WEIHNACHTEN !!!
  1639.  
  1640.         Nachri: Ich wünsche Frohe Weihnachten|und hoffe, daß du viele
  1641.                     Geschenke|bekommen wirst
  1642.  
  1643.         Mon: 12         3: aktiviert
  1644.  
  1645.         Tag: 24         4: aktiviert
  1646.  
  1647.         Einm.: aktiviert
  1648.  
  1649.     Hier sieht man den Sinn des Einm. Gadgets. Wenn es nicht aktiviert ist,
  1650.     kommt dieser Requester genau einmal pro Minute. Aktiviert, kommt er erst
  1651.     nächstes Jahr Weihnachten wieder.
  1652.  
  1653.  
  1654.     2. WComm soll eine Nachricht jede Stunde zum Ende der ersten viertel
  1655.     Stunde anzeigen, daß es Zeit zu einer Pause ist.
  1656.  
  1657.         Name: !!! Pausen Zeit !!!
  1658.  
  1659.         Nachri: Okay Junge|Jetzt ists zeit für eine Tasse Kaffe| oder
  1660.                     lieber Tee?
  1661.  
  1662.         Min: 15         2: aktiviert
  1663.  
  1664.  
  1665.     3. WComm soll automatisch jeden 3. Tag eines jeden Monats ein Backup
  1666.     starten. Man möchte zuerst eine Nachricht erhalten, die dieses einem
  1667.     mitteilt, damit man alle anderen Computeraktivitäten stoppen kann.
  1668.     Ich gehe hier davon aus, daß man ein Programm mit dem Namen Backup im
  1669.     aktuellen Suchpfad der Shell hat.
  1670.  
  1671.         Name: !!! Backup Zeit !!!
  1672.  
  1673.         Message: Okay Junge !| Jetzt ists an der Zeit, ein| neues Backup zu
  1674.         starten
  1675.  
  1676.         Kommand: Backup DH0:
  1677.  
  1678.         Tag: 3         4: aktiviert
  1679.  
  1680.         Einm:   aktiviert
  1681.         Aktion: aktiviert
  1682.  
  1683.  
  1684.     Man kann natürlich auch alle Geburtstage der Freunde eingeben und sich
  1685.     rechtzeitig bescheid geben lassen, um noch nötige Geschenke zu kaufen
  1686.     etc. Auf diese Art wird man nie wieder einen Geburtstag vergessen.
  1687.  
  1688. Das Paletten Fenster:
  1689.  
  1690.     Das Fenster kann sowohl vom Haupt Fenster als auch per Hotkey geöffnet
  1691.     werden.
  1692.  
  1693.     Alle auf diesem Fenster durchzuführenden Funktionen beschäftigen
  1694.     sich mit der Modifizierung der WBenchfarben. Da unter OS 3.0, die ich auch
  1695.     benutze, eine Anzahl von bis zu 256 WBench Farben möglich ist, fielen
  1696.     Palettenprogramme gleicher Art leider aus. So habe ich mich entschlossen,
  1697.     auch ein Palettenfenster einzubaün.
  1698.  
  1699.     Dieses Palettenfenster bietet alle Standardfunktionen von ähnlichen
  1700.     Programmen, die wohl weitestens bekannt sein dürften. Besonderheit ist bei
  1701.     diesem Fenster, daß es automatisch erkennt, wie viele Farben gerade
  1702.     aktiviert sind. Die Anzahl der unterstützten Farben reicht von 2 bis 256.
  1703.  
  1704.     Die Funktionen dieses Fenster sind schnell erklärt und wahrscheinlich
  1705.     kennt jeder ähnliche Programme. Dennoch hier eine Auflistung der Funk-
  1706.     tionen und der entsprechenden Gadgets:
  1707.  
  1708.     PALETTEN Gadget (RETURN)
  1709.  
  1710.     Dies stellt die gerade aktivierte Farbe dar. Bei OS 2.04 ist die
  1711.     aktuelle Farbe links neben den anklickbaren Bereichen nocheinmal
  1712.     dargestellt. Alle Veränderungen wirken sich immer nur auf die
  1713.     aktuelle Farbe aus.
  1714.  
  1715.     RED   ('r' oder 'R')
  1716.     GREEN ('g' oder 'G')
  1717.     BLUE  ('b' oder 'B')
  1718.  
  1719.     Diese SliderGadgets verändern den Rot-, Blau- oder Günanteil der
  1720.     aktuellen Farbe. Zunächst habe ich die Intervalle (Level) hier bei
  1721.     den üblichen 16 Grundfarben belassen. Bei neüren Versionen werde
  1722.     ich aber alle 256 Grundfarben als Intervalle zulassen. (zur Kompati-
  1723.     bilität mit OS 2.04).
  1724.  
  1725.     Die kleinen Buchstaben vergrößern den Farbanteil, während die großen
  1726.     den Farbanteil verringern.
  1727.  
  1728.     Kopie ('o')
  1729.  
  1730.     Wird dieses Gadget betätigt, verändert sich der Mauszeiger zu einem
  1731.     TO. Dies zeigt an, daß keine anderen Eingaben, als ein Klick auf das
  1732.     Palette Gadget erlaubt sind. Wird das Paletten Gadget angeklickt, wird
  1733.     die vorherige aktuelle Farbe zur jetzigen kopiert.
  1734.  
  1735.     Austausch ('a')
  1736.  
  1737.     Diese Funktion ist ähnlich der vorherigen, nur daß hier die Farben aus-
  1738.     getauscht werden.
  1739.  
  1740.     Undo ('d')
  1741.  
  1742.     Wenn das Paletten Fenster zum Ersten mal geöffnet wird, ließt WComm die
  1743.     aktuellen Farben ein. Wird Undo betätigt, werden alle Farben auf diese
  1744.     Werte zurückgesetzt, also auf die Werte vor dem ersten Aufruf des Paletten
  1745.     Fensters.
  1746.  
  1747.     Zurück ('r')
  1748.  
  1749.     Wurde die aktuelle Farbe verändert, wird sie auf den vorherigen Wert zurück-
  1750.     gesetzt.
  1751.     Dies funktioniert für jede Farbe einzeln und anabhängig.
  1752.  
  1753.     Benutze ('u')
  1754.  
  1755.     Benutzt die neün Farbeinstellungen und schließt das Fenster.
  1756.  
  1757.     Abbruch ('c')
  1758.  
  1759.     Benutzt die vorherigen Einstellungen und schließt das Fenster.
  1760.  
  1761.  
  1762.     Bemerkungen:    Werden die aktuellen Farben verändert, werden sie nur im
  1763.                     ViewPort des Screens zwischengespeichert. Werden Programme
  1764.                     wie z.B. die Palette der WBench aufgerufen werden die
  1765.                     Farben auf die ursprünglichen Werte zurückgesetzt. Dies
  1766.                     ist kein BUG, sondern Absicht.
  1767.  
  1768.  
  1769. Die Uhr:
  1770.  
  1771.     Alle Einstellungen der Uhr können mit dem Uhren Fenster abgeändert werden.
  1772.  
  1773.     Die Uhr kann mittels Aktivierung des CloseGadgets geschlossen werden.
  1774.     Um es wieder zu öffnen, muß man das Uhren Fenster benutzen.
  1775.  
  1776.     Die Uhr kann nicht mit der Maus verschoben werden. Will man die Position
  1777.     verändern, kann man dies auf dem Uhren Fenster tun.
  1778.  
  1779.     Die Darstellung der Uhr wird einmal pro Sekunde erneürt. In der Zwischen-
  1780.     zeit wird im Hintergrund gewartet, so daß keine wertvolle CPU-Zeit ver-
  1781.     geudet wird.
  1782.  
  1783. Fehlerbehandlung:
  1784.  
  1785.     WComm wurde komplett unter OS 3.0 geschrieben. Dabei wurde Enforcer
  1786.     benutzt. Ich hoffe alle Enforcer-Hits behoben zu haben. Da aber auch bei
  1787.     bester Kontrolle einige Fehler passieren können, wurde eine Fehlerbehand-
  1788.     lung in WComm miteinbezogen.
  1789.  
  1790.     Die meisten auftretenden Fehler dürften von Fehlbedienungen herrühren.
  1791.     Auch sind mögliche weitere Gründe falsche Konfigurationsdateien und unge-
  1792.     wollte Beeinflussungen mit anderen nicht so system-konformen Programme
  1793.     möglich.
  1794.  
  1795.     ALLGEMEIN:
  1796.  
  1797.     Bei jedem auftretenden Fehlern, versucht WComm den Benutzer einzubeziehen.
  1798.     D.h. der Grund für das Aufkommen des Fehlers wird dem Benutzer immer mit-
  1799.     geteilt. Bei manchen Fehlern kann der Benutzer entscheiden, ob er das
  1800.     Programm beenden möchte oder nicht. Bei ernsteren auftretenden Fehlern
  1801.     kann WComm unter Umständen nicht fortfahren und das Programm wird
  1802.     automatisch beendet.
  1803.  
  1804.     LEICHTERE FEHLER:
  1805.  
  1806.     Bei leichteren nicht ernsten Fehlern, wird der Benutzer nur mittels einem
  1807.     Reqüster auf den Fehler aufmerksam gemacht. Nach Bestätigen des
  1808.     Reqüsters wird WComm fortgesetzt.
  1809.  
  1810.     ERNSTERE FEHLER:
  1811.  
  1812.     Ist der aufgetretene Fehler ernster, läßt der Reqüster zwei Auswahlmög-
  1813.     lichkeiten zu. Das Programm kann fortgesetzt werdern oder aber beendet.
  1814.  
  1815.     Ich möchte dem Benutzer empfehlen, eine solche Mitteilung möglichst mit
  1816.     einem Abbruch zu beantworten, da ein korektes Arbeiten nach einem solchen
  1817.     Fehler nicht immer möglich ist.
  1818.  
  1819.     FATALE FEHLER:
  1820.  
  1821.     Tritt hingegen ein fataler Fehler auf, so kann WComm nicht fortgesetzt
  1822.     werden und der Benutzer wird nur informiert. Nach Bestätigen des
  1823.     Reqüsters wird WComm beendet.
  1824.  
  1825.     UNBEKANNTE FEHLER:
  1826.  
  1827.     Tritt ein unbekannter Fehler auf, sollte man zürst nachschaün, ob WComm
  1828.     korrekt installiert ist und man die folgenden Bibliotheken im Libs:-Ver-
  1829.     zeichnis hat:
  1830.  
  1831.         asl.library
  1832.         commodities.library
  1833.  
  1834.     Kann der Fehler auch dann nicht gefunden werden, sollte man sich diese An-
  1835.     leitung nocheinmal gut durchlesen. Vieleicht entdeckt man hier die Ursache
  1836.     für das Problem. Kann man die Fehlerursache auch hier nicht finden, so kann
  1837.     man mir auch schreiben. Ich werde versuchen das Problem zu lösen. Aber
  1838.     dazu bitte eine korrekte Schilderung des Fehlers, evtl. anderer laufender
  1839.     Hintergrundprogramme, Computertyp, Kickstartversion, Erweitürungen,
  1840.     Speicher und die Version von WComm angeben.
  1841.  
  1842.     Damit wird die Fehlersuche vereinfacht.
  1843.  
  1844.  
  1845. Technisches:
  1846.  
  1847.     WComm ist ein Standard Kommodity. Es besitzt alle Fähigkeiten und
  1848.     Funktionen, die für ein Commodity vorgeschrieben sind. Mit dem
  1849.     Tool Exchange kann man das Verhalten von WComm voll kontrollieren.
  1850.  
  1851.     Geschrieben und entwickelt wurde WComm mitfolgenden Programmen:
  1852.  
  1853.         AztecC Compiler Version 5.2a (® MANX),
  1854.         TurboText (® OXXI),
  1855.         SnoopDos (® Eddi Carroll)
  1856.         GadToolsBox (® Jaba Development),
  1857.         Enforcer (® Michael Sinz),
  1858.         DMake (® Matt Dillon)
  1859.  
  1860.  
  1861.     Meinen herzlichen Dank an die Programmierer dieser hervorragenden Programme.
  1862.  
  1863.     Meinen Dank auch an Mark Wesiheit, der mir bei der Fehlerbeseitung geholfen hat.
  1864.  
  1865.     Anstelle der mitgelieferten Startup-Routinen, benutze ich einen eigenen Startup,
  1866.     der alle 1.3 Features durch die noch besseren 2.0 (37++)ersetzt. Dies spart einen
  1867.     Haufen KBytes an Programm Code ein.
  1868.     Dennoch ist WComm relativ groß geworden. Die Größe aller Listen ist nur vom ver-
  1869.     fügbaren Speicher abhängig. Alle Strukturen werden dynamisch verwaltet.
  1870.  
  1871.  
  1872. Liste der Dateien:
  1873.  
  1874.     WComm               :  Englisches Programm
  1875.     WComm.info          :
  1876.     WComm_G             :  Deutsches Programm
  1877.     WComm_G.info        :
  1878.     WComm.doc           :  Die englische Dokumentation
  1879.     WComm.doc.info      :
  1880.     WComm.dok           :  Die deutsche Dokumentation
  1881.     WComm.dok.info      :
  1882.     WComm.guide         :  Englische AmigaGuide ® Datei
  1883.     WComm.guide.info    :
  1884.     WComm_G.guide       :  Deutsche AmigaGuide ® Datei
  1885.     WComm_G.guide.info  :
  1886.     History.log         :  Eine History-Datei
  1887.     History.log.info    :
  1888.     WComm.prefs         :  Eine Beipiel Konfigurationsdatei
  1889.     WComm.prefs.info    :
  1890.     ZWindow.prefs       :  Eine Beispiel Voreinstellerdatei
  1891.     ZWindow.prefs.info  :
  1892.     XWindow.prefs       :  Eine Beipiel Ausschlussdatei
  1893.     XWindow.prefs.info  :
  1894.     Notify.prefs        :  Eine Beispiel Nachrichtendatei
  1895.     Notify.prefs.info   :
  1896.  
  1897.  
  1898.  
  1899.  Viel Spaß ...
  1900.  
  1901.  
  1902. Adresse:
  1903.  
  1904.     Für alle Arten von Post, Bugs, Geschenke and Kritik ...
  1905.  
  1906.  
  1907.         Hans-Peter Günther
  1908.         Grüner Weg 5
  1909.         W-3501 Fuldatal 2
  1910.         GERMANY
  1911.  
  1912.     euer H.P.G
  1913.