Wiki-Quellcode von Dialogs

Zuletzt geändert von Jannis Klein am 2024/03/19 17:59

version	line-number	content
2.1	1	{{aagon.priorisierung}}
	2	140
	3	{{/aagon.priorisierung}}
	4
	5	{{aagon.floatingbox/}}
3.2	6
3.3	7	= Dialogs =
3.2	8
	9	Mit diesem Kommando kann ein Dialog erstellt werden, welcher dem Benutzer angezeigt wird und Eingaben erwarten kann. Als Titel wird dabei eine kurze Überschrift erwartet, welcher in der Kopfzeile des Dialogs angezeigt wird. Weiterhin kann eine Nachricht eingegeben werden, welche als Textfeld im Dialog selber angezeigt wird.
	10
5.1	11	(% style="text-align:center" %)
14.1	12	[[image:64_Client Commands_Command erstellen Dialogs_685.png\|\|height="531" width="500"]]
3.2	13
11.2	14	Unter Nachrichtentyp kann ein anzuzeigendes Symbol gewählt werden, wobei auch ein eigenes Bild bzw. kein Bild gewählt werden können. Ebenso können die anzuzeigenden Buttons spezifiziert werden. Aktiviert werden Sie durch einen Haken wobei der darauf erscheinende Text durch das Textfeld frei wählbar ist. Soll beim Anklicken eines bestimmten Buttons das Kommando abgebrochen werden, muss unter Abbruch bei Button(s) ein Haken bei den entsprechenden Buttons gemacht werden. Sinn macht das ganze natürlich nur, wenn die entsprechenden Buttons auch angezeigt werden.
3.2	15
31.1	16	Das Ergebnis der der Dialogaktionen wird in einer Variablen gespeichert welche unter Ergebnis speichern in angegeben wird. Weitere Informatione zu Variablen erfahren Sie im Kapitel [[Variablen>>doc:ACMP.63.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome\|\|anchor="HVariablenbearbeiten"]].
3.2	17
	18	Auf die Daten können Sie wie Folgt zugreifen:
	19
	20	\|(((
	21	%VarName.InputValue%
	22
3.3	23	%VarName.ClickedButton%
3.2	24
	25	%VarName.MyCheckboxCaption%
	26	)))\|(((
	27	- Ein evtl. Eingegebener Wert
	28
	29	- Der angeklickte Button (Ok, Cancel, Yes, No oder Timeout)
	30
	31	- Liefert einen Boolean (Wahr, Falsch) ob eine Überschrift gesetzt war
	32	)))
	33
3.3	34	{{aagon.infobox}}
	35	VarName bezeichnet die von Ihnen eingesetzte Variable und muss dementsprechend geändert werden.
	36	{{/aagon.infobox}}
3.2	37
5.1	38	(% style="text-align:center" %)
3.3	39	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_fb8f5c72.png\|\|alt="Dialogs - Eingabeeinstellungen" height="588" width="559"]]
3.2	40	Dialogs - Eingabeeinstellungen
	41
	42	Unter dem Tab Eingabeeinstellungen können Einstellungen für eine Dateneingabe getroffen werden. Aktiviert wird eine Dateneingabe mit einem Haken bei Dialog erwartet Eingabe. Wird die Checkbox Passwortgeschützt ebenfalls aktiviert, wird das Eingabefeld zu einem Passwortfeld (* statt Buchstaben/Zahlen). Unter Aufforderung tragen Sie ein, was für Daten eingegeben werden sollen während Sie unter Standard einen Standardwert festlegen können.
	43
	44	Zur Eingabe können Sie verschiedene Vorlagen wählen z.B. ein einfaches Eingabefeld für manuelle Eingaben. Weiterhin gibt es die Möglichkeit eine Dropdownliste, eine Liste mit Radiobuttons und eine Liste mit Checkboxen einblenden zu lassen. Bei Radiobuttons ist nur die Auswahl eines Wertes möglich, wobei bei Checkboxen eine Mehrfachauswahl möglich ist. Mehrere Werte werden dabei mit einem Feld pro Zeile in das untere Textfeld eingegeben. Wird die Checkbox Manuelle Eingabe verweigern nicht aktiviert, hat der Benutzer die Möglichkeit eigene Daten einzugeben.
	45
	46	Unter dem Tab Erweiterte Einstellungen kann angegeben werden, dass der Dialog nach einer bestimmten Zeit-gemessen in Sekunden-geschlossen wird, wobei die Variable %VarName.ClickedButton% auf einen bestimmten Wert gesetzt werden kann (Standard: Timeout).
	47
