home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / commodities / newshellcx / newshellcx_d.dok < prev    next >
Text File  |  1991-11-18  |  12KB  |  274 lines
  1.  
  2.                              NewShellCX_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. Mit  NewShellCX_D  (das  _D  für  die  deutsch Version) können Sie per
  21. Tastendruck  eine neue Shell öffnen oder ein anderes Programm starten.
  22. Die  Tastenkombination  und das zu startende Programm können Sie fest-
  23. legen.   Außerdem können Sie einen öffentlichen Schrim (public screen)
  24. spezifizieren,  der  mit  dem  Tastendruck in den Vordergrund gebracht
  25. wird.   Ebenso  können Sie angeben, ob der Schirm relativ oder absolut
  26. bewegt werden soll.
  27.  
  28.  
  29. Systemanforderungen:
  30. --------------------
  31. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  32. 37.*, sowie die commodities.library ab Version 37.*.
  33. Bitte überprüfen Sie dies:
  34. Rufen  Sie  im  Menü  der  Workbench  unter  "Workbench" den Menüpunkt
  35. "About" auf. Sie bekommen eine Meldung folgender Art:
  36.  
  37.                        Kickstart Version ww.xxx
  38.                        Workbench Version yy.zzz
  39.  
  40. Wenn  Sie  dieses  Menü und den Menüpunkt nicht finden, dann haben Sie
  41. ein  Betriebssystem  vor  Version  2.0.  Unter diesen Versionen ist es
  42. nicht  möglich, NewShellCX zu benutzen.  Bekommen Sie eine Meldung der
  43. obigen  Art, so vergewissern Sie sich bitte, daß dort für ww und yy 37
  44. oder höher steht.
  45.  
  46.  
  47. Und so startet man ein Commodity:
  48. ---------------------------------
  49. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  50. starten:  von der Workbench oder von der Shell aus.
  51.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  52. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  53. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  54. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  55. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  56. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  57. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  58. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  59. Commodity ändern können, wird später beschrieben.
  60.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  61. Commoditys,  während es bereits läuft, bewirkt, daß das Commodity 
  62. beendet  wird.   Da  es  nicht  sinnvoll wäre NewShellCX_D zweimal zur
  63. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.
  64.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  65. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  66. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  67. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  68. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  69. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  70. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  71. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  72. ein ?  als ersten Parameter angeben:
  73.  
  74.                             NewShellCX_D ?
  75.  
  76. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  77. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  78. erreicht man wiederum, daß es beendet wird.
  79.  
  80.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  81. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  82. einfügen:
  83.  
  84.                Run >NIL: <Pfad>NewShellCX_D <Optionen>
  85.  
  86. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  87. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  88. anzugeben.   Folgendes  Beispiel startet NewShellCX_D, wenn es sich
  89. im  Schubladen  Tools  der  Boot-Diskette  befindet:
  90.  
  91.                      Run >NIL: Tools/NewShellCX_D
  92.  
  93.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  94. starten,  ist,  das  Icon von NewShellCX_D in den Schubladen WBStartup
  95. der Boot-Diskette (Workbench) zu verschieben.  Das Commodity wird dann
  96. bei jedem Boot-Vorgang gestartet, als hätten Sie einen Doppelklick auf
  97. das  Icon  durchgeführt.   Allerdings müssen Sie im Icon das Tool-Type
  98. DONOTWAIT ergänzen.
  99.  
  100. Das  war  die  allgemeine Beschreibung, wie man ein Commodity started.
  101. Will  man  aber mit NewShellCX_D eine neue Shell öffnen, ist ein Start
  102. über  die  Workbench (oder über WBStartup) generell nicht praktikabel.
  103. Denn  dann wird der Pfad, der in der startup-sequence und eventuell in
  104. Ihrer  User-Startup Datei eingestellt wird, nicht an die neu geöffnete
  105. Shell vererbt.  Wenn Sie nicht in der Datei Shell-Startup den Pfad mit
  106. Path neu einstellen wollen, ist die einzige Lösung NewShellCX_D in der
  107. Datei  User-Startup  zu starten.  Wenn Sie in Ihrer User-Startup-Datei
  108. den  Pfad  mittels  Path  verändern, so müssen Sie dies tun, bevor Sie
  109. NewShellCX starten.
  110.  
  111.  
  112. Benutzung von Exchange:
  113. -----------------------
  114. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  115. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  116. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  117. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  118. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  119. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  120. Titel, Beschreibung und Status angezeigt.
  121.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  122. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  123. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  124. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  125. "Show"  öffnen  lassen  und mit "Hide" schließen lassen.  NewShellCX_D
  126. hat kein Fenster.
  127.  
  128.  
  129.                        Veränderbare Parameter:
  130.                        -----------------------
  131.  
  132. CX_Priority:
  133. ------------
  134. Mit dem Tool-Type oder der Befehlsoption CX_PRIORITY=<Zahl> können Sie
  135. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  136. bestimmen.  Setzen Sie für <Zahl> bitte einen dezimalen Wert ein.  Die
  137. voreingestellte Priorität ist 0.
  138.  
  139. TASTE:
  140. ------
  141. Mit  dem  Tool-Type oder der Befehlsoption TASTE=<Zeichenkette> können
  142. Sie  die Tastenkombination bestimmen, die das Kommando ausführen soll.
  143. <Zeichenkette>  ist  eine  Eingabebeschreibung,  wie sie unten erklärt
  144. wird.   Voreingestellt ist "TASTE=lcommand esc" (linke Amiga-Taste und
  145. ESC).
  146.  
  147. Beispiele:
  148.  
  149.     NewShellCX_D "taste=ralt help"
  150.     NewShellCX_D "taste=lcommand m"
  151.     NewShellCX_D "taste=f1"
  152.  
  153.  
  154. KOMMANDO:
  155. ---------
  156. Mit  dem  Tool-Type  oder  der  Befehlsoption  Kommando=<Zeichenkette>
  157. können  Sie  die  Datei  spezifizieren,  die mit der Tastenkombination
  158. ausgeführt  werden  soll.  <Zeichenkette> ist der Pfad und der Name zu
  159. der  Datei,  eventuell mit Parametern, genauso wie Sie es in der Shell
  160. eingeben  würden.   Voreingestellt ist KOMMANDO=NewShell, welches eine
  161. neue Shell öffnet.
  162.  
  163. Beispiele:
  164. NewShellCX_D "Kommando=NewShell CON:0/0/640/200/MyShell/CLOSE FROM s:Shell-Startup"
  165. NewShellCX_D "kommando=c:NewWSH"
  166. NewShellCX_D "kommando=Tools:ClickDOS_II"
  167.  
  168. PUBLICSCREEN:
  169. -------------
  170. Mit  dem Tool-Type bzw.  der Befehlsoption PUBLICSCREEN=<Zeichenkette>
  171. können  Sie  den Namen eines öffentlichen Bildschirmes (public screen)
  172. angeben,  der beim Tastendruck nach vorne geholt wird.  Z.B.  holt die
  173. Option  "PUBLICSCREEN=Workbench"  jedesmal auch die Workbench mit nach
  174. vorne.     "PUBLICSCREEN=DEFAULT"    bringt    den    voreingestellten
  175. öffentlichen   Schrm   (default   public   screen)  nach  vorne.   Mit
  176. "PUBLICSCREEN="  (voreingestellt)  wird  kein  Bildschirm  nach  vorne
  177. gebracht.
  178.  
  179. ABSOLUTBEWEGUNG
  180. ---------------
  181. Mit  den  nächsten  beiden Optionen XBEWEGUNG und YBEWEGUNG können Sie
  182. einen  horizontalen  und  vertikalen  Wert  bestimmen,  um die der mit
  183. PUBLICSREEN    bestimmte    Schirm   bewegt   wird,   wenn   Sie   die
  184. Tastenkombination  drücken.   Mit  der  Option ABSOLUTBEWEGUNG=JA|NEIN
  185. bestimmen  Sie,  ob  die  angegebenen Werte als absolute oder relative
  186. Werte  interpretiert werden sollen.  Mit ABSOLUTBEWEGUNG=JA werden die
  187. Werte  als  absolute  interpretiert,  d.h.   die  linke obere Ecke des
  188. Schirmes  wird  auf  diese  Position  gebracht,  egal  wie  der Schirm
  189. momentan  positioniert ist.  Mit ABSOLUTBEWEGUNG=NEIN (voreingestellt)
  190. werden  die  Werte  als relative Werte gesehen und der Bildschirm wird
  191. relativ zur aktuellen Position des Schirmes um diese Werte verschoben.
  192.  
  193. XBEWEGUNG
  194. ---------
  195. Mit  der Option XBEWEGUNG=<Zahl> bestimmen Sie, um wie viele Pixel der
  196. Bildschirm  in horizontaler Richtung bewegt werden soll, wenn Sie eine
  197. relative  Verschiebung  wünschen,  ansonsten,  auf  welche horizontale
  198. Koordinate  die  linke  obere  Ecke des Schirmes gebracht werden soll.
  199. Setzen Sie für <Zahl> bitte eine dezimale Zahl ein. Voreingestellt ist
  200. 0.
  201.  
  202. YBEWEGUNG
  203. ---------
  204. Die Option YBEWEGUNG=<Zahl> bestimmt analog zu XBEWEGUNG die vertikale
  205. Verschiebung bzw.  Position.
  206.  
  207.  
  208.                         Eingabebeschreibungen
  209.                         ---------------------
  210.                      (input description strings)
  211.  
  212. Mit   Eingabebeschreibungen  können  Sie  jede  Tastenkombination  der
  213. Tastatur  und  der  Maus  beschreiben, z.B.  das Drücken der Taste F1,
  214. Shift-F1  oder  Alt-F1  oder das Drücken der linken Maustaste zusammen
  215. mit Alt etc.  Darueberhinaus sind einige andere Ereignisse abfragbar.
  216.  
  217. Eingabebeschreibungen haben folgendes Muster:
  218.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  219.  
  220. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  221.  
  222. class   ("Klasse") ist einer der folgenden Ausdrücke:
  223.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  224.         diskremoved, diskinserted.
  225.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  226.  
  227. qual    ("Qualifizierer") ist einer der folgenden Ausdrücke:
  228.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  229.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  230.         relativemouse
  231.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  232.         als irrelevant angenommen werden soll.
  233.  
  234. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  235.         shift bedeutet linke oder rechte Shift-Taste
  236.         caps bedeutet Shift oder Caps-Lock
  237.         alt bedeutet linke oder rechte Alt-Taste
  238.  
  239. upstroke (wörtlich "upstroke")
  240.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  241.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  242.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  243.         voran, so zählt beides.
  244.  
  245. highmap ist einer der folgenden Ausdrücke:
  246.         comma, space, backspace, tab, enter, return, esc, del, up,
  247.         down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9,
  248.         f10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  249.  
  250. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  251.         Taste
  252.  
  253.  
  254.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  255.      -----------------------------------------------------------
  256.                            Geschenke(!) an:
  257.                            ----------------
  258.  
  259.                             Stefan Sticht
  260.                           Bibereckerweg 40a
  261.                            D-8390 Passau 18
  262.                                  FRG
  263.  
  264. oder (besser) an eine der folgenden EMail-Adressen:
  265. cbmvax.commodore.com!cbmehq!cbmger!danube!edith!sticht [bevorzugt!]
  266. oder sticht%edith@danube.deg.sub.org
  267. oder sticht@eva.uni-passau.de
  268. oder IWSTICHT@ibm.rz.uni-passau.de
  269. Fido-Netz: Stefan Sticht (2:242/77:4)
  270.  
  271. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  272. Diese erhalten Sie z.B. mit dem Befehl "Version":
  273.                      Version [<path>]<commodity>
  274.