Änderungen von Dokument Voraussetzung Word


Von Version 4.16
bearbeitet von awa
am 21.07.2022, 13:04
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 4.21
bearbeitet von awa
am 21.07.2022, 13:16
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -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.