home *** CD-ROM | disk | FTP | other *** search
/ Chip Hitware 10 / Chip_Hitware_Vol_10.iso / chiphit / tools / 95dcc / _setup.4 / Group1 / Script.txt < prev    next >
Encoding:
Text File  |  1997-12-14  |  9.3 KB  |  345 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-WIN
  35.  - Dialogdefinition (Ausma▀e, ▄berschrift etc.)
  36.    - DIALOG
  37.  - Kommandozeile
  38.    - COMMANDLINE
  39.  - BEGIN
  40.  - Dialogelemente
  41.  
  42.     - CANCELBUTTON
  43.     - CHECKBOX
  44.     - CONTROL
  45.     - INPUT
  46.     - LTEXT
  47.     - OKBUTTON
  48.     - RADIOBUTTON
  49.     - GRAPHIC
  50.     - FRAME
  51.  
  52.  - END
  53.  
  54.  
  55.  
  56.  
  57.  
  58. 3. Beschreibung
  59. ---------------
  60.  
  61.  DOS-COMMAND-CENTER-WIN
  62.  
  63.  Die Versionsinformation muss in jedem Script enthalten sein und
  64.  muss in der ersten Zeile stehen. 
  65.  
  66.  DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  67.  
  68.  Dies ist die Dialogdefinition. Erst wird der Typ eingetragen. In
  69.  diesem Fall immer  DIALOG.  Danach  wird  die  Nummer  des  Elementes
  70.  eingetragen (In diesem Fall immer 0). Hierauf folgen die Ausma▀e  des
  71.  Dialogs in dem Format X1 Y1 X2 Y2
  72.  
  73.                  X1,Y1 ------------ X2,Y1
  74.                    |                  |
  75.                    |                  |
  76.                  X1,Y2 ------------ X2,Y2
  77.  
  78.  Sie  k÷nnen  dabei  vom  Nullpunkt  ausgehen,  da  DCC  den    Dialog
  79.  automatisch auf dem Bildschirm zentriert.
  80.  Nach der Festlegung der Ausma▀e folgt die ▄berschrift, die der Dialog
  81.  bekommen soll.
  82.  
  83.  COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  84.  
  85.  Diese Zeile beschreibt die Anordnung der Parameter, die die einzelnen
  86.  Dialogelemente zurⁿckgeben.  Jedes  Element  im  Dialog  erhΣlt  eine
  87.  eindeutige  Nummer.  Diese  Nummer  wird  hier  zusammen   mit    dem
  88.  Prozentzeichen "%" eingetragen. DCC ersetzt die Eintragung  dann  mit
  89.  dem entsprechenden Rⁿckgabewert des Elementes. Es macht nur Sinn  die
  90.  Nummern von folgenden Elementtypen hier einzutragen :
  91.  
  92.  - INPUT
  93.  - CHECKBOX
  94.  - RADIOBUTTON
  95.  
  96.  Alle anderen  Elemente  geben  keine  Ergebnisse  zurⁿck.  Falls  ein
  97.  Element keine Rⁿckgabe  zulΣ▀t  oder  z.B.  eine  Eingabezeile  keine
  98.  Eintragungen enthΣlt, so wird die  entsprechende  Eintragung  in  der
  99.  COMMANDLINE einfach entfernt.
  100.  
  101.  Bei diesem Beispieldialog k÷nnte die COMMANDLINE bei  Beendigung  des
  102.  Dialogs folgenderma▀en aussehen:
  103.  
  104.  "-ex -3 -r -P -sPASSWORT C:\WinDCC\TEST.ZIP *.EXE"
  105.     ^  ^    ^   ^   ^              ^           ^
  106.     |  |    |   |   |              |           |
  107.    %4 %5   %6  %7   %9            %13         %11
  108.  
  109.  
  110.  
  111. BEGIN
  112.  
  113.  Jede Dialogdefinition muss von BEGIN-END eingeschlossen sein.
  114.  
  115.  Folgende Elemente stehen zur Verfⁿgung:
  116.  
  117.   - CONTROL
  118.  
  119.     Dies ist das Label/die ▄berschrift fⁿr ein anderes Element.
  120.     Mit diesem Elementtyp k÷nnen  Sie  beispielsweise  eine  Eingabe-
  121.     zeile beschreiben und anwΣhlen.
  122.  
  123.     Aufbau :
  124.  
  125.     TYP, Nummer des Elementes, Position, Text, verknⁿpftes Element
  126.  
  127.     Beispiel :
  128.  
  129.     CONTROL      ,  3, 46  2 59  3, "&Kompression",  4
  130.  
  131.   - RADIOBUTTON
  132.  
  133.     Mit diesem Element wird eine eindeutige Auswahl getroffen. Man
  134.     kann mehrere EintrΣge zur Auswahl anbieten, es kann jedoch nur
  135.     einer gewΣhlt werden. Es ist weiterhin nicht m÷glich keinen Eintrag
  136.     auszuwΣhlen.
  137.  
  138.     Aufbau :
  139.  
  140.     TYP, Nummer des Elementes, Position, Anzahl der EintrΣge,
  141.     EintrΣge, Rⁿckgabewerte der EintrΣge
  142.  
  143.     Beispiel :
  144.  
  145.     RADIOBUTTON , 4, 40  3 66  8,  5,
  146.                   "maximal"
  147.                   "normal"
  148.                   "schnell"
  149.                   "sehr schnell"
  150.                   "keine",
  151.           " -ex"
  152.           " -en"
  153.           " -ef"
  154.           " -es"
  155.           " -e0"
  156.  
  157.   - CHECKBOX
  158.  
  159.     Dieser Typ ist Σhnlich aufgebaut, wie der vorherige. Hier k÷nnen
  160.     jedoch mehrere EintrΣge angewΣhlt werden. Au▀erdem ist es hier
  161.     m÷glich keinen der EintrΣge auszuwΣhlen.
  162.  
  163.     Der Aufbau ist der gleiche, wie beim Typ RADIOBUTTON
  164.  
  165.     Beispiel :
  166.  
  167.     CHECKBOX   , 5,  4    8  36  10,  2,
  168.                  "keine  &32-Bit Unterstⁿtzung"
  169.          "k&eine DPMI Unterstⁿtzung",
  170.          " -3"
  171.          " -)"
  172.  
  173.   - INPUT
  174.  
  175.     Der Typ INPUT stellt eine Eingabezeile dar. Hier k÷nnen beliebige
  176.     max. 255 Zeichen lange Texte ⁿbergeben werden. Der Eingabezeile
  177.     k÷nnen Standardeintragungen ⁿbergeben werden, die beim Aufruf des
  178.     Dialogs in die Eingabezeile eingefⁿgt werden. Hier ist es auch
  179.     m÷glich mit den von DCC bekannten Platzhaltern "!:!\!.!" zu arbeiten.
  180.     DCC ersetzt diese dann durch den Namen der gerade im Dateifenster
  181.     gewΣhlten Datei.
  182.  
  183.     Aufbau :
  184.  
  185.     TYP, Nummer des Elementes, Position, Standardtext
  186.  
  187.  
  188.     Beispiel :
  189.  
  190.     INPUT        , 11, 16  5 35  6, "!:!\!.!"
  191.  
  192.  
  193.   - LTEXT
  194.  
  195.     Dieser Elementtyp dient ausschlie▀lich dazu, Text darzustellen.
  196.  
  197.     Aufbau :
  198.  
  199.     TYP, Nummer des Elementes, Position, Text
  200.  
  201.     Beispiel :
  202.  
  203.     LTEXT,  3, 46  2 59  3, "Dieser Dialog ist ein Beispieldialog!"
  204.  
  205.   - CANCELBUTTON
  206.  
  207.     Dies ist der Schaltknopf um einen Abbruch des Dialogs zu bewirken.
  208.     Hier k÷nnen Sie einen beliebigen Text eintragen.
  209.  
  210.     Aufbau :
  211.  
  212.     TYP, Nummer des Elementes, Position, Beschriftung
  213.  
  214.     Beispiel :
  215.  
  216.     CANCELBUTTON ,  1, 53 16 66 18, "&Abbruch"
  217.  
  218.  
  219.   - OKBUTTON
  220.  
  221.     Dies ist der Schaltknopf um einen Dialog normal zu beenden. Der
  222.     Dialog wird dann geschlossen, die Kommandozeile aufgebaut und
  223.     ausgefⁿhrt.
  224.  
  225.     Der Aufbau ist mit dem des CANCELBUTTON indentisch.
  226.  
  227.     Beispiel :
  228.  
  229.     OKBUTTON     ,  2, 40 16 51 18, "&Start"
  230.  
  231.  
  232.   - GRAPHIC
  233.  
  234.     Dieser Elementtyp dient ausschlie▀lich dazu, Grafik darzustellen.
  235.  
  236.     Aufbau :
  237.  
  238.     TYP, Nummer des Elementes, Position, Grafikdatei
  239.  
  240.     Beispiel :
  241.  
  242.     GRAPHIC,  10, 0  0 640 480, "C:\WINDOWS\SETUP.BMP"
  243.  
  244.     Hier k÷nnen auch Icons dargestellt werden. Die Symbole k÷nnen entweder
  245.     direkt angegeben werden oder ⁿber einen Index in einer Programmdatei
  246.     oder Programm-Bibliothek. z.B. "C:\WINDOWS\SYSTEM\SHELL32.DLL,1"
  247.  
  248.  
  249.   - FRAME
  250.  
  251.     Dieser Elementtyp dient ausschlie▀lich dazu, einen Rahmen darzustellen.
  252.  
  253.     Aufbau :
  254.  
  255.     TYP, Nummer des Elementes, Position
  256.  
  257.     Beispiel :
  258.  
  259.     FRAME,  11, 0  0 640 480
  260.  
  261.     Dieses Element stellt einen 3D-Rahmen dar.
  262.  
  263.  
  264.  
  265.  
  266.  
  267. 4. Beispieldialog
  268. -----------------
  269.  
  270. Dieser Dialog dient zum Archivieren von einzelnen oder
  271. markierten Dateien mit PKZIP Version 2.04.
  272. -----------------------------------------------------------------------------
  273.  
  274. DOS-COMMAND-CENTER-WIN
  275. DIALOG, 0,   5  1 75 21, "Datei(en) packen"
  276. COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
  277. BEGIN
  278.          CONTROL      ,  3, 46  2 59  3, "&Kompression",  4
  279.          RADIOBUTTON  ,  4, 40  3 66  8,  5,
  280.                      "maximal"
  281.              "normal"
  282.              "schnell"
  283.                          "sehr schnell"
  284.              "keine",
  285.              " -ex"
  286.              " -en"
  287.              " -ef"
  288.              " -es"
  289.              " -e0"
  290.          CHECKBOX     ,  5,  4  8 36 10,  2,
  291.                      "keine &32-Bit Unterstⁿtzung"
  292.                          "k&eine DPMI Unterstⁿtzung",
  293.              " -3"
  294.              " -)"
  295.          CHECKBOX     ,  6,  4 15 36 18,  3,
  296.                      "mit &Unterverzeichnissen"
  297.                          "&markierte Dateien packen"
  298.              "&Verzeichnisnamen speichern",
  299.                          " -r"
  300.              " @^ZIP.LST"
  301.              " -P"
  302.          CHECKBOX     ,  7,  4 12 36 13,  1,
  303.                      "&Passwort benutzen",
  304.              " -s"
  305.          CONTROL      ,  8, 40 11 48 12, "Pa▀&wort",  9
  306.          INPUT        ,  9, 40 12 65 13, ""
  307.          CONTROL      , 10,  4  5 15  6, "&Dateimaske", 11
  308.          INPUT        , 11, 16  5 35  6, "!:!\!.!"
  309.          CONTROL      , 12,  4  3 15  4, "A&rchivname", 13
  310.          INPUT        , 13, 16  3 35  4, "!:!\!..ZIP"
  311.          CANCELBUTTON ,  1, 53 16 66 18, "&Abbruch"
  312.          OKBUTTON     ,  2, 40 16 51 18, "&Start"
  313. END
  314.  
  315. -----------------------------------------------------------------------------
  316.  
  317. 5. Hinweise
  318. -----------
  319.  
  320. Sie haben die M÷glichkeit DCC zu veranlassen eine Dateiliste mit den
  321. gewΣhlten/markierten Dateien zu erstellen. Diese Liste kann dann anderen
  322. Programmen z.B. Packern (PKZip, ARJ etc.) ⁿbergeben werden.
  323. Diese Liste wird mit Ascii 94 "^" gekennzeichnet und kann einen beliebigen
  324. Namen haben.
  325.  
  326. Der Einbau einer solchen Dialogdatei im Anwendermenⁿ kann beispielsweise
  327. folgenderma▀en aussehen:
  328.  
  329. MENUITEM "&Packen mit PKZip..." NOKEY "PKZIP &C:\WINDCC\PKZIP.SCR"
  330.  
  331. Das Asciizeichen 38 "&" wird dabei dem Namen der Dialogdatei vorangestellt.
  332. Hieran erkennt DCC, da▀ es sich bei dem folgenden Namen um eine Scriptdatei
  333. handelt.
  334.  
  335. Die Scriptdatei kann an beliebiger Stelle in der Menⁿ-Kommandozeile einge-
  336. tragen werden. Es ist auch m÷glich nur die Scriptdatei als Kommando einzu-
  337. tragen. Dann wird die Kommandozeile vollstΣndig aus dem Dialog gebildet.
  338.  
  339. Da das Zeichen '"' reserviert ist, k÷nnen lange Dateinamen stattdessen mit
  340. dem Asciizeichen 39 ' eingerahmt werden. Das Zeichen wird von DCC dann
  341. automatisch durch das korrekte Zeichen '"' ersetzt.
  342.  
  343. Also z.B. COMMANDLINE "'%DCC_PATH\DE.EXE' '!:!\!.!'"
  344.  
  345.