... |
... |
@@ -50,87 +50,110 @@ |
50 |
50 |
sel1.lsttxt() |
51 |
51 |
{{/code}} |
52 |
52 |
|
|
53 |
+=== Format |
|
54 |
+ |
53 |
53 |
Word-Fill-Funktionen haben immer das folgende Format (Anführungszeichen werden unterstützt ab {{version major="7" minor="1"/}}): |
54 |
54 |
|
|
57 |
+==== Word-Function |
|
58 |
+ |
55 |
55 |
{{code language="none"}} |
56 |
|
-// Eine Word-Funktion besteht aus einem Feldnamen, gefolgt von Funktionen, jeweils mit Punkt abgetrennt. |
57 |
|
-// Jede Funktion kann ein Argument haben, muss es aber nicht. |
58 |
|
-// Es kann keine, eine, oder mehrere Funktionen geben. |
59 |
|
-// |
60 |
|
-// Beispiele: |
61 |
|
-// |
62 |
|
-// sel1 |
63 |
|
-// sel1.funktion1() |
64 |
|
-// sel1.funktion1(argument) |
65 |
|
-// sel1.funktion1().funktion2() |
66 |
|
-// sel1.funktion1(argument).funktion2().funktion3() |
67 |
67 |
<Word-Function> = <Field-Name> ["." <Function-Name> "(" <Argument>? ")" ] * |
|
61 |
+{{/code}} |
68 |
68 |
|
69 |
|
-// Das Argument kann entweder eine Liste von Werten sein oder eine Zuordnung von Schlüsseln zu Werten. |
70 |
|
-// Welche Art von Argument benutzt werden muss, hängt von der konkreten Funktion ab. |
|
63 |
+Eine Word-Funktion besteht aus einem Feldnamen, gefolgt von Funktionen, jeweils mit Punkt abgetrennt. Jede Funktion kann ein Argument haben, muss es aber nicht. Es kann keine, eine, oder mehrere Funktionen geben. |
|
64 |
+ |
|
65 |
+{{code language="none"}} |
|
66 |
+sel1 |
|
67 |
+sel1.funktion1() |
|
68 |
+sel1.funktion1(argument) |
|
69 |
+sel1.funktion1().funktion2() |
|
70 |
+sel1.funktion1(argument).funktion2().funktion3() |
|
71 |
+{{/code}} |
|
72 |
+ |
|
73 |
+==== Argument |
|
74 |
+ |
|
75 |
+{{code language="none"}} |
71 |
71 |
<Argument> = <ArgList> | <ArgMap> |
|
77 |
+{{/code}} |
72 |
72 |
|
73 |
|
-// Einerseits kann das Argument eine Liste von Werten sein, die mit einer vertikalen Linie voneinander |
74 |
|
-// getrennt sind. |
75 |
|
-// Wieviele Werte an eine Funktion übergeben werden müssen, hängt von der konkreten Funktion ab. |
76 |
|
-// |
77 |
|
-// Beispiele: |
78 |
|
-// |
79 |
|
-// sel1.function(wert1) |
80 |
|
-// sel1.function(wert1|wert2) |
81 |
|
-// sel1.function(wert1|wert2|wert3) |
|
79 |
+Das Argument kann entweder eine Liste von Werten sein oder eine Zuordnung von Schlüsseln zu Werten. Welche Art von Argument benutzt werden muss, hängt von der konkreten Funktion ab. |
|
80 |
+ |
|
81 |
+==== ArgList |
|
82 |
+ |
|
83 |
+{{code language="none"}} |
82 |
82 |
<ArgList> = <Value> [ "|" <Value> ] * |
|
85 |
+{{/code}} |
83 |
83 |
|
84 |
|
-// Anderseits kann das Argument auch eine Zuorndung von Schlüsseln zu Werten sein. Die Schlüssel und |
85 |
|
-// die Werte sind durch eine Raute voneinander getrennt. |
86 |
|
-// Welche Schlüssel und welche Werte an eine Funktion übergeben werden müssen, hängt von der konkreten Funktion ab. |
87 |
|
-// |
88 |
|
-// Beispiele: |
89 |
|
-// |
90 |
|
-// sel1.function(schlüssel1#wert1) |
91 |
|
-// sel1.function(schlüssel1|schlüssel2#wert1|wert2) |
92 |
|
-// sel1.function(schlüssel1|schlüssel2|schlüssel3#wert1|wert2|wert3) |
|
87 |
+Einerseits kann das Argument eine Liste von Werten sein, die mit einer vertikalen Linie voneinander getrennt sind. Wieviele Werte an eine Funktion übergeben werden müssen, hängt von der konkreten Funktion ab. |
|
88 |
+ |
|
89 |
+{{code language="none"}} |
|
90 |
+sel1.function(wert1) |
|
91 |
+sel1.function(wert1|wert2) |
|
92 |
+sel1.function(wert1|wert2|wert3) |
|
93 |
+{{/code}} |
|
94 |
+ |
|
95 |
+==== ArgMap |
|
96 |
+ |
|
97 |
+{{code language="none"}} |
93 |
93 |
<ArgMap> = <ArgList> "#" <ArgList> |
|
99 |
+{{/code}} |
94 |
94 |
|
95 |
|
-// Jeder Wert ist dabei im einfachsten Fall nur eine Zeichenfolge. |
96 |
|
-// |
97 |
|
-// Beispiele: |
98 |
|
-// |
99 |
|
-// sel1.function(Ein Wert) |
100 |
|
-// sel1.function(Noch ein Wert) |
101 |
|
-// sel1.function(Wert1|Wert2) |
102 |
|
-// |
103 |
|
-// Manche Sonderzeichen wie Klammern, Punkte oder Rauten können dabei aber nicht verwendet werden. |
104 |
|
-// Dann ist es auch möglich, den Wert in einfache oder doppelte Anführungszeichen zu setzen. |
105 |
|
-// Werte ohne Anführungszeichen existieren aus Kompatibilitätsgründen, die Nutzung von |
106 |
|
-// Anführungszeichen wird empfohlen und ist nie verkehrt. |
107 |
|
-// |
108 |
|
-// Beispiele: |
109 |
|
-// |
110 |
|
-// sel1.function('Wert (mit) Klammern') |
111 |
|
-// sel1.function("Wert (mit) Klammern") |
112 |
|
-// sel1.function("Wert einem Punkt und einer Raute #.") |
113 |
|
-// sel1.function('Wert#1'|'Wert#2') |
114 |
|
-// |
115 |
|
-// Weiterhin können innerhalb von Werten mit Anführungszeichen spezielle Escape-Sequenzen verwendet werden: |
116 |
|
-// sel1.function("Otto sagte: \"Es regnet\"") |
117 |
|
-// sel1.function('Otto sagte: \"Es regnet\'') |
118 |
|
-// sel1.function("Mit dem Zeichen \\ werden Escape-Sequenzen eingeleitet") |
119 |
|
-// sel1.function("Zeilenumbruch: \r\n") |
120 |
|
-// sel1.function("Tabulator: \t") |
121 |
|
-// sel1.function("Unicode-Zeichen: \u578b") |
122 |
|
-// |
123 |
|
-// Achtung: Werden keine Anführungszeichen benutzt, gehören alle Leerzeichen zum Wert. Das folgende |
124 |
|
-// sind zwei verschiedene Werte (einmal ohne und einmal mit Leerzeichen am Anfang): |
125 |
|
-// sel1.function(Test) |
126 |
|
-// sel1.function( Test) |
127 |
|
-// Bei Nutzung von Anführungszeichen sind Leerzeichen vor oder nach dem Anführungszeichen egal. Das |
128 |
|
-// folgende hat die gleiche Bedeutung: |
129 |
|
-// sel1.function("Test") |
130 |
|
-// sel1.function( "Test") |
|
101 |
+Anderseits kann das Argument auch eine Zuorndung von Schlüsseln zu Werten sein. Die Schlüssel und die Werte sind durch eine Raute voneinander getrennt. Welche Schlüssel und welche Werte an eine Funktion übergeben werden müssen, hängt von der konkreten Funktion ab. |
|
102 |
+ |
|
103 |
+{{code language="none"}} |
|
104 |
+sel1.function(schlüssel1#wert1) |
|
105 |
+sel1.function(schlüssel1|schlüssel2#wert1|wert2) |
|
106 |
+sel1.function(schlüssel1|schlüssel2|schlüssel3#wert1|wert2|wert3) |
|
107 |
+{{/code}} |
|
108 |
+ |
|
109 |
+==== Value |
|
110 |
+ |
|
111 |
+{{code language="none"}} |
131 |
131 |
<Value> = <Unquoted-String> | <Singly-Quoted-String> | <Doubly-Quoted-String> |
132 |
132 |
{{/code}} |
133 |
133 |
|
|
115 |
+Jeder Wert ist dabei im einfachsten Fall nur eine Zeichenfolge. |
|
116 |
+ |
|
117 |
+{{code language="none"}} |
|
118 |
+sel1.function(Ein Wert) |
|
119 |
+sel1.function(Noch ein Wert) |
|
120 |
+sel1.function(Wert1|Wert2) |
|
121 |
+{{/code}} |
|
122 |
+ |
|
123 |
+Manche Sonderzeichen wie Klammern, Punkte oder Rauten können dabei aber nicht verwendet werden. Dann ist es auch möglich, den Wert in einfache oder doppelte Anführungszeichen zu setzen ({{version major="7" minor="1"/}}). Werte ohne Anführungszeichen existieren aus Kompatibilitätsgründen, die Nutzung von Anführungszeichen wird empfohlen und ist nie verkehrt. |
|
124 |
+ |
|
125 |
+{{code language="none"}} |
|
126 |
+sel1.function('Wert (mit) Klammern') |
|
127 |
+sel1.function("Wert (mit) Klammern") |
|
128 |
+sel1.function("Wert einem Punkt und einer Raute #.") |
|
129 |
+sel1.function('Wert#1'|'Wert#2') |
|
130 |
+{{/code}} |
|
131 |
+ |
|
132 |
+Weiterhin können innerhalb von Werten mit Anführungszeichen spezielle Escape-Sequenzen verwendet werden: |
|
133 |
+ |
|
134 |
+{{code language="none"}} |
|
135 |
+sel1.function("Otto sagte: \"Es regnet\"") |
|
136 |
+sel1.function('Otto sagte: \"Es regnet\'') |
|
137 |
+sel1.function("Mit dem Zeichen \\ werden Escape-Sequenzen eingeleitet") |
|
138 |
+sel1.function("Zeilenumbruch: \r\n") |
|
139 |
+sel1.function("Tabulator: \t") |
|
140 |
+sel1.function("Unicode-Zeichen: \u578b") |
|
141 |
+{{/code}} |
|
142 |
+ |
|
143 |
+Achtung: Werden keine Anführungszeichen benutzt, gehören alle Leerzeichen zum Wert. Das folgende sind zwei verschiedene Werte (einmal ohne und einmal mit Leerzeichen am Anfang): |
|
144 |
+ |
|
145 |
+{{code language="none"}} |
|
146 |
+sel1.function(Test) |
|
147 |
+sel1.function( Test) |
|
148 |
+{{/code}} |
|
149 |
+ |
|
150 |
+Bei Nutzung von Anführungszeichen sind Leerzeichen vor oder nach dem Anführungszeichen egal. Das folgende hat die gleiche Bedeutung: |
|
151 |
+ |
|
152 |
+{{code language="none"}} |
|
153 |
+sel1.function("Test") |
|
154 |
+sel1.function( "Test") |
|
155 |
+{{/code}} |
|
156 |
+ |
134 |
134 |
== Verfügbare Funktionen == |
135 |
135 |
|
136 |
136 |
{{table dataTypeAlpha="0" preSort="0"}} |
... |
... |
@@ -138,7 +138,7 @@ |
138 |
138 |
| lsttxt |Ersetzung aller Werte einer Auswahl mit dem Text-Wert. Steht für //list text.//| SEL1.lsttxt() |Liefert den Text-Wert des [[Auswahlelements>>Formcycle.Designer.Form.FormElements.Selection]] mit Namen //SEL1// zurück |
139 |
139 |
| lsttitle |Ersetzung aller Werte einer Auswahl mit dem Titel-Wert. Steht für //list title//.| SEL1.lsttitle() |Liefert den Titel-Wert (falls hinterlegt) des Auswahlelements mit Namen //SEL1// zurück. |
140 |
140 |
| lst |Ersetzung aller Werte einer Auswahl mit dem entsprechenden col-Attributs. Dabei muss das col-Attribut mit der laufenden Nummer übergeben werden. Die erste Spalte hat die Nummer 0. | SEL1.lst(col2) |Liefert die 3. Spalte einer Datenquelle (falls hinterlegt) des Auswahlelements mit Namen //SEL1// zurück. |
141 |
|
-| con |Prüfung ob ein Wert in der Liste vorhanden ist. Bei Mehrfachauswahl hilfreich. Steht für //contains.//| SEL1.con(5) |Liefert //1,// wenn das Auswahlelement mit Namen //SEL1// einen Wert vorhanden ist, sonst //0, //wenn keine Auswahl getroffen wurde//.// |
|
164 |
+| con |Prüfung ob ein Wert in der Liste vorhanden ist. Bei Mehrfachauswahl hilfreich. Steht für //contains.//| SEL1.con(6|9|69) |Liefert //1// wenn am Auswahlelement mit Namen //SEL1// der Wert "6", "9" oder "69" ausgewählt ist, sonst //0//. |
142 |
142 |
| cnt |Zählt die vorhandenen Werte. Bei dynamic sinnvoll. Steht für //count//.| SEL1.cnt() |Liefert die Anzahl der erzeugten Elemente des auf [[wiederholt geschalteten>>Formcycle.Designer.Form.ElementProperties.BaseProperties]] Auswahlelements //SEL1//. |
143 |
143 |
| rmp |Einen Absatz (Paragraphen) entfernen. Steht für //remove paragraph.// | EL1.rmp() |Entfernt Zeile und Paragraphen, wenn Inhalt des Elements leer ist |
144 |
144 |
| rmr |Tabellenzeile löschen, in der sich das Steuerelement befindet. Steht für //remove row.// |{{{EL1.rmr(x)}}} |Entfernt die Zeile der Tabelle, wenn das Formularelement //EL1// den Wert //x// hat. |