home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / shells / closewd.lha / CloseWD.dok < prev    next >
Text File  |  1992-10-11  |  8KB  |  275 lines
  1.  
  2.  
  3.                                Dokumentation zu
  4.  
  5.  
  6.                               CloseWD Version 1.2
  7.  
  8.  
  9.                            geschrieben 1992 by H.P.G
  10.  
  11.  
  12.                                    FreeWare
  13.  
  14.  
  15. Index:
  16.  
  17.         Index
  18.         Geschichte
  19.         Allgemeine Beschreibung
  20.         System Vorraussetzungen
  21.         Rechtliches
  22.         Installation
  23.         Benutzen von CloseWd
  24.         Cli-Parameter
  25.         Technisches
  26.         Zum Schluß
  27.         Adresse
  28.         Liste der Dateien
  29.  
  30.  
  31.  
  32. Geschichte:
  33.  
  34. Version 0.1 - 0.7
  35.  
  36.         Versionen für Kickstart 1.3. Ohne Benutzeroberfläche.
  37.  
  38. Version 0.8
  39.  
  40.         Erste Version für Kickstart 2.xx. Ohne GadTools-benutzeroberfläche.
  41.  
  42. Version 0.9
  43.  
  44.         Neu, Benutzung einer GadTools-Oberfläche.
  45.  
  46. Version 1.0 - 1.1
  47.  
  48.         Verbesserungen. Einbau von mehreren neuen Übergabeparametern.
  49.         Kann jetzt auch von der WBench aus gestartet werden.
  50.  
  51. Version 1.2
  52.  
  53.         Verbessertes Design. Jetzt wird das Fenster auch nach dem Namen gesucht.
  54.         Mit Pattern-Matching. Einführung der Ask-Funktion.
  55.  
  56.  
  57.  
  58. Allgemeine Beschreibung:
  59.  
  60.  
  61.     Zuerst:
  62.  
  63.     CloseWd ist ein OS 2.xx Tool und ist daher leider unter Kickstart 1.2
  64.     oder 1.3 nicht lauffähig.
  65.  
  66.     Wer kennt es nicht. Da gibt es Programme, die häßliche Fenster auf der
  67.     WBench hinterlassen, obwohl sie längst beendet sind.
  68.  
  69.     Um diese lästigen Fenster loszuwerden, kann man CloseWd benutzen.
  70.  
  71.     Dabei öffnet CloseWd [CW] ein Fenster mit verschiedenen Gadgets.
  72.  
  73.     Durch verschiedene Methoden läßt sich ein Fenster auswählen, daß man dann
  74.     schließen kann.
  75.  
  76.     CW hat eine GadTools-Benutzeroberfläche und jedem Gadget ist eine ent-
  77.     sprechende Taste zugeordnet, die man alternativ betätigen kann.
  78.  
  79.  
  80. System Vorraussetzungen:
  81.  
  82.     Für CW benötigt man mindestens OS 2.xx Version 37L. Versionen unter 37
  83.     hatten einige Funktionen noch nicht implementiert.
  84.  
  85.  
  86. Rechtliches:
  87.  
  88.  
  89. Ich habe mich entschlossen dieses Programm und alle beigefügten Dateien
  90. und Scripts, sowie aller Anleitungen als FREEWARE zu deklarieren.
  91. D.H.:
  92.  
  93.     Jeder kann CloseWd benutzen.
  94.     Jeder darf CloseWd weitergeben, wenn:
  95.  
  96.         1. alle unten aufgeführten Programme mit weitergegeben werden,
  97.  
  98.         2. keinerlei Veränderungen unten aufgeführten Programmen vor-
  99.             genommen wurden,
  100.  
  101.         3. bei Nachkompilierungen der Quell-Codes muß ein Hinweis auf
  102.             den Orginal-Programmierer vorhanden sein,
  103.             bei Herausgabe dieser, muß eine Kopie an mich gesandt werden.
  104.  
  105.         4. CloseWd darf nicht verkauft werden.
  106.  
  107.                 Außnahme: Es darf eine geringe Kopiergebühr erhoben
  108.                             werden, die aber 5 DM bzw. den entsprechenden
  109.                             Gegenwert in anderen Währungen nicht über-
  110.                             steigt.
  111.  
  112.         5. CloseWd darf nur als Teil eines kommerziellen Produktes herraus-
  113.             gegeben werden, mit ausdrücklicher schriftlicher Genehmigung
  114.             des Autors (Adresse siehe unten).
  115.  
  116.         Zuwiderhandlungen der oben Aufgeführten Konditionen werden
  117.         Zivilrechtlich verfolgt.
  118.  
  119.  
  120. Ferner wird für die Funktion des Programmes ,sowie möglicher Folgen
  121. der Benutzung des Programmes sowie der u. a. Dateien, keinerlei Ge-
  122. währleistung übernommen. Alle Risiken trägt der Benutzer allein.
  123.  
  124.  
  125. Installation:
  126.  
  127. CloseWd kann vom Cli oder von der WBench aus gestartet werden.
  128. Will man CloseWd hauptsächlich vom CLI aus starten, so ist es das
  129. Beste, man kopiert CW in das C:-Verzeichnis oder in ein anderes
  130. beliebiges Verzeichnis im aktuellen AmigaDOS-Suchpfad.
  131.  
  132. Will man CW hauptsächlich von der WBench starten, so kann man CloseWd
  133. in jedes beliebige Verzeichnis kopieren, indem man einfach das Icon
  134. in ein Verzeichnis zieht.
  135.  
  136.  
  137. Benutzen von CloseWd:
  138.  
  139. Startet man CW öffnet sich ein Fenster mit mehreren Gadgets.
  140. CloseWd hat zwei verschiedene Arten ein Fenster, daß man schließen will,
  141. zu finden.
  142.  
  143. 1. durch Aktivierung des Fensters:
  144.  
  145.     Dazu muß das Time Gadget angeklickt oder i eingegeben werden.
  146.     Im Wait-IntegerGadget kann man die Zeit in Sekunden angeben, die CW
  147.     wartet, bis es das Fenster sucht.
  148.     Will man z.Bsp. ein Fenster auf einem anderen Screen schließen, so
  149.     kann es eine Weile dauern bis man den Screen nach vorne geklickt und
  150.     das Fenster aktiviert hat. Stellt man jetzt z.Bsp. bei Wait einen
  151.     Wert von 20 ein. So wartet CloseWd 20 Sekunden, bis es das Fenster,
  152.     daß jetzt hoffentlich angeklickt ist, sucht. Ist die Zeit abgelaufen,
  153.     blitzt der Bildschirm kurz auf. Achtung: Bevor der Bildschrim aufblitzt,
  154.     sollte man kein anderes Fenster aktivieren, da man sonst versehentlich
  155.     ein falsches Fenster schließen könnte.
  156.  
  157.  
  158.     Vorsicht:
  159.  
  160.           Die angegebene Zeit von Sekunden wird immer gewartet und in
  161.           dieser Zeit ignoriert CW jede andere Anweisung. Dieser Vor-
  162.           gang kann nicht abgebrochen werden.
  163.  
  164.  
  165. 2. Durch Angeben vom Namen des Fensters:
  166.  
  167.     Dazu muß man das Name Gadget aktivieren. In das Title-StringGadget
  168.     kann man jetzt die ersten Buchstaben des Fenstertitels eingeben, daß
  169.     man schließen will. Findet CloseWd den Namen so wird dieses Fenster
  170.     geschlossen.
  171.  
  172.  
  173. CloseWd hat noch eine sehr wichtige Zusatzoption. Die Ask-Option verhindert
  174. das irrtümliche Schließen von Fenstern. Dazu muß das Ask-Gadget aktiviert
  175. sein ( der Haken muß erscheinen ).
  176. Bei Aktivierung der Ask-Option, wird bei jeder, der beiden vorgestellten
  177. Arten ein Fenster zu ermitteln, gefragt, ob es auch das richtige Fenster ist,
  178. und ob es geschlossen werden soll oder nicht.
  179.  
  180.  
  181. Das Okay try to .... -Gadget startet den Suchvorgang. Mit Cancel und Quit
  182. kann man das Programm beenden.
  183.  
  184. Man kann alternativ zum Betätigen eines Gadgets auch den unterstrichenen
  185. Buchstaben des Gadgets drücken.
  186.  
  187. Für das Zoom-Gadget (Iconify) kann man 'z' eintippen. Wird das Zoom-Gadget
  188. erneut gedrückt, oder z eingetippt erscheint das Fenster am vorherigen
  189. Platz.
  190.  
  191. Anstelle des CloseGadget kann man auch 'q' eintippen.
  192.  
  193.  
  194. ACHTUNG:
  195.  
  196. * Es dürfen keine Fenster geschlossen werden, die noch von einem Programm
  197. * benutzt werden. Dies kann zu Systemabstürzen führen. Man sollte aus
  198. * Sicherheitsgründen immer die Ask-Option benutzen. Man sollte CloseWd
  199. * niemals benutzen, wenn andere Programme Zugriffe auf Dateien haben. Da
  200. * man nie genau wissen kann, ob ein Fenster nicht doch noch von einem
  201. * Task benutzt wird, kann es in einem solchen Fall zu Dateiverlusten
  202. * führen.
  203.  
  204. Cli-Parameter:
  205.  
  206. Startet man CloseWd vom Cli aus, so kann man folgende Übergabeparameter
  207. angeben:
  208.  
  209. Syntax: CloseWd [Title][ASK/S][DELAY/N]
  210.  
  211.     wobei
  212.  
  213.         Title       gibt den Text an, der im Name-StringGadget beim Start
  214.                     stehen soll.
  215.  
  216.         ASK         gibt man ASK an, so ist das Ask-Gadget beim Start schon
  217.                     aktiviert.
  218.  
  219.         DELAY       hier kann man die Zeit in Sekunden angeben, die beim Start
  220.                     im Wait-Gadget stehen soll.
  221.  
  222.  
  223.  
  224. Techisches:         CloseWd benutzt kein ListView-Gadget zur Darstellung aller
  225.                     geöffneten Fenster. Das allokieren einer Liste und der da-
  226.                     zugehörigen Nodes würde viel zu lang dauern. Außerdem würde
  227.                     der Programmcode erheblich größer.
  228.                     CloseWD benutzt die neuen Features der DOS und GadTools.
  229.                     Libraries.
  230.                     Es wurde mit dem Aztec C Compiler Version 5.2a kompiliert.
  231.  
  232.  
  233. Zum Schluß:
  234.  
  235.                Ich hoffe, daß CloseWd sowenig, wie möglich eingesetzt werden
  236.                muß, da Fenster ja nur dann übrigbleiben, wenn ein anderes Pro-
  237.                gramm falsch programmiert worden ist, und sein Fenster nicht
  238.                wieder schließen kann.
  239.  
  240.                Ansonsten hoffe ich, daß dieses Programm gute Dienste
  241.                leistet.
  242.  
  243.                Sollten sich Fehler des Programmes herausstellen, so laßt
  244.                es mich bitte wissen.
  245.  
  246.  
  247.                Noch viel Spaß ...
  248.  
  249. Adresse:
  250.  
  251.  
  252.             Hans-Peter Günther
  253.             Grüner Weg 5
  254.             D-3501 Fuldatal 2
  255.             B.R.D. (Germany)
  256.  
  257.  
  258. Liste der Dateien:
  259.  
  260. (Fehlt eine der folgenden Dateien, ist diese Veröffentlichung inkomplett)
  261.  
  262. CloseWD            : Das Programm
  263. CloseWD.info
  264. CloseWd.doc        : Englische Anleitung
  265. CloseWd.doc.info
  266. CloseWd.dok        : Deutsche Anleitung
  267. CloseWd.dok.info
  268.  
  269.  
  270. ----------ENDE
  271.  
  272.  
  273.  
  274.  
  275.