# GetStateCounts

A função do gráfico GetStateCounts() é usada para calcular o número total de valores exclusivos que correspondem aos estados de seleção especificados.

Com GetStateCounts(), você pode combinar os cálculos das funções a seguir em uma única chamada de função: GetSelectedCount(), GetNotSelectedCount(), GetAlternativeCount(), GetPossibleCount() e GetExcludedCount(). A contagem dos valores excluídos selecionados também está disponível para ser adicionada ao cálculo. Você pode especificar se cada cálculo de função inclui ou subtrai do total retornado.

Sintaxe:

GetStateCounts (field\_name, state\_name [, state\_type1,...state\_typeN]))

**Tipo de dados de retorno:** inteiro

Argumentos

| Argumento | Descrição |
| --- | --- |
| field\_name | O campo para o qual você está calculando o estado de seleção. Um nome de campo inexistente resulta em um resultado nulo. |
| state\_name | O nome do estado alternativo. Se o argumento estiver vazio (`''`) ou for nulo, o estado alternativo herdado será usado. Use `$` para usar explicitamente o estado padrão. Um nome de estado nomeado (não vazio) que não corresponda a um estado existente resulta em um resultado nulo. |
| state\_type | Uma lista de um ou mais tipos de campo para o valor do campo. Esses tipos de estado serão agregados em uma contagem. Um tipo de estado é especificado usando uma chave. Insira cada chave com aspas simples.<br><br>Quando esse argumento é omitido, a função retorna uma cadeia de caracteres com todas as contagens de campos disponíveis, na mesma ordem da enumeração.<br><br>Para obter uma lista de estados que você pode usar, consulte a tabela. |

Os tipos de estado são referenciados usando chaves específicas. Você pode usar a versão numérica ou textual da chave. Personalize mais de uma chave na mesma expressão para personalizar ainda mais o resultado. Você pode subtrair a contagem total do estado, em vez de adicioná-la. Para fazer isso, use a chave textual e prefixe o tipo de prefixo do estado com um símbolo de menos (`-`).

O tipo de estado e, se aplicável, o símbolo de menos, precisam ser colocados em um conjunto de aspas simples.

Chaves para cada tipo de campo

