GUI-API - Versionsgeschichte

Mark.lorenz: /* Allgemeiner Aufbau */

2012-12-20T13:45:07Z

Allgemeiner Aufbau

Mark.lorenz am 10. Dezember 2012 um 13:57 Uhr

2012-12-10T13:57:21Z

Mark.lorenz: /* Allgemeiner Aufbau */

2012-09-20T10:58:39Z

Allgemeiner Aufbau

Steffen.binas: /* Einfügen der GUI */

2012-09-15T19:28:38Z

Einfügen der GUI

Mark.lorenz am 13. August 2012 um 12:30 Uhr

2012-08-13T12:30:18Z

Mark.lorenz am 13. August 2012 um 12:29 Uhr

2012-08-13T12:29:45Z

Mark.lorenz am 13. August 2012 um 12:28 Uhr

2012-08-13T12:28:15Z

Mark.lorenz: /* Layout */

2012-08-13T12:24:01Z

Layout

Mark.lorenz: /* Allgemeiner Aufbau */

2012-08-13T11:46:04Z

Allgemeiner Aufbau

Mark.lorenz: /* Optionen */

2012-08-13T11:45:08Z

Optionen

@@ Zeile 35: / Zeile 35: @@
 ** ''[[ComboBox]]'': Aufklappbarer Auswahldialog, enthält Strings
 ** ''[[CheckBox]]'': Kästchen zur binären Auswahl
-** ''[[ImageComboBox]]'': Aufklappbarer Auswahldialog, enthält Bilder
+** ''[[Gallery]]'': Auswahldialog in Form einer Galerie, enthält Bilder
 ** ''[[SpinEdit]]'': Eingabefeld für Ganzzahlen, liefert Integer-Werte
 ** ''[[Slider]]'': auch unter '''TrackBar''' bekannt, Schieberegler, liefert Integer-Werte

@@ Zeile 63: / Zeile 63: @@
+   ]
 </code>
 == Layout ==

@@ Zeile 38: / Zeile 38: @@
 ** ''[[SpinEdit]]'': Eingabefeld für Ganzzahlen, liefert Integer-Werte
 ** ''[[Slider]]'': auch unter '''TrackBar''' bekannt, Schieberegler, liefert Integer-Werte
 * ''Caption'': Beschriftung der Komponente, kann leer sein.

@@ Zeile 4: / Zeile 4: @@
 Die Gestaltung geschieht innerhalb der vordefinierten Funktion (dem "Hook") '''GetGUI''', die irgendwo im betreffenden Skript eingefügt sein muss:
 <code>
-   function GetGUI(SlideShowObject: ISlideShowObject): string;
+   function OnGetGUI(SlideShowObject: ISlideShowObject): string;
    begin
      Result := ''''''';

