GetCurrentSelections — функция диаграммы

GetCurrentSelections() возвращает текущие выборки в приложении.

Если параметры используются, необходимо указать record_sep. Чтобы указать новый размер строки, установите для параметра record_sep значение chr(13)&chr(10).

Если выбраны все значения, кроме двух или одного значения, будет использован формат «NOT x,y» или «NOT y» соответственно. Если выбраны все значения, и число всех значений больше, чем max_values, будет возвращен текст ALL.

Syntax:

GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])

Return data type: строка

Arguments:

Аргументы	Описание
record_sep	Разделитель должен стоять между записями в поле. Значение по умолчанию <CR><LF> означает новую строку.
tag_sep	Разделитель должен стоять между тегом имени поля и значениями поля. По умолчанию используется «: ».
value_sep	Разделитель значений в поле. По умолчанию используется «, ».
max_values	Максимальное число отдельно отображаемых значений, введенных в поле. При вводе большого числа значений используется формат «x из y значений». По умолчанию установлено 6.
state_name	Имя альтернативного состояния, выбранное для определенной визуализации. Если используется аргумент state_name, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. Использование альтернативных состояний для сравнительного анализа.

Examples and results:

В следующем примере используются два поля, загруженные в разные поля фильтра, одно для имени First name, а второе для Initials.

Примеры	Результаты
При условии, что элемент John выбран в элементе First name. GetCurrentSelections ()	'First name: John'
При условии выбора элементов John и Peter в элементе First name. GetCurrentSelections ()	'First name: John, Peter'
При условии выбора элементов John и Peter в элементе First name и выбора элемента JA в элементе Initials. GetCurrentSelections ()	'First name: John, Peter Initials: JA'
При условии выбора элемента John в элементе First name, а JA в элементе Initials. GetCurrentSelections ( chr(13)&chr(10) , ' = ' )	'First name = John Initials = JA'
При условии выбора всех имен, кроме Sue, в элементе First name и отсутствии выборок в элементе Initials. GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3)	'First name=NOT Sue'

Примеры

Результаты

При условии, что элемент John выбран в элементе First name.

GetCurrentSelections ()

'First name: John'

При условии выбора элементов John и Peter в элементе First name.

GetCurrentSelections ()

'First name: John, Peter'

При условии выбора элементов John и Peter в элементе First name и выбора элемента JA в элементе Initials.

GetCurrentSelections ()

'First name: John, Peter

Initials: JA'

При условии выбора элемента John в элементе First name, а JA в элементе Initials.

GetCurrentSelections ( chr(13)&chr(10) , ' = ' )

'First name = John

Initials = JA'

При условии выбора всех имен, кроме Sue, в элементе First name и отсутствии выборок в элементе Initials.

GetCurrentSelections (chr(13)&chr(10), '=', ',' ,3)

'First name=NOT Sue'

Данные, используемые в примере:

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