| Tipo de estado do campo | Descrição | Chave numérica | Chave textual |
| --- | --- | --- | --- |
| Selecionado | Inclui valores selecionados no cálculo. Para conhecer a função equivalente, consulte [GetSelectedCount](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getselectedcount.htm). | 1 | S |
| Opcional | Inclui valores opcionais (não selecionados, mas possíveis de serem selecionados) no cálculo. Para conhecer a função equivalente, consulte [GetPossibleCount](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getpossiblecount.htm). | 2 | O |
| Desmarcado | Inclui valores não selecionados no cálculo. Esse tipo de campo só está disponível quando o campo está no modo e.<br><br>Esse tipo de estado retorna o mesmo cálculo que a função GetNotSelectedCount() retorna, supondo que o argumento include\_excluded nessa função esteja definido como padrão de falso. Para obter mais informações sobre o GetNotSelectedCount(), consulte [GetNotSelectedCount](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/GetNotSelectedCount.htm). | 3 | D |
| Alternativo | Inclui valores não selecionados no cálculo. Para conhecer a função equivalente, consulte [GetAlternativeCount](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getalternativecount.htm). | 4 | A |
| Excluído | Inclui valores excluídos (não selecionados) no cálculo. Para obter a função equivalente, consulte [GetExcludedCount](https://help.qlik.com/pt-BR/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getexcludedcount.htm). | 5 | X |
| Selecionado excluído | Inclui valores excluídos selecionados no cálculo. | 6 | XS |

## Quando usar

Com GetStateCounts(), você pode calcular um estado de seleção personalizado. A função permite consolidar várias chamadas de função em uma única chamada de função, simplificando o processo de escrever sua expressão.

Por exemplo, talvez você precise calcular o número total de valores excluídos, alternativos e selecionados excluídos para um campo. Você pode usar GetStateCounts() para calcular esse total.

Exemplos e resultados

| Exemplos | Resultados |
| --- | --- |
| `=GetStateCounts(ProductName, Null(), 'S')` | Retorna a contagem selecionada para ProductName, no estado alternativo herdado. |
| `=GetStateCounts(ProductName, '', 'A', 'XS')` | Retorna a contagem total dos valores alternativos e selecionados excluídos para ProductName. O estado alternativo herdado é usado. |
| `=GetStateCounts(ProductName, '', 'S', 'XS')` | Retorna a contagem total de seleção de usuários para ProductName, no estado herdado. |
| `=GetStateCounts(ProductName, '', 'X', , 'A', 'XS')` | Contagem total de valores excluídos, selecionados excluídos e alternativos para ProductName. O estado alternativo herdado é usado. |
| Considerando que o campo ProductName está no modo.<br><br><br>`=GetStateCounts(ProductName, '', 'D', '-O')` | Retorna o número de valores não selecionados, subtraído pelo número de valores possíveis, para ProductName. O estado alternativo herdado é usado. |
| `=GetStateCounts(ProductName, '$', 'O')` | Retorna a contagem possível para ProductName, no estado alternativo padrão. |
| `=GetStateCounts(ProductName, 'StateA', 'S')` | Retorna a contagem selecionada de ProductName, no estado alternativo denominado StateA. |

## Exemplo 1 - Contagem do número total de seleções do usuário (incluindo os valores selecionados excluídos)

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Expressão de gráfico

Visão geral

A função GetSelectedCount() retorna o número total de valores selecionados, não incluindo o número total de valores excluídos selecionados. Com GetExcludedCount(), você pode incluir a contagem de valores excluídos selecionados no cálculo do gráfico.

Para começar, adicione o script de carregamento abaixo ao seu documento.

Script de carregamento

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

Resultados

Faça o seguinte:

1. Carregue os dados e crie duas listas em sua pasta.

2. Adicione First name como uma dimensão na primeira lista. Adicione Last name como uma dimensão na segunda lista.

3. Em seguida, crie uma tabela simples com essa medida:

   `=GetStateCounts([First Name],'', 'S','XS')`

4. Na lista First name, selecione os valores Mark e Peter. Na lista do filtro Last name, selecione o valor Carr.

5. Observe que a tabela estática mostra um valor de 2. Isso reflete que todos os valores que você selecionou, incluindo o valor excluído selecionado Peter, são contados.

## Exemplo 2 - Combinação de contagens de excluídos, excluídos selecionados e alternativos

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/ChartFunctions/FieldFunctions/getstatecounts.htm)

#### Expressões de gráfico

Visão geral

A função GetExcludedCount() retorna o número total de valores exclusivos que não são selecionados e excluídos. Se quiser incluir contagens alternativas e excluídas selecionadas em sua visualização, você poderá usar a função GetStateCounts() da seguinte forma.

Para começar, adicione o script de carregamento abaixo ao seu documento.

Script de carregamento

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

Resultados

Faça o seguinte:

1. Carregue os dados e crie duas listas em sua pasta.

2. Adicione First name como uma dimensão na primeira lista. Adicione Last name como uma dimensão na segunda lista.

3. Em seguida, crie uma tabela direta com esta expressão:

   `=GetStateCounts([First name], '', 'X', 'A', 'XS')`

4. Na lista First name, selecione os valores John e Peter. Na lista Last name, selecione o valor Franc.

5. Observe que a tabela estática mostra um valor de 4. Isso reflete que o valor excluído selecionado John está incluído na contagem, além da contagem dos valores excluídos.

6. Edite a tabela estática e substitua a expressão existente pelo seguinte:

   `=GetStateCounts([Last name], '', 'X', 'A', 'XS')`

7. Mantendo as seleções existentes, selecione o valor Anderson na expressão Last name.

8. Observe que a tabela estática ainda mostra um valor de 4. Isso reflete que o valor alternativo Devonshire está incluído na contagem, além da contagem dos valores excluídos.