← Nächstältere Version		Version vom 13. August 2012, 12:30 Uhr
Zeile 1:		Zeile 1:
−	Es ist manchmal notwendig, dass für Vorlagen und Effekte Einstellungen und Eingaben vom Benutzer gebraucht werden. Daher bietet die [[Scripting-API]] die Möglichkeit, einfache [Benutzeroberflächen] (GUI) zu gestalten.	+	Es ist manchmal notwendig, dass für Vorlagen und Effekte Einstellungen und Eingaben vom Benutzer gebraucht werden. Daher bietet die [[Scripting-API]] die Möglichkeit, einfache [https://de.wikipedia.org/wiki/Grafische_Benutzeroberfl%C3%A4che Grafische Benutzeroberflächen] (GUI) zu gestalten.

	= Einfügen der GUI =		= Einfügen der GUI =

← Nächstältere Version		Version vom 13. August 2012, 12:29 Uhr
Zeile 1:		Zeile 1:
−	Es ist manchmal notwendig, dass für Vorlagen und Effekte Einstellungen und Eingaben vom Benutzer gebraucht werden. Daher bietet die Scripting-API die Möglichkeit, einfache [Benutzeroberflächen] (GUI) zu gestalten.	+	Es ist manchmal notwendig, dass für Vorlagen und Effekte Einstellungen und Eingaben vom Benutzer gebraucht werden. Daher bietet die [[Scripting-API]] die Möglichkeit, einfache [Benutzeroberflächen] (GUI) zu gestalten.

	= Einfügen der GUI =		= Einfügen der GUI =

@@ Zeile 2: / Zeile 2: @@
 = Einfügen der GUI =
-Die Gestaltung geschieht innerhalb der vordefinierten Funktion '''GetGUI''', die irgendwo im betreffenden Skript eingefügt sein muss:
+Die Gestaltung geschieht innerhalb der vordefinierten Funktion (dem "Hook") '''GetGUI''', die irgendwo im betreffenden Skript eingefügt sein muss:
 <code>
    function GetGUI(SlideShowObject: ISlideShowObject): string;

← Nächstältere Version		Version vom 13. August 2012, 12:24 Uhr
Zeile 64:		Zeile 64:

	== Layout ==		== Layout ==
		+	Standardmäßig werden die im Array aufgezählten Komponenten untereinander angeordnet und über die gesamte Breite des Eigenschaften-Fensters gezogen. Ist eine Caption angegegeben, erscheint diese vor der eigentlichen Komponente als Beschriftung.
		+
		+	=== Schachtelung ===
		+	Es ist möglich, Komponenten auch nebeneinander anzuordnen. Dafür müssen sich diese innerhalb eines Unterarrays befinden:
		+	<code>
		+	# JSON-Array für die GUI
		+	[
		+	{<Ein Objekt in Zeile 1>},
		+	[{<Ein Objekt in Zeile 2>}, {<Noch ein Objekt in Zeile 2>}],
		+	{<Ein Objekt in Zeile 3>}
		+	]
		+	</code>
		+	Generell ist eine beliebige Schachtelung von Komponenten erlaubt. Jedes Unterarray wechselt das Layout von Horizontal zu Vertikal. Das erlaubt das Erstellen auch von komplizierteren Tabellenlayouts.
		+
		+	=== Beispiel ===
		+	<code>
		+	[
		+	{
		+	"Key" : "Edit1",
		+	"Type" : "Edit",
		+	"Caption" : "Name:"
		+	},
		+	[
		+	[
		+	{
		+	"Key" : "Edit2",
		+	"Type" : "Edit",
		+	"Caption" : "Anschrift Teil 1:"
		+	},
		+	{
		+	"Key" : "Edit3",
		+	"Type" : "Edit",
		+	"Caption" : "Anschrift Teil 2:"
		+	}
		+	],
		+	[
		+	{
		+	"Key" : "Combo1",
		+	"Type" : "ComboBox",
		+	"Caption": "Kontaktmöglichkeit:",
		+	"Options":
		+	{
		+	"Items" : ["eMail", "Telefon", "Rauchzeichen"]
		+	}
		+	},
		+	{
		+	"Key" : "Edit4",
		+	"Type" : "Edit",
		+	"Caption" : "Eingabe Kontakt:"
		+	}
		+	]
		+	]
		+	</code>
		+
		+	Dieses Beispiel könnte zur Eingabe von Adressschemata geeignet sein - der Anwendungsfall für die konkrete DiaShow sei hierbei einmal vernachlässigt. Dieses Layout ergibt ein breites Edit-Feld (der Name), und darunter eine kleine 2x2-Tabelle (links untereinander die Anschrift mit Edit-Feldern und rechts untereinander die Combobox und das Edit-Feld für die Kontaktdaten).
		+

	[[Kategorie:Scripting-API]]		[[Kategorie:Scripting-API]]

@@ Zeile 30: / Zeile 30: @@
 * ''Key'': Eindeutige Kennung der Komponente, seine ID
 * ''Type'': Art der Komponente. Kann folgende Werte annehmen:
-** ''[[Dokumentation der Komponente Title|Title]]'': Title der Vorlage oder des Effekts
+** ''[[Title]]'': Title der Vorlage oder des Effekts
-** ''[[Dokumentation der Komponente Edit|Edit]]'': Eingabefeld
+** ''[[Edit]]'': Eingabefeld
-** ''[[Dokumentation der Komponente ListBox|ListBox]]'': Listenelement, enthält Strings
+** ''[[ListBox]]'': Listenelement, enthält Strings
-** ''[[Dokumentation der Komponente ComboBox|ComboBox]]'': Aufklappbarer Auswahldialog, enthält Strings
+** ''[[ComboBox]]'': Aufklappbarer Auswahldialog, enthält Strings
-** ''[[Dokumentation der Komponente CheckBox|CheckBox]]'': Kästchen zur binären Auswahl
+** ''[[CheckBox]]'': Kästchen zur binären Auswahl
-** ''[[Dokumentation der Komponente ImageComboBox|ImageComboBox]]'': Aufklappbarer Auswahldialog, enthält Bilder
+** ''[[ImageComboBox]]'': Aufklappbarer Auswahldialog, enthält Bilder
-** ''[[Dokumentation der Komponente SpinEdit|SpinEdit]]'': Eingabefeld für Ganzzahlen, liefert Integer-Werte
+** ''[[SpinEdit]]'': Eingabefeld für Ganzzahlen, liefert Integer-Werte
-** ''[[Dokumentation der Komponente Slider|Slider]]'': auch unter '''TrackBar''' bekannt, Schieberegler, liefert Integer-Werte
+** ''[[Slider]]'': auch unter '''TrackBar''' bekannt, Schieberegler, liefert Integer-Werte
 * ''Caption'': Beschriftung der Komponente, kann leer sein.

@@ Zeile 43: / Zeile 43: @@
 Zusätzlich gibt es das optionale '''Options'''-Objekt, welches bei Bedarf bestimmte Zusatzinformationen enthalten kann - je nach Type.
 <code>
-   # Beispiel für ein Edit-Feld und ein beschränktes Spin-Edit.
+   # Beispiel für ein Edit-Feld und ein beschränktes Spin-Edit mit Optionen
+   [
+     {