Funkcja GetCurrentSelections() zwraca listę bieżących wyborów w aplikacji. Jeśli zamiast tego wybory są wykonywane z użyciem szukanego ciągu w polu wyszukiwania, wówczas funkcja GetCurrentSelections() zwraca szukany ciąg.
W razie stosowania opcji należy określić separator record_sep. Aby określić nowy wiersz, należy nadać separatorowi record_sep wartość chr(13)&chr(10).
Jeśli wybrano wszystkie wartości oprócz jednej albo dwóch, zastosowany zostanie odpowiednio format NOT x,y albo NOT y. Jeśli wybrano wszystkie wartości i liczba tych wszystkich wartości będzie większa niż max_values, zwrócona zostanie wartość ALL.
Składnia:
GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])
Typ zwracanych danych: ciąg znaków
Argumenty:
| Argumenty | Opis |
|---|---|
| record_sep | Separator umieszczany między rekordami w polu. Domyślnym separatorem jest wartość <CR><LF> oznaczająca nowy wiersz. |
| tag_sep | Separator umieszczany między znacznikiem nazwy pola i wartościami pola. Domyślnym separatorem jest „: ”. |
| value_sep | Separator do umieszczenia między wartościami pola. Separator do umieszczenia między wartościami pola. Wartością domyślną jest ', '. |
| max_values | Maksymalna liczba wartości pola, które mogą zostać osobno podane. Jeśli zostanie wybrana większa liczba wartości, zostanie zastosowany format „x z y wartości”. Wartością domyślną jest 6. |
| state_name |
Nazwa stanu alternatywnego, który został wybrany dla danej wizualizacji. Jeśli używany jest argument state_name, uwzględniane są tylko wybory powiązane z określoną nazwą stanu. Więcej informacji zawiera temat Korzystanie ze stanów alternatywnych na potrzeby analizy porównawczej. |
Przykłady i wyniki:
W poniższym przykładzie wykorzystano dwa pola załadowane do różnych paneli filtrowania: jedno pole to First name, a drugie pole to Initials.
| Przykłady | Wyniki |
|---|---|
|
Jeśli na liście First name wybrano wartość John. GetCurrentSelections () |
'First name: John' |
|
Jeśli na liście First name wybrano wartości John i Peter. GetCurrentSelections () |
'First name: John, Peter' |
|
Jeśli na liście First name wybrano wartości John oraz Peter, a na liście Initials wybrano wartość JA. GetCurrentSelections () |
'First name: John, Peter Initials: JA' |
|
Jeśli na liście First name wybrano wartość John i na liście Initials wybrano wartość JA. GetCurrentSelections ( chr(13)&chr(10) , ' = ' ) |
'First name = John Initials = JA' |
|
Jeśli na liście First name wybrano wszystkie imiona oprócz Sue i nie wybrano nic na liście Initials. GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3) |
'First name=NOT Sue' |
Dane zastosowane w przykładzie:
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 '|');