GetCurrentSelections() liefert die aktuelle Auswahl in dem Dokument.
Wenn Optionen verwendet werden sollen, müssen Sie record_sep definieren. Definieren Sie eine neue Zeile, indem Sie record_sep als chr(13)&chr(10) angeben.
Wenn alle bis auf zwei oder alle bis auf einen Wert ausgewählt sind, wird das Format 'NOT x,y' beziehungsweise 'NOT y' verwendet. Wenn Sie alle Werte auswählen und die Anzahl aller Werte größer als max_values ist, wird der Text ALL ausgegeben.
Syntax:
GetCurrentSelections ([record_sep [,tag_sep [,value_sep [,max_values]]]])
Rückgabe Datentyp: String
Argumente:
- record_sep: Trennzeichen zwischen Felddatensätzen. Standard ist <CR><LF>, d. h. eine neue Zeile.
- tag_sep: Trennzeichen zwischen dem Feldnamen und den Feldwerten. Standard ist ':'.
- value_sep: Das Trennzeichen zwischen Feldwerten. Standard ist ','.
- max_values: Die maximale Zahl der einzeln aufgeführten Feldwerte. Wird eine größere Anzahl an Werten ausgewählt, wird das Format 'x von y Werten' verwendet. Standard ist 6.
Beispiele
Im folgenden Beispiel werden zwei Felder verwendet, die in verschiedene Listboxen geladen wurden: eins für First name und eins für Initials.
Beispiel 1: John ist in First name ausgewählt
GetCurrentSelections ()
liefert 'First name: John'.
Beispiel 2: John und Peter sind in First name ausgewählt.
GetCurrentSelections ()
liefert 'First name: John, Peter'.
Beispiel 3: John ist in First name und JA ist in Initials ausgewählt.
GetCurrentSelections ()
liefert 'First name: John; Peter und Initials: JA'.
Beispiel 4: John ist in First name und JA ist in Initials ausgewählt.
GetCurrentSelections ( chr(13)&chr(10) , ' = ' )
liefert 'First name = John und Initials = JA'.
Beispiel 5: alle Namen außer Sue sind in First name ausgewählt und es sind keine Auswahlen in Initials vorhanden.
=GetCurrentSelections(chr(13)&chr(10),'=',',',3)
liefert 'First name=NOT Sue'.
Im Beispiel verwendete Daten:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
