GetCurrentSelections — функция диаграммы
GetCurrentSelections() возвращает список текущих выборок в приложении. Если выборки были выполнены при помощи строки поиска в окне поиска, GetCurrentSelections() возвращает строку поиска.
Если параметры используются, необходимо указать record_sep. Чтобы указать новый размер строки, установите для параметра record_sep значение chr(13)&chr(10).
Если выбраны все значения, кроме двух или одного значения, будет использован формат «NOT x,y» или «NOT y» соответственно. Если выбраны все значения, и число всех значений больше, чем max_values, будет возвращен текст ALL.
Синтаксис:
GetCurrentSelections ([record_sep [, tag_sep [, value_sep [, max_values [, state_name]]]]])
Возвращаемые типы данных: строка
Аргументы:
Аргументы | Описание |
---|---|
record_sep | Разделитель должен стоять между записями в поле. Значение по умолчанию <CR><LF> означает новую строку. |
tag_sep | Разделитель должен стоять между тегом имени поля и значениями поля. По умолчанию используется «: ». |
value_sep | Разделитель значений в поле. По умолчанию используется «, ». |
max_values | Максимальное число отдельно отображаемых значений, введенных в поле. При вводе большого числа значений используется формат «x из y значений». По умолчанию установлено 6. |
state_name |
Имя альтернативного состояния, выбранное для определенной визуализации. Если используется аргумент state_name, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. Использование альтернативных состояний для сравнительного анализа. |
Примеры и результаты:
В следующем примере используются два поля, загруженные в разные поля фильтра, одно для имени 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' |
Данные, используемые в примере:
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 '|');