home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / commodities / toback&front / toback&front_d.dok < prev    next >
Text File  |  1992-10-07  |  15KB  |  332 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.  
  19.                              Beschreibung
  20.  
  21. toBack&Front_D  ist ein Commodity, mit dem Sie schnell und einfach das
  22. Fenster   unter   dem  Mauspfeil  in  den  Vordergrund  bzw.   in  den
  23. Hintergrund   legen   können.    Wenn   der   Mauspfeil   über   einem
  24. Hintergrundfenster   (backdrop  window)  oder  der  Titelleiste  eines
  25. Bildschirmes  oder  keinem Fenster ist, wird der Bildschirm nach vorne
  26. bzw.   hinten  gelegt.   Zum  Beispiel  können  Sie  toBack&Front_D so
  27. installieren, daß ein Doppel-Klick auf die linke Maustaste das Fenster
  28. unter dem Mauspfeil in den Vordergrund legt. Oder Sie konfigurieren es
  29. so, daß Sie dreimal die linke Maustaste drücken müssen. Sie können  es
  30. auch so installieren, daß ein  Doppel-Klick,  während  Sie  die  linke
  31. Alt-Taste gedrückt halten, das Fenster in den Hintergrund legt. Welche
  32. Eingabe (z.B. Eingabe über Tastatur oder Maus) ein Fenster oder  einen
  33. Bildschirm nach vorne oder hinten legt, können Sie einstellen.
  34.  
  35.  
  36.  
  37.                          Systemanforderungen
  38.  
  39. toBack&Front_D benötigt AmigaOS  2.0,  mindestens  Kickstart  V37.175.
  40. Diese Version wird  auch  als  AmigaOS  2.04  bezeichnet.  Machen  Sie
  41. einfach folgendes: Rufen Sie den Menüpunkt About der Workbench auf. Es
  42. öffnet sich ein Requester, der Ihnen die Version Ihrer  Kickstart  und
  43. Workbench verrät. Steht bei Kickstart eine Versionsnummer kleiner  als
  44. 37.175, so sollten Sie sich unbedingt die neueste Kickstart  besorgen,
  45. und nicht nur, um  toBack&Front_D  testen  zu  können.  Kickstart  und
  46. Workbench 2.04 sind im Fachhandel (zumindest demnächst) erhältlich.
  47.  
  48.  
  49.                      So starten Sie toBack&Front
  50.  
  51. Von der Workbench starten Sie toBack&Front_D durch  einen  Doppelklick
  52. auf  sein  Piktogramm.  Verlassen  können   Sie   toBack&Front   durch
  53. nochmaliges Starten oder mit Hilfe der Kill-Taste von Exchange. Wollen
  54. Sie toBack&Front_D bei jedem Bootvorgang automatisch  starten  lassen,
  55. so kopieren Sie einfach dessen Piktogramm in den Schubladen  WBStartup
  56. Ihrer Workbench.
  57.  
  58. In der Shell starten Sie toBack&Front_D mit
  59.  
  60.                          <Pfad>toBack&Front_D
  61.  
  62. Setzen Sie bitte für <Pfad> den Pfad zu Ihrer Kopie von toBack&Front_D
  63. ein, z.B. SYS:Tools/Commodities/. Starten Sie toBack&Front_D mit
  64.  
  65.                     Run >NIL: <Pfad>toBack&Front_D
  66.  
  67. können Sie  anschließend  mit  der  Shell  weiterarbeiten  oder  diese
  68. schließen. Obige Zeile können Sie auch  in  die  Datei  s:User-Startup
  69. eintragen, um toBack&Front_D auf diese Weise bei jedem Bootvorgang  zu
  70. starten. Verlassen können Sie toBack&Front_D wieder durch  nochmaliges
  71. Starten, egal ob von der Workbench oder der Shell aus, oder mit  Hilfe
  72. von Exchange. Haben Sie toBack&Front_D in der Shell gestartet,  können
  73. Sie es auch mit Hilfe der DOS Befehle Status und Break beenden.  Geben
  74. Sie Status ein und suchen Sie in der zweiten  Spalte  die  Nummer  des
  75. Prozesses von toBack&Front.  Mit  Break  <Nummer>  C  können  Sie  nun
  76. toBack&Front beenden.
  77.  
  78.  
  79.                                Exchange
  80.  
  81. Exchange ist das  Programm,  mit  dem  Commodities  verwaltet  werden.
  82. Starten Sie Exchange, das sich für gewöhnlich im Utilities  Schubladen
  83. Ihrer  Boot-Diskette  befindet,  mit  einem  Doppelklick  auf   dessen
  84. Piktogramm. Es wird Ihnen nun eine Liste aller  laufenden  Commodities
  85. angezeigt, aus der Sie das entsprechende Commodity  auswählen  können.
  86. Unter dieser Liste wird nach  Auswahl  eines  Commodities  automatisch
  87. dessen Titel, Beschreibung und Status angezeigt.
  88. Sie  können  nun  Commodities  mit  "Kill"  beenden,   mit   "Disable"
  89. vorübergehend ausschalten und mit "Enable"  wieder  einschalten.  Wenn
  90. das Commodity ein Fenster öffnen kann, indem für gewöhnlich  Parameter
  91. eingestellt werden, können Sie dieses Fenster mit "Show" öffnen lassen
  92. und mit "Hide" schließen lassen. toBack&Front_D hat kein Fenster,  das
  93. geöffnet werden könnte.
  94.  
  95.  
  96.                                Optionen
  97.  
  98. Optionen geben Sie folgendermaßen an:
  99. Starten Sie toBack&Front von der Workbench, werden Optionen mit  Hilfe
  100. von Tool Types gewählt. Klicken Sie das Piktogramm von  toBack&Front_D
  101. einmal mit der linken Maustaste an und wählen Sie  dann  im  Menü  der
  102. Workbench den Menüpunkt Information aus. In dem sich öffnenden Fenster
  103. sehen Sie die  bereits  eingestellten  Tool  Types  und  können  diese
  104. ändern, löschen und neue hinzufügen. Genaueres darüber lesen Sie bitte
  105. in Ihrer Workbenchbeschreibung nach. Wollen Sie z.B.  die  Anzahl  der
  106. Mausklicks, die ein Fenster nach vorne  holen,  auf  drei  setzen,  so
  107. ändern  Sie  oder  fügen  Sie  einfach  folgendes  Tool  Type   hinzu:
  108. Front_Clicks=3.
  109. In der Shell hängen Sie einfach die Optionen an den Programmnamen  an,
  110. jeweils getrennt durch Leerzeichen. Erwartet eine Option eine Zeichen-
  111. kette und enthält diese Leerzeichen, so muß die ganze Zeichenkette mit
  112. Anführungszeichen umgeben werden, z.B. Front_Aktion="shift  f1".  Dies
  113. ist  nur  in  der  Shell  notwendig,  nicht  bei   Tool   Types.   Die
  114. Befehlsschablone für toBack&Front_D sieht folgendermaßen aus:
  115.  
  116.  CX_PRI0RITY/K/N,BACK_AKTI0N/K,BACK_CLICKS/K/N,BACK_REM0VE/S,
  117.  BACK_LEFTBUTT0NUP/S,FR0NT_AKTI0N/K,FR0NT_CLICKS/K/N,FR0NT_REM0VE/S,
  118.  FR0NT_LEFTBUTT0NUP/S
  119.  
  120. Groß- und Kleinschreibung spielen bei beiden Arten keine  Rolle.  Hier
  121. die einzelnen Option mit Beschreibung.
  122.  
  123.                              CX_Priority
  124.  
  125. Mit  CX_PRIORITY=<Zahl>  können  Sie  die  Priorität  des  Commodities
  126. innerhalb der Liste der Commodities bestimmen. Setzen Sie  für  <Zahl>
  127. bitte einen dezimalen Wert ein. Die voreingestellte Priorität ist 0.
  128.  
  129.                              Front_Aktion
  130.  
  131. FRONT_Aktion=<Zeichenkette> bestimmt, welche Eingabe das Fenster unter
  132. dem  Mauspfeil  bzw.  den  Bildschirm   in   den   Vordergrund   legt.
  133. <Zeichenkette>  ist  eine  Eingabebeschreibung  wie   unten   erklärt.
  134. Voreingestellt   ist   "rawmouse   leftbutton   lbuttoncode"    (linke
  135. Maustaste).
  136.  
  137.                              Front_Clicks
  138.  
  139. Mit FRONT_CLICKS=<Zahl> bestimmen Sie,  wieviele  Eingaben  eintreffen
  140. müssen, um etwas in den Vordergrund zu  legen.  Zwei  Eingaben  müssen
  141. jeweils paarweise innerhalb einer Doppel-Klick-Dauer  eintreffen.  Die
  142. Doppel-Klick-Dauer können Sie mit  den  Input-Preferences  einstellen.
  143. Wenn Sie z.B. ein Fenster nach vorne holen  wollen,  indem  Sie  einen
  144. Doppel-Klick mit der linken Maustaste in dem  Fenster  machen,  müssen
  145. Sie  Front_Aktion  auf  die   linke   Maustaste   und   Front_clicks=2
  146. einstellen. Wenn Sie einen Dreifach-Klick abfragen wollen, stellen Sie
  147. Front_clicks=3 ein usw. Voreingestellt ist 2.
  148.  
  149.  
  150.                              Front_Remove
  151.  
  152. Die Angabe von  FRONT_REMOVE  bewirkt,  daß  die  Nachricht  über  das
  153. Eingabeereignis (input event) für die Front_Aktion gelöscht und  nicht
  154. an andere  Programme  weitergereicht  wird.  Wenn  Sie  z.B.  mit  der
  155. Front_Aktion einen Doppel-Klick der linken Maustaste abfragen  wollen,
  156. können Sie die Nachricht nicht  löschen  lassen,  da  Sie  sonst  kein
  157. Programm mehr durch einen Doppel-Klick auf dessen  Piktogramm  starten
  158. können. Anderseits ist es nützlich,  die  Nachricht  über  die  Aktion
  159. löschen zu lassen, wenn die Aktion das Drücken  der  linken  Alt-Taste
  160. zusammen mit der Taste A sein soll, würde in einem  Shell-Fenster  das
  161. Zeichen æ (Abhängig von der  Tastaturbelegung)  erscheinen,  wenn  Sie
  162. dieses nach vorne  holen.  Diese  Option  ist  mit  dem  Schlüsselwort
  163. Front_Remove einschaltbar.
  164.  
  165.                           Front_LeftButtonUp
  166.  
  167. Mit dem Schlüsselwort Front_LeftButtonUp  aktivieren  sie  einen  ganz
  168. speziellen Modus: Wenn die linke Maustaste als  Qualifizierer  benutzt
  169. wird und nicht als Kode, also bei der Front_Aktion die linke Maustaste
  170. gedrückt gehalten werden  muß,  aber  der  eigentliche  Auslöser  eine
  171. andere Taste ist, gibt es Probleme,  wenn  Sie  die  Aktion  auslösen,
  172. während sich der Mauspfeil über der Titelzeile eines Bildschirmes oder
  173. Fensters befindet. Über Titelzeilen hat eine gedrückte linke Maustaste
  174. bereits eine Bedeutung: das Verschieben  von  Fenstern  bzw.  Schirmen
  175. wird ermöglicht. In diesem Fall  wird  ein  Fenster  oder  Schirm  bei
  176. erfolgter Front_Aktion erst nach dem Loslassen  der  linken  Maustaste
  177. nach vorne gebracht. Wenn Sie dies stört, können Sie mit dieser Option
  178. ein Loslassen der linken Maustaste simulieren, Sie brauchen Sie  nicht
  179. explizit loszulassen. Diese  Option  spielt  eigentlich  nur  bei  der
  180. Back_Aktion "linke Maustaste  gedrückt  halten  und  rechte  Maustaste
  181. drücken"  eine  Rolle  und  wird  bei   der   Front_Aktion   nur   der
  182. Vollständigkeit wegen angeboten. Per Voreinstellung ist  diese  Option
  183. ausgeschaltet.
  184.  
  185.                              Back_Aktion
  186.  
  187. Mit Back_Aktion=<Zeichenkette> bestimmen die Eingabe, die das  Fenster
  188. unter  dem  Mauspfeil  bzw.  Bildschirm  in  den   Hintergrund   legt.
  189. <Zeichenkette> ist wieder eine Eingabebeschreibung wie unten  erklärt.
  190. Voreingestellt ist "rawmouse leftbutton  rbutton  rbuttoncode"  (linke
  191. Maustaste gedrückt halten und dann rechte Maustaste).
  192.  
  193.                              Back_Clicks
  194.  
  195. BACK_CLICKS=<Zahl> bestimmt die Anzahl der  Eingaben,  die  eintreffen
  196. müssen, um etwas in den Hintergrund zu legen, analog zu  Front_Clicks.
  197. Voreingestellt ist 1.
  198.  
  199.                              Back_Remove
  200.  
  201. Analog zu Front_Remove: es wird die  Nachricht  über  die  Back_Aktion
  202. gelöscht. Bitte geben Sie diese Option explizit mit an, wenn  Sie  die
  203. voreingestellte Aktion für "nach hinten" benutzen.
  204.  
  205.                           Back_LeftButtonUp
  206.  
  207. Wie bei Front_LeftButtonUp können Sie mit dieser Option ein  Loslassen
  208. der  linken  Maustaste  simulieren.  Wenn  Sie   die   voreingestellte
  209. Back_Aktion  "linke  Maustaste  gedrückt  halten  und  rechte   einmal
  210. drücken" benützen, werden  Sie  sicher  schon  folgendes  festgestellt
  211. haben: Wenn Sie die Aktion ausgeführt  haben,  während  der  Mauspfeil
  212. über der Titelleiste eine Fensters oder Schirmes war, müssen Sie  erst
  213. die linke Maustaste loslassen, damit der Schirm oder  das  Fenster  in
  214. den Hintergrund gelegt wird.  Mit  dieser  Option  können  Sie  dieses
  215. Loslassen der linken Maustaste simulieren, falls  sich  der  Mauspfeil
  216. über der Titelleiste eines Schirmes oder Fensters befindet und wenn in
  217. der   Beschreibung   der   Back_Aktion    "leftbutton"    und    nicht
  218. "leftbuttoncode" vorkommt.
  219.  
  220.  
  221.                         Eingabebeschreibungen
  222.                      (input description strings)
  223.  
  224. Mit  Eingabebeschreibungen  können  Sie  jede  Tastenkombination   der
  225. Tastatur und der Maus beschreiben, z.B.  das  Drücken  der  Taste  F1,
  226. Shift-F1 oder Alt-F1 oder das Drücken der  linken  Maustaste  zusammen
  227. mit Alt etc. Darueberhinaus sind einige andere Ereignisse abfragbar.
  228. Eingabebeschreibungen haben folgendes Muster:
  229.  
  230.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  231.  
  232.  (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  233.  
  234. class   ("Klasse") ist eines der folgenden Schlüsselwörter:
  235.         rawkey, rawmouse, timer, diskremoved, diskinserted.
  236.         Wenn die Klasse nicht angegeben wird, wird rawkey genommen.
  237.  
  238. qual    ("Qualifizierer") ist eines der folgenden Schlüsselwörter:
  239.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  240.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  241.         relativemouse
  242.         Ein vorgestelltes "-" bedeutet, daß der folgende Qualifizierer
  243.         irrelevant sein soll.
  244.  
  245. syn     ("Synonym") ist eines dieser Schlüsselwörter: shift, caps, alt
  246.         shift bedeutet linke oder rechte Shift-Taste
  247.         caps bedeutet Shift oder Caps-Lock
  248.         alt bedeutet linke oder rechte Alt-Taste
  249.  
  250. upstroke (wörtlich "upstroke")
  251.         Wenn dieses Schlüsselwort fehlt, zählt das Drücken einer Taste
  252.         für die Klassen rawmouse und rawkey. Wenn es vorhanden ist,
  253.         zählt das Loslassen einer Taste. Stellt man ein "-" voran, so
  254.         zählt beides.
  255.  
  256. highmap ist eines der folgenden Schlüsselwörter:
  257.         comma, space, backspace, tab, enter, return, esc, del, up,
  258.         down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9,
  259.         f10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  260.         lbuttoncode¹, mbuttoncode¹, rbuttoncode¹
  261.  
  262. ansicode ein einzelnes Zeichen steht genau für die entsprechende Taste
  263.  
  264. ¹ Diese Schlüsselwörter erkennt nur toBack&Front
  265.  
  266.  
  267.                            Einige Beispiele
  268.  
  269. Probieren Sie zuerst folgendes:
  270.  
  271. toback&Front_D back_remove back_leftbuttonup
  272.  
  273. Nach vorne mit Doppel-Klick der linken Masutaste und nach  hinten  mit
  274. linker Maustaste gedrückt plus rechter Maustaste. Die Back_Aktion wird
  275. zusätzlich gelöscht und ein Loslassen der linken Maustaste  simuliert.
  276. Die  Optionen  Back_remove  und  Back_leftbuttonup  sollten  Sie   bei
  277. Verwendung  der  voreingestellten  Back_Aktion  mit   angeben.   Diese
  278. Optionen sind per Voreinstellung ausgeschaltet und müssen durch Angabe
  279. der Schlüsselwörter erst eingeschaltet werden!
  280.  
  281. toback&Front_D front_aktion="lalt f1" front_clicks=1 front_remove
  282.                back_aktion=""
  283. Nach vorne mit linker Alt-Taste und F1, keine Aktion für nach hinten.
  284.  
  285. toback&Front_D back_aktion="rawmouse midbutton mbuttoncode"
  286.                back_clicks=1 back_remove
  287. Nach vorne mit zweimal linke  Maustaste,  nach  hinten  mit  mittlerer
  288. Maustaste (Sie benötigen natürlich eine Drei-Tasten-Maus!).
  289.  
  290. toback&Front_D front_aktion="rawmouse lalt leftbutton lbuttoncode"
  291.                back_aktion="rawmouse lcommand leftbutton lbuttoncode"
  292.                front_remove back_remove font_clicks=1
  293. Nach vorne mit linker Alt-Taste und linker Maustaste, nach hinten mit
  294. linker Amiga-Taste und linker Maustaste.
  295.  
  296. Noch ein wenig sinnvolles Beispiel:
  297. Nach vorne, wenn Sie eine Diskette aus einem Diskettenlaufwerk nehmen,
  298. nach hinten, wenn Sie eine einlegen:
  299. toback&Front_D front_aktion=diskremoved front_clicks=1
  300.                back_aktion=diskinserted
  301.  
  302.  
  303.                          Versionengeschichte
  304.  
  305. V1.09   Auswertung der Optionen wurde geändert, dadurch wurde das Pro-
  306.         gramm kürzer, löst sich aber jetzt nicht selbst von der Shell.
  307.         Namen der Optionen wurden geändert. Voreingestellte Aktion für
  308.         Back_Aktion wurde geändert. Neue Optionen
  309.         (Back|Front)_Leftbuttonup hinzugefügt. Trotz der Erweiterungen
  310.         ist diese Version kleiner als V1.03.
  311.  
  312. V1.08   bei Verwendung der linken und/oder rechten Maustaste gab es
  313.         noch einen Lock-Up
  314.  
  315. Ältere Versionen sind in toBack&Front.c kurz beschrieben.
  316.  
  317.  
  318.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  319.                             Geschenke an:
  320.  
  321.                             Stefan Sticht
  322.                           Bibereckerweg 40a
  323.                            D-8390 Passau 18
  324.                                  FRG
  325.  
  326. oder (besser) an eine der folgenden EMail-Adressen:
  327. sticht@edith.deg.sub.org
  328. Fido-Netz: Stefan Sticht (2:246/200.4)
  329.  
  330. Bitte nennen Sie bei einem Fehlerreport die Versionsnummer.
  331.  
  332.