home *** CD-ROM | disk | FTP | other *** search
/ PC Player 1997 March / PCP0397.iso / PROGRAMM / DCC41PCP / DCCV41.LZH / SCRIPT.DOC < prev    next >
Encoding:
Text File  |  1996-05-22  |  8.3 KB  |  287 lines
  1.  
  2.  
  3.  
  4.                 Dokumentation zur Erstellung eigener Dialoge
  5.                      für den Gebrauch im Anwendermenü
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. 1. Wofür brauche ich das ?
  13. --------------------------
  14.  
  15.  Die Dialoge vereinfachen die Übergabe von Parametern an Programme.
  16.  Sie erlauben es auch dem unerfahrenen Anwender mit Programmen umzu-
  17.  gehen, die eine komplizierte Parameterübergabe erfordern.
  18.  Ähnliche Dialoge gab  es  auch  schon  bei  DCC  Version  1.8.  Diese
  19.  waren allerdings nicht so frei zu gestalten.
  20.  
  21.  Sie können mit diesen Dialogen beispielsweise Viren-Scanner steuern,
  22.  die sonst eine schwierige Parameterübergabe erfordern. Oder Sie er-
  23.  weitern die im DCC eingebauten Packer-Optionen nach den eigenen
  24.  Bedürfnissen. (siehe 5. Hinweise)
  25.  
  26.  
  27.  
  28.  
  29.  
  30. 2. Aufbau eines Dialog-Script's
  31. -------------------------------
  32.  
  33.  - Versionsinformation
  34.    DOS-COMMAND-CENTER-PRO 3.0   (für DCC V3.0 und DCC-PRO identisch)
  35.    oder
  36.    DOS-COMMAND-CENTER 4.0
  37.  - Dialogdefinition (Ausmaße, Überschrift etc.)
  38.    ■ DIALOG
  39.  - Kommandozeile
  40.    ■ COMMANDLINE
  41.  - BEGIN
  42.  - Dialogelemente
  43.  
  44.     ■ CANCELBUTTON
  45.     ■ CHECKBOX
  46.     ■ CONTROL
  47.     ■ INPUT
  48.     ■ LTEXT
  49.     ■ OKBUTTON
  50.     ■ RADIOBUTTON
  51.  
  52.  - END
  53.  
  54.  
  55.  
  56.  
  57.  
  58. 3. Beschreibung
  59. ---------------
  60.  
  61.  DOS-COMMAND-CENTER PRO 3.0
  62.  
  63.  Die Versionsinformation muss in jedem Script enthalten sein und
  64.  muss in der ersten Zeile stehen. Auch wenn die Script-Dateien
  65.  unter DCC V3.0 genutzt werden, müssen die Dialoge diese Information
  66.  enthalten.
  67.  
  68.  DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  69.  
  70.  Dies ist die Dialogdefinition. Erst wird der Typ eingetragen. In
  71.  diesem Fall immer  DIALOG.  Danach  wird  die  Nummer  des  Elementes
  72.  eingetragen (In diesem Fall immer 0). Hierauf folgen die Ausmaße  des
  73.  Dialogs in dem Format X1 Y1 X2 Y2
  74.  
  75.                  X1,Y1 ──────────── X2,Y1
  76.                    │                  │
  77.                    │                  │
  78.                  X1,Y2 ──────────── X2,Y2
  79.  
  80.  Sie  können  dabei  vom  Nullpunkt  ausgehen,  da  DCC  den    Dialog
  81.  automatisch auf dem Bildschirm zentriert.
  82.  Nach der Festlegung der Ausmaße folgt die Überschrift, die der Dialog
  83.  bekommen soll.
  84.  
  85.  COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  86.  
  87.  Diese Zeile beschreibt die Anordnung der Parameter, die die einzelnen
  88.  Dialogelemente zurückgeben.  Jedes  Element  im  Dialog  erhält  eine
  89.  eindeutige  Nummer.  Diese  Nummer  wird  hier  zusammen   mit    dem
  90.  Prozentzeichen "%" eingetragen. DCC ersetzt die Eintragung  dann  mit
  91.  dem entsprechenden Rückgabewert des Elementes. Es macht nur Sinn  die
  92.  Nummern von folgenden Elementtypen hier einzutragen :
  93.  
  94.  - INPUT
  95.  - CHECKBOX
  96.  - RADIOBUTTON
  97.  
  98.  Alle anderen  Elemente  geben  keine  Ergebnisse  zurück.  Falls  ein
  99.  Element keine Rückgabe  zuläßt  oder  z.B.  eine  Eingabezeile  keine
  100.  Eintragungen enthält, so wird die  entsprechende  Eintragung  in  der
  101.  COMMANDLINE einfach entfernt.
  102.  
  103.  Bei diesem Beispieldialog könnte die COMMANDLINE bei  Beendigung  des
  104.  Dialogs folgendermaßen aussehen:
  105.  
  106.  "-ex -3 -r -P -sPASSWORT C:\DCCPRO\TEST.ZIP *.EXE"
  107.     ^  ^    ^   ^   ^              ^           ^
  108.     │  │    │   │   │              │           │
  109.    %4 %5   %6  %7   %9            %13         %11
  110.  
  111.  
  112.  
  113. BEGIN
  114.  
  115.  Jede Dialogdefinition muss von BEGIN-END eingeschlossen sein.
  116.  
  117.  Folgende Elemente stehen zur Verfügung:
  118.  
  119.   - CONTROL
  120.  
  121.     Dies ist das Label/die Überschrift für ein anderes Element.
  122.     Mit diesem Elementtyp können  Sie  beispielsweise  eine  Eingabe-
  123.     zeile beschreiben und anwählen.
  124.  
  125.     Aufbau :
  126.  
  127.     TYP, Nummer des Elementes, Position, Text, verknüpftes Element
  128.  
  129.     Beispiel :
  130.  
  131.     CONTROL      ,  3, 46  2 59  3, "~K~ompression",  4
  132.  
  133.   - RADIOBUTTON
  134.  
  135.     Mit diesem Element wird eine eindeutige Auswahl getroffen. Man
  136.     kann mehrere Einträge zur Auswahl anbieten, es kann jedoch nur
  137.     einer gewählt werden. Es ist weiterhin nicht möglich keinen Eintrag
  138.     auszuwählen.
  139.  
  140.     Aufbau :
  141.  
  142.     TYP, Nummer des Elementes, Position, Anzahl der Einträge,
  143.     Einträge, Rückgabewerte der Einträge
  144.  
  145.     Beispiel :
  146.  
  147.     RADIOBUTTON , 4, 40  3 66  8,  5, "maximal"  "normal"  "schnell"
  148.                   "sehr schnell" "keine", " -ex" " -en" " -ef" " -es" " -e0"
  149.  
  150.   - CHECKBOX
  151.  
  152.     Dieser Typ ist ähnlich aufgebaut, wie der vorherige. Hier können
  153.     jedoch mehrere Einträge angewählt werden. Außerdem ist es hier
  154.     möglich keinen der Einträge auszuwählen.
  155.  
  156.     Der Aufbau ist der gleiche, wie beim Typ RADIOBUTTON
  157.  
  158.     Beispiel :
  159.  
  160.     CHECKBOX   , 5,  4    8  36  10,  2,  "keine  ~3~2-Bit
  161.                 Unterstützung" "k~e~ine DPMI Unterstützung", " -3" " -)"
  162.  
  163.  
  164.  
  165.   - INPUT
  166.  
  167.     Der Typ INPUT stellt eine Eingabezeile dar. Hier können beliebige
  168.     max. 255 Zeichen lange Texte übergeben werden. Der Eingabezeile
  169.     können Standardeintragungen übergeben werden, die beim Aufruf des
  170.     Dialogs in die Eingabezeile eingefügt werden. Hier ist es auch
  171.     möglich mit den von DCC bekannten Platzhaltern "!:!\!.!" zu arbeiten.
  172.     DCC ersetzt diese dann durch den Namen der gerade im Dateifenster
  173.     gewählten Datei.
  174.  
  175.     Aufbau :
  176.  
  177.     TYP, Nummer des Elementes, Position, Standardtext
  178.  
  179.  
  180.     Beispiel :
  181.  
  182.     INPUT        , 11, 16  5 35  6, "!:!\!.!"
  183.  
  184.  
  185.   - LTEXT
  186.  
  187.     Dieser Elementtyp dient ausschließlich dazu, Text darzustellen.
  188.  
  189.     Aufbau :
  190.  
  191.     TYP, Nummer des Elementes, Position, Text
  192.  
  193.     Beispiel :
  194.  
  195.     LTEXT,  3, 46  2 59  3, "Dieser Dialog ist ein Beispieldialog!"
  196.  
  197.   - CANCELBUTTON
  198.  
  199.     Dies ist der Schaltknopf um einen Abbruch des Dialogs zu bewirken.
  200.     Hier können Sie einen beliebigen Text eintragen.
  201.  
  202.     Aufbau :
  203.  
  204.     TYP, Nummer des Elementes, Position, Beschriftung
  205.  
  206.     Beispiel :
  207.  
  208.     CANCELBUTTON ,  1, 53 16 66 18, "~A~bbruch"
  209.  
  210.  
  211.   - OKBUTTON
  212.  
  213.     Dies ist der Schaltknopf um einen Dialog normal zu beenden. Der
  214.     Dialog wird dann geschlossen, die Kommandozeile aufgebaut und
  215.     ausgeführt.
  216.  
  217.     Der Aufbau ist mit dem des CANCELBUTTON indentisch.
  218.  
  219.     Beispiel :
  220.  
  221.     OKBUTTON     ,  2, 40 16 51 18, "~S~tart"
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229. 4. Beispieldialog
  230. -----------------
  231.  
  232. Dieser Dialog dient zum Archivieren von einzelnen oder
  233. markierten Dateien mit PKZIP Version 2.04.
  234. -----------------------------------------------------------------------------
  235.  
  236. DOS-COMMAND-CENTER-PRO 3.0
  237. DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  238. COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  239. BEGIN
  240.          CONTROL      ,  3, 46  2 59  3, "~K~ompression",  4
  241.          RADIOBUTTON  ,  4, 40  3 66  8,  5, "maximal" "normal" "schnell"
  242.          "sehr schnell" "keine", " -ex" " -en" " -ef" " -es" " -e0"
  243.          CHECKBOX     ,  5,  4  8 36 10,  2, "keine ~3~2-Bit Unterstützung"
  244.          "k~e~ine DPMI Unterstützung", " -3" " -)"
  245.          CHECKBOX     ,  6,  4 15 36 18,  3, "mit ~U~nterverzeichnissen"
  246.          "~m~arkierte Dateien packen" "~V~erzeichnisnamen speichern",
  247.          " -r" " @^ZIP.LST" " -P"
  248.          CHECKBOX     ,  7,  4 12 36 13,  1, "~P~asswort benutzen", " -s"
  249.          CONTROL      ,  8, 40 11 48 12, "Paß~w~ort",  9
  250.          INPUT        ,  9, 40 12 65 13, ""
  251.          CONTROL      , 10,  4  5 15  6, "~D~ateimaske", 11
  252.          INPUT        , 11, 16  5 35  6, "!:!\!.!"
  253.          CONTROL      , 12,  4  3 15  4, "A~r~chivname", 13
  254.          INPUT        , 13, 16  3 35  4, "!:!\!..ZIP"
  255.          CANCELBUTTON ,  1, 53 16 66 18, "~A~bbruch"
  256.          OKBUTTON     ,  2, 40 16 51 18, "~S~tart"
  257. END
  258.  
  259. -----------------------------------------------------------------------------
  260.  
  261. 5. Hinweise
  262. -----------
  263.  
  264. Sie haben die Möglichkeit DCC zu veranlassen eine Dateiliste mit den
  265. gewählten/markierten Dateien zu erstellen. Diese Liste kann dann anderen
  266. Programmen z.B. Packern (PKZip, ARJ etc.) übergeben werden.
  267. Diese Liste wird mit Ascii 94 "^" gekennzeichnet und kann einen beliebigen
  268. Namen haben.
  269.  
  270. Der Einbau einer solchen Dialogdatei im Anwendermenü kann beispielsweise
  271. folgendermaßen aussehen:
  272.  
  273. MENUITEM "~P~acken mit PKZip..." NOKEY "PKZIP &C:\DCCPRO\PKZIP.SCR" _EXECWIN
  274.  
  275. Das Asciizeichen 38 "&" wird dabei dem Namen der Dialogdatei vorangestellt.
  276. Hieran erkennt DCC, daß es sich bei dem folgenden Namen um eine Scriptdatei
  277. handelt.
  278.  
  279. Die Scriptdatei kann an beliebiger Stelle in der Menü-Kommandozeile einge-
  280. tragen werden. Es ist auch möglich nur die Scriptdatei als Kommando einzu-
  281. tragen. Dann wird die Kommandozeile vollständig aus dem Dialog gebildet.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.