home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / commodities / windowshuffler / fensterln.dok < prev    next >
Text File  |  1992-10-07  |  13KB  |  312 lines
  1.  
  2.                               Fensterln
  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. Mit   diesem  Commodity  können  Sie  die  folgenden  vier  Funktionen
  21. beliebigen Tasten zuweisen:
  22.  
  23.     nächstes Fenster aktivieren
  24.     vorheriges Fenster aktivieren
  25.     nächstes Fenster aktivieren und vor alle anderen bringen
  26.     vorheriges Fenster aktivieren und vor alle anderen bringen
  27.  
  28. Damit  können Sie dann durch die Fenster eines Bildschirmes "wandern".
  29. Zusätzlich  können Sie verschiedene Fenster vor den Aktionen bewahren,
  30. indem   Sie   Fenstertitel   aufzählen.   Sogenannte  Backdrop-Fenster
  31. (Hintergrundfenster)  können  vor  dem  Aktivieren  bewahrt werden und
  32. titellose  Fenster  können  ebenso  vor den Aktionen geschützt werden.
  33. Dieses  Commodity kann nicht uneingeschränkt sinnvoll gleichzeitig mit
  34. den   Commodities   Autopoint,   AutoActivate,   SMouse  oder  anderen
  35. Commodities,   die   das   Fenster  unter  dem  Mauspfeil  aktivieren,
  36. eingesetzt werden.
  37.  
  38.  
  39. Systemanforderungen:
  40. --------------------
  41. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  42. 37.*, sowie die commodities.library ab Version 37.*.
  43. Bitte überprüfen Sie dies:
  44. Rufen  Sie  im  Menü  der  Workbench  unter  "Workbench" den Menüpunkt
  45. "About" auf. Sie bekommen eine Meldung folgender Art:
  46.  
  47.     Kickstart Version ww.xxx
  48.     Workbench Version yy.zzz
  49.  
  50. Wenn  Sie  dieses  Menü und den Menüpunkt nicht finden, dann haben Sie
  51. ein  Betriebssystem  vor  Version  2.0.  Unter diesen Versionen ist es
  52. nicht  möglich,  Fensterln zu benutzen.  Bekommen Sie eine Meldung der
  53. obigen  Art, so vergewissern Sie sich bitte, daß dort für ww und yy 37
  54. oder höher steht.
  55.  
  56.  
  57. Und so startet man ein Commodity:
  58. ---------------------------------
  59. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  60. starten:  von der Workbench oder von der Shell aus.
  61.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  62. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  63. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  64. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  65. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  66. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  67. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  68. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  69. Commodity ändern können, wird später beschrieben.
  70.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  71. Commoditys,  während  es  bereits  läuft,  bewirkt,  daß das Commodity
  72. beendet  wird.   Da  es nicht sinnvoll wäre, ein Commodity zweimal zur
  73. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.
  74.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  75. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  76. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  77. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  78. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  79. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  80. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  81. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  82. ein ?  als ersten Parameter angeben:
  83.  
  84.                              Fensterln ?
  85.  
  86. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  87. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  88. erreicht man wiederum, daß es beendet wird.
  89.  
  90.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  91. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  92. einfügen:
  93.  
  94.                        <Pfad>Fensterln <Optionen>
  95.  
  96. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  97. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  98. anzugeben.   Folgendes  Beispiel  startet  Fensterln,  wenn es sich im
  99. Schubladen Tools der Boot-Diskette befindet:
  100.  
  101.                            Tools/Fensterln
  102.  
  103.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  104. starten,  ist,  das  Icon  von Mausweg in den Schubladen WBStartup der
  105. Boot-Diskette   (Workbench)   zu   verschieben.   Das  Commodity  wird
  106. dann   bei   jedem   Boot-Vorgang  gestartet,  als  hätten  Sie  einen
  107. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  108. das Tool-Type DONOTWAIT ergänzen.
  109.  
  110.  
  111. Benutzung von Exchange:
  112. -----------------------
  113. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  114. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  115. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  116. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  117. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  118. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  119. Titel, Beschreibung und Status angezeigt.
  120.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  121. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  122. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  123. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  124. "Show" öffnen lassen und mit "Hide" schließen lassen.
  125.  
  126.  
  127.                        Veränderbare Parameter:
  128.                        -----------------------
  129.  
  130. CX_Priority:
  131. ------------
  132. Mit dem Tool-Type oder der Befehlsoption CX_PRIORITY=<Zahl> können Sie
  133. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  134. bestimmen.  Setzen Sie für <Zahl> bitte einen dezimalen Wert ein.  Die
  135. voreingestellte Priorität ist 0.
  136.  
  137. NEXT_ACTIVE:
  138. ------------
  139. Mit  dem  Tool-Type  oder der Befehlsoption NEXT_ACTIVE=<Zeichenkette>
  140. bestimmen  Sie  die  Taste(nkombination),  mit der das nächste Fenster
  141. aktiviert  werden  soll.  <Zeichenkette> ist eine Eingabebeschreibung,
  142. wie   sie   weiter   unten   erläutert   werden.   Voreingestellt  ist
  143. "NEXT_ACTIVE=  lcommand lshift k" (linke Amigataste & linke Shifttaste
  144. & k).
  145.  
  146. PREV_ACTIVE:
  147. ------------
  148. Mit  dem  Tool-Type  oder der Befehlsoption PREV_ACTIVE=<Zeichenkette>
  149. bestimmen  Sie  die  Taste(nkombination),  mit  der  das vorhergehende
  150. Fenster    aktiviert    werden    soll.    <Zeichenkette>   ist   eine
  151. Eingabebeschreibung,  wie   sie   weiter   unten   erläutert   werden.
  152. Voreingestellt ist "PREV_ACTIVE=lcommand lshift j" (linke Amigataste &
  153. linke Shifttaste & j).
  154.  
  155. NEXT_BOTH:
  156. ----------
  157. Mit  dem  Tool-Type  oder  der  Befehlsoption NEXT_BOTH=<Zeichenkette>
  158. bestimmen  Sie die Taste, mit der das nächste Fenster aktiviert und in
  159. den   Vordergrund  gebracht  werden  soll.   <Zeichenkette>  ist  eine
  160. Eingabebeschreibung,   wie   sie   weiter   unten   erläutert  werden.
  161. Voreingestellt ist "NEXT_BOTH=lcommand k" (linke Amigataste & k).
  162.  
  163. PREV_BOTH:
  164. ----------
  165. Mit  dem  Tool-Type  oder  der  Befehlsoption PREV_BOTH=<Zeichenkette>
  166. bestimmen  Sie  die Taste, mit der das vorhergehende Fenster aktiviert
  167. und  in den Vordergrund gebracht werden soll.  <Zeichenkette> ist eine
  168. Eingabebeschreibung,   wie   sie   weiter   unten   erläutert  werden.
  169. Voreingestellt ist "PREV_BOTH=lcommand j" (linke Amigataste & j).
  170.  
  171. BACKDROP:
  172. ---------
  173. Mit  dem  Tool-Type oder der Befehlsoption BACKDROP=JA|NEIN können Sie
  174. wählen,  ob sogenannte Backdrop-Fenster (Hintergrundfenster) aktiviert
  175. werden sollen.  JA|NEIN bedeutet, daß Sie zwischen JA oder NEIN wählen
  176. können.   JA  bedeutet,  daß Backdrop-Fenster aktiviert werden sollen.
  177. Voreingestellt ist NEIN.  Backdrop-Fenster können nicht nach vorne ge-
  178. bracht werden.  Fensterln versucht dieses auch gar nicht erst.
  179.  
  180. OHNETITEL:
  181. ----------
  182. Mit  dem Tool-Type oder der Befehlsoption OHNETITEL=JA|NEIN können Sie
  183. wählen,  ob  Fenster  ohne  Titel aktiviert und/oder nach vorne geholt
  184. werden  sollen.   JA|NEIN bedeutet wieder JA oder NEIN.  Mit JA werden
  185. auch solche Fenster aktiviert bzw.  nach vorne geholt.  Voreingestellt
  186. ist NEIN.
  187.  
  188. DIESENICHT:
  189. -----------
  190. Mit  dem  Tool-Type  oder  der Befehlsoption DIESENICHT=<Zeichenkette>
  191. können   Sie  verhindern,  daß  Fenster  mit  bestimmten  Titel  nicht
  192. aktiviert  bzw.   nach vorne gebracht werden.  <Zeichenkette> ist eine
  193. Zeichenkette  mit  Jokern,  wie  AmigaDOS  Sie kennt.  Sie können alle
  194. Standard-AmigaDOS-Joker  benutzen,  die  Sie  z.B.  bei "dir" benutzen
  195. können.   Stellen Sie sich nur vor, die Fenstertitel wären Dateinamen.
  196. Bitte sehen Sie in Ihrem AmigaDOS-Handbuch die genaue Beschreibung von
  197. Jokern nach.  Wichtig:  Groß- und Kleinschreibung wird unterschieden!
  198.  
  199. Beispiele:
  200.  
  201. Die folgenden Titel sollen ausgeschlossen werden:  "Workbench", "Uhr",
  202. und  alle  Disk-Fenster  (Disk-Fenster  haben alle die Schlüsselwörter
  203. "full", "free", und "use" inne):
  204.  
  205.             DIESENICHT=(Workbench|Clock|#?full#?free#?use)
  206.  
  207. Wenn Sie nur Fenster aktivieren wollen, die mit dem Namen "Shell"
  208. beginnen:
  209.  
  210.                         DIESENICHT=~(Shell#?)
  211.  
  212.  
  213. Wenn  Sie  nur  das  Workbench-Fenster nicht nach vorne bringen wollen
  214. (falls dieses kein Hintergrundfenster ist):
  215.  
  216.                          DIESENICHT=Workbench
  217.  
  218.  
  219.  
  220.  
  221.                         Eingabebeschreibungen
  222.                         ---------------------
  223.                      (input description strings)
  224.  
  225. Mit   Eingabebeschreibungen  können  Sie  jede  Tastenkombination  der
  226. Tastatur  und  der  Maus  beschreiben, z.B.  das Drücken der Taste F1,
  227. Shift-F1  oder  Alt-F1  oder das Drücken der linken Maustaste zusammen
  228. mit Alt etc.  Darueberhinaus sind einige andere Ereignisse abfragbar.
  229.  
  230. Eingabebeschreibungen haben folgendes Muster:
  231.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  232.  
  233. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  234.  
  235. class   ("Klasse") ist einer der folgenden Ausdrücke:
  236.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  237.         diskremoved, diskinserted.
  238.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  239.  
  240. qual    ("Qualifizierer") ist einer der folgenden Ausdrücke:
  241.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  242.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  243.         relativemouse
  244.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  245.         als irrelevant angenommen werden soll.
  246.  
  247. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  248.         shift bedeutet linke oder rechte Shift-Taste
  249.         caps bedeutet Shift oder Caps-Lock
  250.         alt bedeutet linke oder rechte Alt-Taste
  251.  
  252. upstroke (wörtlich "upstroke")
  253.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  254.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  255.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  256.         voran, so zählt beides.
  257.  
  258. highmap ist einer der folgenden Ausdrücke:
  259.         comma, space, backspace, tab, enter, return, esc, del, up,
  260.         down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9,
  261.         f10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  262.  
  263. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  264.         Taste
  265.  
  266.  
  267. Noch einige Beispiele:
  268. ----------------------
  269.  
  270. Die  voreingestellten  Werte  (nur um zu zeigen, wie diese spezifziert
  271. werden müßten):
  272.  
  273. Fensterln CX_PRIORITY=0 "NEXT_ACTIVATE=lcommand lshift k"
  274. "PREV_ACTIVATE=lcommand lshift j" "NEXT_BOTH=lcommand k"
  275. "PREV_BOTH=lcommand j" BACKDROP=NEIN OHNETITLE=NEIN
  276.  
  277. Voreingestellte Werte übernehmen und zusätzlich nicht den Fenstertitel
  278. "Workbench":
  279.  
  280. Fensterln DIESENICHT=Workbench
  281.  
  282. zusätzlich Disk-Fenster verweigern:
  283.  
  284. Fensterln DIESENICHT=(Workbench|#?full#?free#?use)
  285.  
  286. Nur alle Fenster, die ein "W" als ersten Buchstaben im Titel haben,
  287. aktivieren; rechte Amigataste und Cursortasten benutzen:
  288.  
  289. Fensterln "NEXT_ACTIVATE=rcommand rshift down"
  290. "PREV_ACTIVATE=rcommand rshift up" "NEXT_BOTH=rcommand down"
  291. "PREV_BOTH=rcommand up" DIESENICHT=~(W#?)
  292.  
  293.  
  294.  
  295.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  296.      -----------------------------------------------------------
  297.                            Geschenke(!) an:
  298.                            ----------------
  299.  
  300.                             Stefan Sticht
  301.                           Bibereckerweg 40a
  302.                            D-8390 Passau 18
  303.                                  FRG
  304.  
  305. oder (besser) an eine der folgenden EMail-Adressen:
  306. sticht@edith.deg.sub.org
  307. Fido-Netz: Stefan Sticht (2:246/200.4)
  308.  
  309. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  310. Diese erhalten Sie z.B. mit dem Befehl "Version" in der Shell:
  311.                      Version [<path>]<commodity>
  312.