home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / Angie / SetActiveWinUtil / SetActiveWin.dok < prev   
Encoding:
Text File  |  1996-09-27  |  8.0 KB  |  197 lines
  1.  
  2.           ------------------------------------------------------
  3.           SetActiveWin 1.2 (30.11.93) © Franz Schwarz - Freeware
  4.           ------------------------------------------------------
  5.  
  6.                 Aktiviert genau das Fenster, das Sie wollen
  7.  
  8.                             Written & © 1993 by
  9.                                Franz Schwarz
  10.                               Mühlenstraße 2
  11.                        D-78591 Durchhausen, Germany
  12.                     Uucp: Franz_Schwarz@mil.ka.sub.org
  13.                         Fido Classic: 2:2476/506.18
  14.  
  15.  
  16. SetActiveWin ist ein kleines Utility, das beliebige Fenster aktivieren
  17. kann, wobei eine Vielzahl von Eigenschaften angegeben werden kann, um
  18. das Fenster zu bestimmen.
  19.  
  20. Die Kommandozeilen-Argument-Schablone lautet:
  21.  
  22.     WINDOWNAME=WPAT,TASKNAME=TPAT,SCREENNAME=SPAT,PUBSCREENNAME=PSPAT,
  23.                              CASE/S,TOFRONT/S:
  24.  
  25. Alle in der ersten Zeile aufgeführten Argumente erwarten dabei die Angabe
  26. eines Filter-Namesmusters, anhand dessen SetActiveWin das zu aktivierende
  27. Fenster auswählt.
  28.  
  29. WINDOWNAME=WPAT erwartet dabei das Filter-Namensmuster, das auf den
  30. Fensternamen angewandt wird.  Falls dieses Argument weggelassen wird,
  31. passen alle Fensternamen.
  32.  
  33. TASKNAME=TPAT erwartet das Namensmuster, das auf die Namen der Eigner-Tasks
  34. des Fensters angewandt wird.  Falls das Namensmuster nicht auf den Namen
  35. des Eigner-Tasks paßt, und der Eigner-Task ein Shell-Prozeß darstellt, wird
  36. auch der Name des gerade von diesem Prozeß ausgeführten Dos-Befehls auf
  37. Übereinstimmung mit dem angegebenen Namensmuster geprüft.  Falls dieses
  38. Argument weggelassen wird, passen alle Fenster, auch die ohne eingetragenen
  39. Eigner-Task.
  40.  
  41. SCREENNAME=SPAT erwartet das Namensmuster, das auf den STANDARDMÄßIGEN
  42. Namen des Schirms, auf dem sich das Fenster befindet, angewandt wird.
  43. Falls dieses Argument nicht angeführt wird, passen alle standardmäßigen
  44. Schirm-Namen.
  45.  
  46. PUBSCREENNAME=PSPAT erwartet das Namensmuster, das auf den Namen des
  47. öffentlichen Schirms, auf dem das Fenster geöffnet ist, angewandt wird.
  48. Falls dieses Argument weggelassen wird, passen alle Fenster, auch
  49. diejenigen, die auf einem nicht-öffentlichen Schirm geöffnet sind.
  50. Andernfalls passen nur Fenster, die sich auf einem öffentlichen Schirm mit
  51. einem passenden Namen befinden.
  52.  
  53.  
  54. Alle Namensmuster-Argumente erwarten gültige AmigaDos-Namensmuster wie z.B.
  55. "CygnusEdScreen?", "#?workbench( |%)#?", etc.  Es gibt jedoch ein
  56. spezielles Namensmuster, ein sogenanntes 'Magic': "!"
  57. Es hat für die verschiedenen Argumente folgende Bedeutung:
  58.   -wird es für das WINDOWNAME=WPAT-Argument angegeben, paßt nur das gerade
  59.    aktive Fenster.
  60.   -wird es für das TASKNAME=TPAT-Argument angegeben, passen nur Fenster,
  61.    die den selben Eigner-Task haben wie das aktuelle Fenster.
  62.   -wird es für das SCREENNAME=SPAT-Argument angegeben, passen nur Fenster,
  63.    die auf dem aktiven Schirm geöffnet sind.
  64.   -wird es für das PUBSCREENNAME=PSPAT-Argument angegeben, passen nur
  65.    Fenster, die auf dem standardmäßigen öffentlichen Schirm geöffnet sind.
  66.    
  67.    
  68. Falls der CASE/S-Schalter spezifiziert wird, so wird bei der Suche nach
  69. passenden Namen auf Groß-/Kleinschreibung unterschieden, ansonsten werden
  70. Klein- und Großbuchstaben als gleich betrachtet.
  71.  
  72.  
  73. Ein Fenster paßt nur dann, wenn ALLE VIER Filter-Kennzeichen passen.  Die
  74. Suche nach passenden Fenstern beginnt dabei beim auf das aktive Fenster
  75. folgenden Fenster.  Dadurch wird einfaches BLÄTTERN durch eine ganze Reihe
  76. von Fenstern, auf die die Filter-Charakteristika passen, ermöglicht.
  77.  
  78. Der TOFRONT/S-Schalter bewirkt, daß das passende Fenster nicht nur
  79. aktiviert wird, sondern auch gleichzeitig nach vorne gebracht wird.
  80.  
  81.  
  82. Falls SetActiveWin kein passendes Fenster finden kann, gibt es den
  83. Rückgabewert 5 (WARN) zurück, ansonsten, falls es ein passendes Fenster
  84. finden konnte, den Rückgabewert 0 (OK).
  85.  
  86.  
  87. SetActiveWin wurde speziell für die Verwendung innerhalb von AngieSequenzen
  88. des legendären ANGIE - Another Great Intuition Enhancer - Commodities
  89. entwickelt, kann aber gleichfalls auch in Stapelbearbeitungsdateien oder
  90. ARexx-Skripten verwendet werden.
  91.  
  92. Für seine Anwendung innerhalb von Angie sollten sie SetActiveWin resident
  93. machen (SetActiveWin IST reentrant, pure), und es dann innerhalb von
  94. SyncDosSequenzen etwa wie folgt einsetzen:
  95.  
  96. Falls Sie die AngieSequenz 
  97. '{SetActiveWin tpat "IntuiNews#?" tofront}(HuntWindow)' auf die
  98. Funktionstaste F10 legen, können sie beispielsweise mit dieser
  99. Funktionstaste durch ihre IntuiNews-Fenster blättern.
  100.  
  101.  
  102. Wenn Sie durch einen Tastendruck auf ihre mittlere Maustaste durch alle
  103. Fenster Ihrer gerade aktiven Anwendung blättern wollen, so sollten Sie
  104. die AngieSequenz '{SetActiveWin tpat ! tofront}(HuntWindow)' auf
  105. den HotKey 'rawmouse midbutton mouse_middlepress' legen.
  106.  
  107. Indem Sie die AngieSequenz 
  108. '{setactivewin "(Workbench|%)" tpat Workbench pspat Workbench case}
  109.  (HuntWindow)'
  110. auf den Hotkey 'rawmouse alt rbutton mouse_rightpress' legen, erreichen
  111. Sie, daß ein Maus-Klick auf die rechte Maustaste bei gedrückter linker
  112. Alt-Taste das Basisfenster Ihrer Workbench öffnet, und es jagt.
  113.  
  114. Sie können aber auch z.B. die AngieSequenz
  115. '{setactivewin "SuperDuper#?by#?S#?Vigna#?" tofront}(HuntWindow)' 
  116. auf den Hotkey 'diskinserted' legen, was den Erfolg hat, daß, jedesmal,
  117. wenn Sie eine Diskette einlegen, und Sie das affenstarke Kopierprogramm
  118. Superduper von Disk-Wizard Sebastiano Vigna gestartet haben, 
  119. das SuperDuper-Hauptfenster aktiviert, nach vorne gebracht und gejagt wird.
  120.  
  121.  
  122. Sie sehen, die Möglichkeiten sind wirklich nahezu unbegrenzt!
  123.  
  124. Sie können aber noch einiges mehr:
  125.  
  126. Legen Sie ganz einfach folgende Angie-Sequenz auf einen Hotkey (ersetzen
  127. Sie die <control-j>-Ausdrücke durch einen Tastendruck auf die j-Taste bei
  128. gedrückter CTRL-Taste):
  129.  
  130. '[SetActiveWin wpat IconEdit#? tpat #?IconEdit tofront<control-j>
  131.   if warn<control-j>
  132.   run <nil: >nil: sys:tools/IconEdit<control-j>
  133.   wait 2<control-j>
  134.   endif<control-j>
  135.   rawinsert d "<lcommand help>"]'
  136.  
  137. Falls Sie nun den Hotkey betätigen, aktiviert Angie, falls der
  138. Piktogramm-Editor IconEdit gestartet ist, dessen Fenster, bringt es nach
  139. vorne, andernfalls startet Angie ganz einfach das IconEdit-Programm neu.
  140. Schließlich wird noch durch das rawinsert-Utility (ebenfalls von mir;-))
  141. ein Tastendruck auf die Help-Taste mit gedrückter linker Amiga-Taste
  142. simuliert, was, falls in Angie die AngieSequenz '(HuntWindow)' auf
  143. diese Taste gelegt wurde, eine Fenster-Jagen-Aktion auslöst.
  144.  
  145. In diesem Beispiel wird SetActiveWin übrigens innerhalb einer
  146. ASyncDosSequenz!!  verwendet, da die Ausführung dieser AngieSequenz länger
  147. dauern kann, und ansonsen Angie während der Ausführung der gesamten
  148. AngieSequenz blockiert wäre!
  149.  
  150.  
  151.  
  152.  
  153.                         Evolution von SetActiveWin
  154.                         --------------------------
  155.  
  156.   v1.0 21.11.93 [fSchwarz]
  157.  
  158.   v1.1 22.11.93 [fSchwarz] fixed deadlock problem that was
  159.     due to holding concurrent locks on both, IBase & the
  160.     PubScreenList (PubScreenList fields are now copied)
  161.  
  162.   v1.2 30.11.93 [fSchwarz] fixed bug that kept all windows
  163.     on non-public screens from being activated
  164.  
  165.  
  166.                              Schlußbemerkungen
  167.                              -----------------
  168.  
  169.  
  170. SetActiveWin ist Freeware, i.e., es ist frei kopierbar, das Urheberrecht
  171. liegt aber weiterhin beim Autor.  Eine Haftung des Autors für Schäden, die
  172. unmittelbar oder mittelbar von dem Gebrauch von SetActiveWin herrühren, ist
  173. definitiv ausgeschlossen.  Die Verwendung von SetActiveWin erfolgt auf Ihr
  174. eigenes Risiko.  In angelsächsischem Jargon wird dies gemeinhin als 'Use At
  175. Your Own Risk' bezeichnet.
  176.  
  177.  
  178.     SetActiveWin geschrieben und urheberrechtlich geschützt, © 1993 by 
  179.        Franz Schwarz, Mühlenstraße 2, D-78591 Durchhausen, Germany.
  180.       uucp: Franz_Schwarz@mil.ka.sub.org; Fido Classic: 2:2476/506.18
  181.  
  182.  
  183. Anregungen, Kritik, Flames, Geld, Gold, Disketten, Bier, Schokolade, nette
  184. Postkarten, e-mails, etc. sind jederzeit herzlich willkommen!;-)
  185.  
  186.  
  187.     Bye
  188.       Franz 'Blacky' Schwarz
  189.  
  190.       ... und vergessen Sie nicht:      
  191.                 SetActiveWin - aktiviert genau das Fenster, das Sie wollen
  192.  
  193.  
  194.                - Girlfriend Is Better - Talking Heads -
  195.  
  196.  
  197.