Przeskocz do zawartości głównej

GetCurrentSelections — funkcja wykresu

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
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 i wyniki
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 '|');