GetSelectedCount() находит выбранные (зеленые) значения в поле.
Синтаксис:
GetSelectedCount (field_name [, include_excluded [, state_name]])
Возвращаемые типы данных: integer
Цвета, используемые на панели выборок и для каждого состояния выборки, можно изменить с помощью пользовательской темы. При работе с приложением, в котором применяется пользовательская тема, можно заметить, что отображаемые цвета выборок не совпадают с описанными в разделе справки.
Аргументы:
| Аргументы | Описание |
|---|---|
| field_name | Поле, содержащее диапазон данных для измерения. |
| include_excluded | Если установлено значение True(), при подсчете будут учитываться выбранные значения, которые в настоящее время исключаются выборками в других полях. Если значения являются False или опущены, эти значения не будут включены. |
| state_name |
Имя альтернативного состояния, выбранное для определенной визуализации. Если используется аргумент state_name, учитываются только выборки, связанные с указанным именем состояния. Для получения дополнительной информации см. Использование альтернативных состояний для сравнительного анализа. |
В следующей таблице перечислены другие функции, связанные с данной функцией.
| Функция | Взаимодействие |
|---|---|
| GetStateCounts — функция диаграммы |
GetStateCounts() позволяет объединить вычисление следующих счетчиков с помощью одного вызова функции:
|
| GetPossibleCount — функция диаграммы | Возвращает количество возможных значений. |
| GetAlternativeCount — функция диаграммы | Возвращает количество альтернативных значений. |
| GetSelectedCount — функция диаграммы | Возвращает количество исключенных значений, не включающее альтернативные и выбранные исключенные значения. |
Примеры и результаты:
В следующем примере используется три поля, загруженных в разные фильтры: одно для элемента First name, второе для элемента Initials, а третье для элемента Has cellphone.
| Примеры | Результаты |
|---|---|
|
При условии, что элемент John выбран в элементе First name. GetSelectedCount ([First name]) |
Значение 1, поскольку одно значение выбрано в элементе First name. |
|
При условии, что элемент John выбран в элементе First name. GetSelectedCount ([Initials]) |
Значение 0, поскольку в элементе Initials значения не выбраны. |
|
При отсутствии выборок в First name выберите все значения в Initials, а затем выберите значение Yes в Has cellphone. GetSelectedCount ([Initials], True()) |
6. Хотя выборки со значениями MC и PD в столбце Initials имеют свойство Has cellphone, заданное как No, результатом все равно будет 6, поскольку для аргумента include_excluded задано значение True(). |
Данные, используемые в примере:
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 '|');