3.4	48	= Open file dialog =
3.2	49
	50	Mit diesem Kommando können Sie einen Datei öffnen-Dialog aufrufen. Dadurch können dem Client Command dynamisch Dateien übergeben werden, welche der Benutzer auswählen kann.
	51
5.1	52	(% style="text-align:center" %)
3.2	53	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_5d0d5647.png\|\|alt="Open file dialog" height="449" width="501"]]
	54	Open file dialog
	55
3.4	56	Unter dem Tab Details geben Sie einen Titel für den Dialog an. Über das Standard-Verzeichnis und können Sie einen Pfad angeben, welcher im Dialog bereits vorselektiert ist. Über den Standard-Dateiname kann ein Dateiname vorselektiert werden.
3.2	57
	58	Über die Filter können Sie verschiedene Dateifilter formulieren. Dazu tragen Sie linksseitig einen Filtername und rechtsseitig den Filter in die Tabelle ein. Der Filter wird dabei im bekannten Format (z.B. .) angegeben. Weitere Filter lassen sich über den grünen Plus-Button hinzufügen und über den roten Minus-Button löschen.
	59
	60	In der anzugebenden Variablen werden der Pfad und der Name der ausgewählten Datei(en) gespeichert. Über den rechtsseitigen Button können Sie eine neue Projektvariable anlegen.
	61
	62	Unter dem Tab Optionen finden Sie zahlreiche Anpassungsmöglichkeiten. Diese sind selbsterklärend und werden daher nicht weiter vertieft.
	63
3.4	64	= Save file dialog =
3.2	65
	66	Mit diesem Kommando können Sie einen Datei speichern-Dialog aufrufen. Somit ist es möglich, aus dem Client Command heraus Daten in einer Datei zu speichern.
	67
3.4	68	Unter dem Tab Details geben Sie einen Titel für den Dialog an. Über das Standard-Verzeichnis und können Sie einen Pfad angeben, welcher im Dialog bereits vorselektiert ist. Über den Standard-Dateiname kann ein Dateiname vorselektiert werden.
3.2	69
	70	Über die Filter können Sie verschiedene Dateifilter formulieren. Dazu tragen Sie linksseitig einen Filtername und rechtsseitig den Filter in die Tabelle ein. Der Filter wird dabei im bekannten Format (z.B. .) angegeben. Weitere Filter lassen sich über den grünen Plus-Button hinzufügen und über den roten Minus-Button löschen.
	71
5.1	72	(% style="text-align:center" %)
3.2	73	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_57d08080.png\|\|alt="Save file dialog" height="449" width="495"]]
	74	Save file dialog
	75
	76	In der anzugebenden Variablen werden der Pfad und der Name der ausgewählten Datei gespeichert. Über den rechtsseitigen Button können Sie eine neue Projektvariable anlegen.
	77
	78	Unter dem Tab Optionen finden Sie zahlreiche Anpassungsmöglichkeiten. Diese sind selbsterklärend und werden daher nicht weiter vertieft.
	79
4.1	80	= Browse for directory =
3.2	81
	82	Mit diesem Kommando können Sie einen Nach Ordner suchen-Dialog aufrufen. Dadurch kann der Benutzer dem Client Command ein Verzeichnis zuweisen, welches das Client-Command für weitere Operationen nutzen kann.
	83
