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
| Formatcode | 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' | Zurückgegeben, wenn alle Werte ausgewählt sind. |
| '-' | Zurückgegeben, wenn kein Wert ausgewählt ist. |
| <search string> | Wenn Sie Auswahlen über die Suche getroffen haben, wird das Suchwort 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 die betreffende Visualisierung ausgewählt wurde. Wenn das Argument state_name verwendet wird, werden nur die Auswahlen berücksichtigt, die mit dem angegebenen Zustandsnamen verknüpft sind. Weitere Informationen finden Sie unter Alternative Status.
Beispiele
Im folgenden Beispiel wird das in eine Listbox geladene Feld First name verwendet.
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 in First name ausgewählt
GetFieldSelections ([First name],';',2)
liefert 'NOT Jane;Peter', 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 '|');
