home *** CD-ROM | disk | FTP | other *** search
-
-
-
- Dokumentation zur Erstellung eigener Dialoge
- fⁿr den Gebrauch im Anwendermenⁿ
-
-
-
-
-
-
- 1. Wofⁿr brauche ich das ?
- --------------------------
-
- Die Dialoge vereinfachen die ▄bergabe von Parametern an Programme.
- Sie erlauben es auch dem unerfahrenen Anwender mit Programmen umzu-
- gehen, die eine komplizierte Parameterⁿbergabe erfordern.
- ─hnliche Dialoge gab es auch schon bei DCC Version 1.8. Diese
- waren allerdings nicht so frei zu gestalten.
-
- Sie k÷nnen mit diesen Dialogen beispielsweise Viren-Scanner steuern,
- die sonst eine schwierige Parameterⁿbergabe erfordern. Oder Sie er-
- weitern die im DCC eingebauten Packer-Optionen nach den eigenen
- Bedⁿrfnissen. (siehe 5. Hinweise)
-
-
-
-
-
- 2. Aufbau eines Dialog-Script's
- -------------------------------
-
- - Versionsinformation
- DOS-COMMAND-CENTER-WIN
- - Dialogdefinition (Ausma▀e, ▄berschrift etc.)
- - DIALOG
- - Kommandozeile
- - COMMANDLINE
- - BEGIN
- - Dialogelemente
-
- - CANCELBUTTON
- - CHECKBOX
- - CONTROL
- - INPUT
- - LTEXT
- - OKBUTTON
- - RADIOBUTTON
- - GRAPHIC
- - FRAME
-
- - END
-
-
-
-
-
- 3. Beschreibung
- ---------------
-
- DOS-COMMAND-CENTER-WIN
-
- Die Versionsinformation muss in jedem Script enthalten sein und
- muss in der ersten Zeile stehen.
-
- DIALOG, 0, 5 1 75 21, "Datei(en) packen"
-
- Dies ist die Dialogdefinition. Erst wird der Typ eingetragen. In
- diesem Fall immer DIALOG. Danach wird die Nummer des Elementes
- eingetragen (In diesem Fall immer 0). Hierauf folgen die Ausma▀e des
- Dialogs in dem Format X1 Y1 X2 Y2
-
- X1,Y1 ------------ X2,Y1
- | |
- | |
- X1,Y2 ------------ X2,Y2
-
- Sie k÷nnen dabei vom Nullpunkt ausgehen, da DCC den Dialog
- automatisch auf dem Bildschirm zentriert.
- Nach der Festlegung der Ausma▀e folgt die ▄berschrift, die der Dialog
- bekommen soll.
-
- COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
-
- Diese Zeile beschreibt die Anordnung der Parameter, die die einzelnen
- Dialogelemente zurⁿckgeben. Jedes Element im Dialog erhΣlt eine
- eindeutige Nummer. Diese Nummer wird hier zusammen mit dem
- Prozentzeichen "%" eingetragen. DCC ersetzt die Eintragung dann mit
- dem entsprechenden Rⁿckgabewert des Elementes. Es macht nur Sinn die
- Nummern von folgenden Elementtypen hier einzutragen :
-
- - INPUT
- - CHECKBOX
- - RADIOBUTTON
-
- Alle anderen Elemente geben keine Ergebnisse zurⁿck. Falls ein
- Element keine Rⁿckgabe zulΣ▀t oder z.B. eine Eingabezeile keine
- Eintragungen enthΣlt, so wird die entsprechende Eintragung in der
- COMMANDLINE einfach entfernt.
-
- Bei diesem Beispieldialog k÷nnte die COMMANDLINE bei Beendigung des
- Dialogs folgenderma▀en aussehen:
-
- "-ex -3 -r -P -sPASSWORT C:\WinDCC\TEST.ZIP *.EXE"
- ^ ^ ^ ^ ^ ^ ^
- | | | | | | |
- %4 %5 %6 %7 %9 %13 %11
-
-
-
- BEGIN
-
- Jede Dialogdefinition muss von BEGIN-END eingeschlossen sein.
-
- Folgende Elemente stehen zur Verfⁿgung:
-
- - CONTROL
-
- Dies ist das Label/die ▄berschrift fⁿr ein anderes Element.
- Mit diesem Elementtyp k÷nnen Sie beispielsweise eine Eingabe-
- zeile beschreiben und anwΣhlen.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position, Text, verknⁿpftes Element
-
- Beispiel :
-
- CONTROL , 3, 46 2 59 3, "&Kompression", 4
-
- - RADIOBUTTON
-
- Mit diesem Element wird eine eindeutige Auswahl getroffen. Man
- kann mehrere EintrΣge zur Auswahl anbieten, es kann jedoch nur
- einer gewΣhlt werden. Es ist weiterhin nicht m÷glich keinen Eintrag
- auszuwΣhlen.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position, Anzahl der EintrΣge,
- EintrΣge, Rⁿckgabewerte der EintrΣge
-
- Beispiel :
-
- RADIOBUTTON , 4, 40 3 66 8, 5,
- "maximal"
- "normal"
- "schnell"
- "sehr schnell"
- "keine",
- " -ex"
- " -en"
- " -ef"
- " -es"
- " -e0"
-
- - CHECKBOX
-
- Dieser Typ ist Σhnlich aufgebaut, wie der vorherige. Hier k÷nnen
- jedoch mehrere EintrΣge angewΣhlt werden. Au▀erdem ist es hier
- m÷glich keinen der EintrΣge auszuwΣhlen.
-
- Der Aufbau ist der gleiche, wie beim Typ RADIOBUTTON
-
- Beispiel :
-
- CHECKBOX , 5, 4 8 36 10, 2,
- "keine &32-Bit Unterstⁿtzung"
- "k&eine DPMI Unterstⁿtzung",
- " -3"
- " -)"
-
- - INPUT
-
- Der Typ INPUT stellt eine Eingabezeile dar. Hier k÷nnen beliebige
- max. 255 Zeichen lange Texte ⁿbergeben werden. Der Eingabezeile
- k÷nnen Standardeintragungen ⁿbergeben werden, die beim Aufruf des
- Dialogs in die Eingabezeile eingefⁿgt werden. Hier ist es auch
- m÷glich mit den von DCC bekannten Platzhaltern "!:!\!.!" zu arbeiten.
- DCC ersetzt diese dann durch den Namen der gerade im Dateifenster
- gewΣhlten Datei.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position, Standardtext
-
-
- Beispiel :
-
- INPUT , 11, 16 5 35 6, "!:!\!.!"
-
-
- - LTEXT
-
- Dieser Elementtyp dient ausschlie▀lich dazu, Text darzustellen.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position, Text
-
- Beispiel :
-
- LTEXT, 3, 46 2 59 3, "Dieser Dialog ist ein Beispieldialog!"
-
- - CANCELBUTTON
-
- Dies ist der Schaltknopf um einen Abbruch des Dialogs zu bewirken.
- Hier k÷nnen Sie einen beliebigen Text eintragen.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position, Beschriftung
-
- Beispiel :
-
- CANCELBUTTON , 1, 53 16 66 18, "&Abbruch"
-
-
- - OKBUTTON
-
- Dies ist der Schaltknopf um einen Dialog normal zu beenden. Der
- Dialog wird dann geschlossen, die Kommandozeile aufgebaut und
- ausgefⁿhrt.
-
- Der Aufbau ist mit dem des CANCELBUTTON indentisch.
-
- Beispiel :
-
- OKBUTTON , 2, 40 16 51 18, "&Start"
-
-
- - GRAPHIC
-
- Dieser Elementtyp dient ausschlie▀lich dazu, Grafik darzustellen.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position, Grafikdatei
-
- Beispiel :
-
- GRAPHIC, 10, 0 0 640 480, "C:\WINDOWS\SETUP.BMP"
-
- Hier k÷nnen auch Icons dargestellt werden. Die Symbole k÷nnen entweder
- direkt angegeben werden oder ⁿber einen Index in einer Programmdatei
- oder Programm-Bibliothek. z.B. "C:\WINDOWS\SYSTEM\SHELL32.DLL,1"
-
-
- - FRAME
-
- Dieser Elementtyp dient ausschlie▀lich dazu, einen Rahmen darzustellen.
-
- Aufbau :
-
- TYP, Nummer des Elementes, Position
-
- Beispiel :
-
- FRAME, 11, 0 0 640 480
-
- Dieses Element stellt einen 3D-Rahmen dar.
-
-
-
-
-
- 4. Beispieldialog
- -----------------
-
- Dieser Dialog dient zum Archivieren von einzelnen oder
- markierten Dateien mit PKZIP Version 2.04.
- -----------------------------------------------------------------------------
-
- DOS-COMMAND-CENTER-WIN
- DIALOG, 0, 5 1 75 21, "Datei(en) packen"
- COMMANDLINE "%4 %5 %6 %7%9 %13 %11"
- BEGIN
- CONTROL , 3, 46 2 59 3, "&Kompression", 4
- RADIOBUTTON , 4, 40 3 66 8, 5,
- "maximal"
- "normal"
- "schnell"
- "sehr schnell"
- "keine",
- " -ex"
- " -en"
- " -ef"
- " -es"
- " -e0"
- CHECKBOX , 5, 4 8 36 10, 2,
- "keine &32-Bit Unterstⁿtzung"
- "k&eine DPMI Unterstⁿtzung",
- " -3"
- " -)"
- CHECKBOX , 6, 4 15 36 18, 3,
- "mit &Unterverzeichnissen"
- "&markierte Dateien packen"
- "&Verzeichnisnamen speichern",
- " -r"
- " @^ZIP.LST"
- " -P"
- CHECKBOX , 7, 4 12 36 13, 1,
- "&Passwort benutzen",
- " -s"
- CONTROL , 8, 40 11 48 12, "Pa▀&wort", 9
- INPUT , 9, 40 12 65 13, ""
- CONTROL , 10, 4 5 15 6, "&Dateimaske", 11
- INPUT , 11, 16 5 35 6, "!:!\!.!"
- CONTROL , 12, 4 3 15 4, "A&rchivname", 13
- INPUT , 13, 16 3 35 4, "!:!\!..ZIP"
- CANCELBUTTON , 1, 53 16 66 18, "&Abbruch"
- OKBUTTON , 2, 40 16 51 18, "&Start"
- END
-
- -----------------------------------------------------------------------------
-
- 5. Hinweise
- -----------
-
- Sie haben die M÷glichkeit DCC zu veranlassen eine Dateiliste mit den
- gewΣhlten/markierten Dateien zu erstellen. Diese Liste kann dann anderen
- Programmen z.B. Packern (PKZip, ARJ etc.) ⁿbergeben werden.
- Diese Liste wird mit Ascii 94 "^" gekennzeichnet und kann einen beliebigen
- Namen haben.
-
- Der Einbau einer solchen Dialogdatei im Anwendermenⁿ kann beispielsweise
- folgenderma▀en aussehen:
-
- MENUITEM "&Packen mit PKZip..." NOKEY "PKZIP &C:\WINDCC\PKZIP.SCR"
-
- Das Asciizeichen 38 "&" wird dabei dem Namen der Dialogdatei vorangestellt.
- Hieran erkennt DCC, da▀ es sich bei dem folgenden Namen um eine Scriptdatei
- handelt.
-
- Die Scriptdatei kann an beliebiger Stelle in der Menⁿ-Kommandozeile einge-
- tragen werden. Es ist auch m÷glich nur die Scriptdatei als Kommando einzu-
- tragen. Dann wird die Kommandozeile vollstΣndig aus dem Dialog gebildet.
-
- Da das Zeichen '"' reserviert ist, k÷nnen lange Dateinamen stattdessen mit
- dem Asciizeichen 39 ' eingerahmt werden. Das Zeichen wird von DCC dann
- automatisch durch das korrekte Zeichen '"' ersetzt.
-
- Also z.B. COMMANDLINE "'%DCC_PATH\DE.EXE' '!:!\!.!'"
-
-