5.1	84	(% style="text-align:center" %)
3.2	85	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_e61c2622.png\|\|alt="Browse for folder" height="449" width="491"]]
	86	Browse for folder
	87
	88	Geben Sie unter dem Tab Details ein Verzeichnis an, welches das Startverzeichnis des Dialogs darstellt. Der Titel ist der Titel des Dialogs.
	89
	90	In der anzugebenden Variablen wird der Pfad gespeichert. Über den rechtsseitigen Button können Sie eine neue Projektvariable anlegen.
	91
	92	Unter dem Tab Optionen finden Sie einige Anpassungsmöglichkeiten. Diese sind selbst-erklärend und werden daher nicht weiter vertieft.
	93
4.1	94	= Set progressform properties =
3.2	95
31.1	96	Mit diesem Kommando können Sie eine Fortschrittsanzeige anzeigen lassen. Dazu tragen Sie einen Titel und zwei weitere beliebige Angaben ein. Alternativ können Sie hier auch Variablen (siehe [[Variablen>>doc:ACMP.63.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome\|\|anchor="HVariablenbearbeiten"]]) eintragen um über einen Haken bei Aktualisieren stets den aktuellen Variablenwert anzeigen zu lassen z.B. beim kopieren von Dateien den aktuellen Dateinamen.
3.2	97
	98	Darunter kann ein anzuzeigendes Bild angegeben werden, wobei zwischen einem Standardbild, keinem Bild, dem zuletzt verwendetem Bild und einem Bild aus einer Datei wählen. Bei dem Bild aus der Datei kann noch eine Transparenz aktiviert werden wobei das Bild über das Eingabefeld ausgewählt wird.
	99
5.1	100	(% style="text-align:center" %)
3.2	101	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_1e94ac7e.png\|\|alt="Set progressform properties" height="578" width="398"]]
	102	Set progressform properties
	103
	104	Unter Fortschrittsbalken kann ein Wert zwischen 0 und 100 gewählt werden. Um stets einen aktuellen Wert anzeigen zu können, ist hier eine Variable ebenfalls recht hilfreich.
	105
4.1	106	= Show progressform =
3.2	107
4.1	108	Dieses Kommando zeigt dem Benutzer eine Fortschrittsanzeige an. Die Einstellungen dazu können über das Kommando Set progressform properties vorgenommen werden. Spezielle Einstellungen gibt es hier nicht.
3.2	109
4.1	110	= Hide progressform =
3.2	111
4.1	112	Dieses Kommando blendet eine dem Benutzer angezeigte Fortschrittsanzeige aus. Spezielle Einstellungen gibt es hier nicht.
3.2	113
4.1	114	= Form editor =
3.2	115
	116	Mit Hilfe dieses Kommandos kann man sich einen eigenen Dialog erstellen und anzeigen lassen. Dazu klicken Sie im neuen Dialog auf den Button Form bearbeiten wonach sich eine IDE-Umgebung öffnet.
	117
5.1	118	(% style="text-align:center" %)
3.2	119	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_79b6e667.png\|\|alt="Form editor" height="506" width="518"]]
	120	Form editor
	121
	122	Hier können Sie den Dialog nach Ihren Wünschen erstellen und bearbeiten. Da hier DelphiSkript-Kenntnisse gefragt sind, sollte man dieses Kommando auch nur dann nutzen, wenn man diese besitzt. Ist dies gegeben, findet man sich auch ohne Probleme in der Umgebung zurecht, weshalb eine genauere Erläuterung nicht stattfindet.
	123
29.1	124	Weitere Informationen zu diesem Kommando finden Sie im Kapitel [[Der Form Editor.>>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.Dialogs.Der Form Editor.WebHome]]

Wiki-Quellcode von Dialogs

Navigation