GetFieldSelections() liefert einen string mit der aktuellen Auswahl eines Feldes.
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:
GetFieldSelections ( field_name [, value_sep [, max_values [, state_name]]])
Rückgabe Datentyp: String
| Format | Beschreibung |
|---|---|
| 'a, b, c' |
Wenn die Anzahl der ausgewählten Werte max_values oder weniger beträgt, ist der zurückgegebene String eine Liste der ausgewählten Werte. Die Werte werden mit value_sep als Trennzeichen getrennt. |
| 'NOT a, b, c' |
Wenn die Anzahl der nicht ausgewählten Werte max_values oder weniger beträgt, ist der zurückgegebene String eine Liste der nicht ausgewählten Werte mit vorangestelltem NOT. Die Werte werden mit value_sep als Trennzeichen getrennt. |
| 'x of y' |
x = Anzahl der ausgewählten Werte y = Gesamtzahl der Werte Dies wird zurückgegeben, wenn max_values < x < ( y - max_values). |
| 'ALL' | Wird zurückgegeben, wenn alle Werte ausgewählt sind. |
| '-' | Wird zurückgegeben, wenn kein Wert ausgewählt ist. |
| <search string> | Wenn Sie anhand einer Suche ausgewählt haben, wird der Such-String zurückgegeben. |
Argumente:
- field_name: Das Feld mit dem Datenbereich, der angegeben werden soll.
- 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.
- state_name: Der Name eines alternativen Zustands, der für diese Visualisierung ausgewählt wurde. Beim Argument state_name werden nur die Auswahlen für den angegebenen Zustandsnamen berücksichtigt. Weitere Informationen finden Sie unter Alternative Status.
Beispiele
Das folgende Beispiel verwendet das Feld First name, das in eine Listbox geladen wird.
Beispiel 1: John ist in First name ausgewählt
GetFieldSelections ([First name])
liefert 'John'
Beispiel 2: John und Peter sind in First name ausgewählt.
GetFieldSelections ([First name])
liefert 'John,Peter'
Beispiel 3: John und Peter sind in First name ausgewählt.
GetFieldSelections ([First name],'; ')
liefert 'John; Peter'
Beispiel 4: John, Sue, Mark sind in First name ausgewählt
GetFieldSelections ([First name],';',2)
gibt 'NOT Jane;Peter' zurück, weil der Wert 2 als Wert des Arguments max_values angegeben ist. Andernfalls wäre das Ergebnis Folgendes gewesen: John; Sue; Mark.
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 '|');
