home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d4xx / d497 / back&front.lha / Back&Front / toBack&Front_D.dok < prev    next >
Encoding:
Text File  |  1991-06-06  |  12.9 KB  |  286 lines
  1.  
  2.                             toBack&Front_D
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. -----------------------------
  20. toBack&Front_D  ist ein Commodity, mit dem Sie schnell und einfach das
  21. Fenster   unter   dem  Mauspfeil  in  den  Vordergrund  bzw.   in  den
  22. Hintergrund   legen   können.    Wenn   der   Mauspfeil   über   einem
  23. Hintergrundfenster   (backdrop  window)  oder  der  Titelleiste  eines
  24. Bildschirmes  oder  keinem Fenster ist, wird der Bildschirm nach vorne
  25. bzw.   hinten  gelegt.   Zum  Beispiel  können  Sie  toBack&Front_D so
  26. installieren, daß ein Doppel-Klick auf die linke Maustaste das Fenster
  27. unter  dem  Mauspfeil  in den Vordergrund legt.  Oder wenn Sie dreimal
  28. die  linke Maustaste drücken.  Sie können es auch so installieren, daß
  29. ein Doppel-Klick, während Sie die linke Alt-Taste gedrückt halten, das
  30. Fenster  in  den Hintergrund legt.  Welche Eingabe (z.B.  Eingabe über
  31. Tastatur  oder Maus) ein Fenster oder einen Bildschirm nach vorne oder
  32. hinten legt, können Sie einstellen.
  33.  
  34. Systemanforderungen:
  35. --------------------
  36. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  37. 37.*.   Bitte prüfen Sie dies, indem Sie in der Shell Version eingeben
  38. oder  im  Workbench  Menü  About  aufrufen.   Außerdem  muß  sich  die
  39. commodities.library  in Ihrem Verzeichnis libs:  befinden.  Überprüfen
  40. Sie  dies  bitte,  indem  Sie  in  der  Shell  den  Befehl "dir libs:"
  41. eingeben.    Bitte   beachten   Sie,   daß   Sie  die  mindestens  die
  42. commodities.library  Version  37.27  benutzen  müssen, wenn Sie andere
  43. Eingaben als Tastatureingaben abfragen wollen.
  44.  
  45. Und so startet man ein Commodity:
  46. ---------------------------------
  47. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  48. starten:  von der Workbench oder von der Shell aus.
  49.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  50. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  51. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  52. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  53. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  54. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  55. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  56. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  57. Commodity ändern können, wird später beschrieben.
  58.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  59. Commoditys,  während  es  bereits  läuft,  bewirkt,  daß das Commodity
  60. beendet  wird. Da  es  nicht  sinnvoll wäre toBack&Front_D zweimal zur
  61. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.
  62.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  63. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  64. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  65. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  66. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  67. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  68. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  69. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  70. ein ?  als ersten Parameter angeben:
  71.  
  72.                            toBack&Front_D ?
  73.  
  74. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  75. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  76. erreicht man wiederum, daß es beendet wird.
  77.  
  78.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  79. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  80. einfügen:
  81.  
  82.                    <Pfad>toBack&Front_D <Optionen>
  83.  
  84. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  85. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  86. anzugeben.   Folgendes  Beispiel  startet  Mausweg,  wenn  es  sich im
  87. Schubladen Tools der Boot-Diskette befindet:
  88.  
  89.                          Tools/toBack&Front_D
  90.  
  91.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  92. starten,  ist,  das  Icon  von Mausweg in den Schubladen WBStartup der
  93. Boot-Diskette   (Workbench)   zu   verschieben.   Das  Commodity  wird
  94. dann   bei   jedem   Boot-Vorgang  gestartet,  als  hätten  Sie  einen
  95. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  96. das Tool-Type DONOTWAIT ergänzen.
  97.  
  98. Benutzung von Exchange:
  99. -----------------------
  100. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  101. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  102. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  103. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  104. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  105. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  106. Titel, Beschreibung und Status angezeigt.
  107.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  108. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  109. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  110. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  111. "Show"  öffnen lassen und mit "Hide" schließen lassen.  toBack&Front_D
  112. hat kein Fenster, das geöffnet werden könnte.
  113.  
  114.  
  115.                        Veränderbare Parameter:
  116.                        -----------------------
  117.  
  118. CX_Priority:
  119. ------------
  120. Mit  dem  Tool-Type  oder der Befehlsoption CX_PRIORITY=<p> können Sie
  121. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  122. bestimmen.   Setzen  Sie  für <p> bitte einen positiven dezimalen Wert
  123. ein. Die voreingestellte Priorität ist 0.
  124.  
  125. Front_Action:
  126. -------------
  127. Mit   dem   Tool-Type  oder  der  Befehlsoption  FRONT_ACTION=<Aktion>
  128. bestimmen  Sie,  welche  Eingabe  das Fenster unter dem Mauspfeil bzw.
  129. den   Bildschirm   in   den   Vordergrund  legt.   <Aktion>  ist  eine
  130. Eingabebeschreibung    wie    unten   erklärt.    Voreingestellt   ist
  131. "FRONT_ACTION=rawmouse leftbutton lbuttoncode" (linke Maustaste).
  132.  
  133. Front_Clicks:
  134. -------------
  135. Mit  dem  Tool-Type  oder der Befehlsoption FRONT_CLICKS=<n> bestimmen
  136. Sie,  wieviele Eingaben eintreffen müssen, um etwas in den Vordergrund
  137. zu  legen.   Zwei  Eingaben  müssen  jeweils paarweise innerhalb einer
  138. Doppel-Klick-Dauer  eintreffen.  Die Doppel-Klick-Dauer können Sie mit
  139. den  Input-Preferences  einstellen.   Wenn  Sie z.B.  ein Fenster nach
  140. vorne  holen  wollen,  indem  Sie  einen  Doppel-Klick  mit der linken
  141. Maustaste in dem Fenster machen, müssen Sie Front_action auf die linke
  142. Maustaste und Front_clicks=2 einstellen. Wenn Sie einen Dreifach-Klick
  143. abfragen  wollen,  stellen Sie Front_clicks=3 ein usw.  Voreingestellt
  144. ist 2.
  145.  
  146. Front_Remove:
  147. -------------
  148. Mit   dem   Tool-Type   oder  der  Befehlsoption  FRONT_REMOVE=JA|NEIN
  149. bestimmen  Sie, ob die Nachricht über das Eingabeereignis (inputevent)
  150. für  die  Front_Action  gelöscht  werden  und  somit  nicht  an andere
  151. Programme   weitergereicht  werden  soll.   Wenn  Sie  z.B.   mit  der
  152. Front_Action  einen Doppel_Klick der linken Maustaste abfabgen wollen,
  153. können  Sie  die  Nachricht  nicht  löschen lassen, das Sie sonst kein
  154. Programm  mehr  durch einen Doppel-Klick auf dessen Piktogramm starten
  155. können.   Anderseits  ist  es  nützlich, die Nachricht über die Aktion
  156. löschen  zu  lassen,  wenn die Aktion das Drücken der linken Alt-Taste
  157. zusammen  mit  der Taste A sein soll, würde in einem Shell-Fenster das
  158. Zeichen  æ  (Abhängig  von  der Tastaturbelegung) erscheinen, wenn Sie
  159. dieses  nach  vorne holen.  Lassen Sie die Nachricht löschen, wird nur
  160. das  Fenster  nach  vorne  geholt.  JA|NEIN steht für entweder JA oder
  161. NEIN, nichts sonst.  Voreingestellt ist FRONT_REMOVE=NEIN.
  162.  
  163. Back_Action:
  164. ------------
  165. Mit   dem   Tool-Type   oder  der  Befehlsoption  BACK_ACTION=<Aktion>
  166. bestimmen  Sie,  welche  Eingabe  das Fenster unter dem Mauspfeil bzw.
  167. den  Bildschirm in den Hintergrund legt.  <Aktion> ist eine Eingabebe-
  168. schreibung   wie  unten  erklärt.   Voreingestellt  ist  "BACK_ACTION=
  169. rawmouse  lalt  leftbutton  lbuttoncode" (linke Maustaste zugleich mit
  170. linker Alt-Taste).
  171.  
  172. Back_Clicks:
  173. ------------
  174. Mit  dem  Tool-Type  oder  der Befehlsoption BACK_CLICKS=<n> bestimmen
  175. Sie,  wieviele Eingaben eintreffen müssen, um etwas in den Hintergrund
  176. zu legen.  Funktioniert analog zu Front_Clicks.  Voreingestellt ist 2.
  177.  
  178. Back_Remove:
  179. ------------
  180. Mit dem Tool-Type oder der Befehlsoption BACK_REMOVE=JA|NEIN bestimmen
  181. Sie,  ob  die  Nachricht über das Eingabeereignis (inputevent) für die
  182. Back_Action  gelöscht  werden  und  somit  nicht  an  andere Programme
  183. weitergereicht  werden  soll,  analog zu Front_Remove.  Voreingestellt
  184. ist BACK_REMOVE=ja.
  185.  
  186.  
  187.                         Eingabebeschreibungen
  188.                         ---------------------
  189.                      (input description strings)
  190.  
  191. Mit   Eingabebeschreibungen   können   Sie   fast  jede  Eingabeaktion
  192. beschreiben,  z.B.   die Aktion lshift f1.  Dies heißt, daß die Aktion
  193. das drücken der Taste F1 zusammen mit der linken Shift-Taste ist.  Bei
  194. diesem Commodity öffnet die Aktion das Fenster des Commoditys.
  195.  
  196. Eingabebeschreibungen haben folgendes Muster:
  197.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  198.  
  199. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  200.  
  201. class   ("Klasse") ist einer der folgenden Ausdrücke:
  202.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  203.         diskremoved, diskinserted.
  204.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  205.  
  206. qual    (qualifier, "Qualifizierer") ist einer der folgenden Ausdrücke:
  207.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  208.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  209.         relativemouse
  210.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  211.         als irrelevant angenommen werden soll.
  212.  
  213. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  214.         shift bedeutet linke oder rechte Shift-Taste
  215.         caps bedeutet Shift oder Caps-Lock
  216.         alt bedeutet linke oder rechte Alt-Taste
  217.  
  218. upstroke (wörtlich "upstroke")
  219.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  220.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  221.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  222.         voran, so zählt beides.
  223.  
  224. highmap ist einer der folgenden Ausdrücke:
  225.         comma, space, backspace, tab, enter, return, esc, del, up, down,
  226.         right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10,
  227.         0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  228.         lbuttoncode¹, mbuttoncode¹, rbuttoncode¹
  229.  
  230. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  231.         Taste
  232.  
  233. ¹ diese Schlüsselwörter sind nicht standardmäßig in der
  234.   commodities.library bis einschließlich Version 37.27 verfügbar;
  235.   sie werden nur von toBack&Front_D verstanden und benutzt
  236.  
  237.  
  238. Einige komplette Beispiele:
  239. ---------------------------
  240.  
  241. Fenster nach vorne mit linker Alt-Taste und F1, keine Aktion für "nach
  242. hinten":
  243. toback&Front_D "front_action=lalt f1" front_clicks=1 front_remove=ja
  244.                "back_action="
  245.  
  246. Fenster  nach  vorne,  nachdem  drei mal in das Fenster mit der linken
  247. Maustaste  (linke  Maustaste ist voreingestellt!) gedrückt wurde, nach
  248. hinten,  wenn  zweimal  die  mittlere  Maustaste  gedrueckt wurde (Sie
  249. benötigen natürlich eine Drei-Tasten-Maus!):
  250. toback&Front_D "back_action=rawmouse midbutton mbuttoncode"
  251.                back_clicks=2 front_clicks=3
  252.  
  253. Fenster    nach   vorne,   wenn   Sie   mit   der   linken   Maustaste
  254. (Voreingestellt)einen  Doppel-Klick  machen,  während  Sie  die  linke
  255. Alt-Taste gedrückt halten, nach hinten, wenn Sie die linke Amiga-Taste
  256. gedrückt halten:
  257. toback&Front_D "front_action=rawmouse lalt leftbutton lbuttoncode"
  258.                "back_action=rawmouse lcommand leftbutton lbuttoncode"
  259.  
  260. Noch ein amüsantes Beispiel:
  261. Nach vorne, wenn Sie eine Diskette aus einem Diskettenlaufwerk nehmen,
  262. nach hinten, wenn Sie eine einlegen:
  263. toback&Front front_action=diskremoved front_clicks=1 front_remove=nein
  264.              back_action=diskinserted back_clicks=1 back_remove=nein
  265.  
  266.  
  267.  
  268.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  269.      -----------------------------------------------------------
  270.                            Geschenke(!) an:
  271.                            ----------------
  272.  
  273.                             Stefan Sticht
  274.                           Bibereckerweg 40a
  275.                            D-8390 Passau 18
  276.                                  FRG
  277.  
  278. oder (besser) an eine der folgenden EMail-Adressen:
  279. Internet: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht@rutgers.EDU
  280.       or: IWSTICHT@ibm.rz.uni-passau.de
  281. Fido-Net: Stefan Sticht (2:242/16)
  282.  
  283. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  284. Diese erhalten Sie z.B. mit dem Befehl "Version":
  285.                      Version [<path>]<commodity>
  286.