home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / v2 / newshell.lha / NewShellCX_D.dok < prev    next >
Encoding:
Text File  |  1991-09-05  |  11.5 KB  |  272 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!edith!sticht
  266. oder IWSTICHT@ibm.rz.uni-passau.de
  267. Fido-Netz: Stefan Sticht (2:242/77:4)
  268.  
  269. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  270. Diese erhalten Sie z.B. mit dem Befehl "Version":
  271.                      Version [<path>]<commodity>
  272.