# GetSelectedCount - função de gráfico GetSelectedCount() encontra o número de valores (verde) selecionados em um campo. [Using Calculation Conditions](https://play.vidyard.com/UDRXiPe6LFDgdePb4CuF3L) Sintaxe: GetSelectedCount (field\_name [, include\_excluded [, state\_name]]) Tipo de dados de retorno: inteiro Nota informativa As cores usadas na barra de seleção e para cada estado de seleção podem ser modificadas com um tema personalizado. Se você estiver trabalhando com um aplicativo que usa um tema personalizado, poderá notar que suas seleções não são exibidas com as mesmas cores descritas neste tópico de ajuda. Argumentos | Argumentos | Descrição | | --- | --- | | field\_name | O campo que contém o intervalo de dados que será medido. | | include\_excluded | Se for definido como True(), a contagem incluirá os valores selecionados, atualmente excluídos por seleções em outros campos. Se False ou omitido, esses valores não serão incluídos. | | state\_name | O nome de um estado alternativo que foi escolhido para a visualização específica. Se o argumento state\_name for usado, apenas as seleções associadas ao nome do estado especificado serão levadas em consideração.

Para obter mais informações, consulte [Usando estados alternados para análise comparativa](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/alternate-states-comparative-analysis.htm). | A tabela a seguir lista outras funções relacionadas a essa função. Funções relacionadas | Função | Interação | | --- | --- | | [GetStateCounts - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getstatecounts.htm) | Usando GetStateCounts(), você pode combinar o cálculo das contagens a seguir usando uma única chamada de função:

| | [GetPossibleCount - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getpossiblecount.htm) | Retorna a contagem de valores possíveis. | | [GetAlternativeCount - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getalternativecount.htm) | Retorna a contagem de valores alternativos. | | [GetSelectedCount - função de gráfico](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm#) | Retorna a contagem de valores excluídos, não incluindo valores excluídos alternativos e selecionados. | Exemplo: expressões de gráfico | Exemplo | Resultado | | --- | --- | | `GetSelectedCount (FirstName)` | Se nenhuma seleção for feita, o endereço `0` será retornado. Se alguma seleção tiver sido feita no campo `FirstName`, o número de itens selecionados será retornado. | | ` GetSelectedCount (FirstName, True()) ` | Se nenhuma seleção for feita, o endereço `0` será retornado. Se alguma seleção tiver sido feita no campo `FirstName`, o número de itens selecionados será retornado, independentemente de quaisquer seleções subsequentes em outros campos que possam reduzir os valores disponíveis no campo `FirstName`. | ## Exemplo - Fundamentos de GetSelectedCount [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) #### Expressão de gráfico Visão geral Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção. O script de carregamento contém: * Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`. * Os campos a seguir na tabela de dados: * `FirstName` * `LastName` * `Initials` * `HasCellphone` Script de carregamento ``` Example: LOAD * inline [ FirstName|LastName|Initials|HasCellphone 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 1. Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões: * `FirstName` * `Initials` 2. Crie dois objetos de KPI, um para cada uma das expressões de medida a seguir: * KPI 1: `=GetSelectedCount(FirstName)` para retornar o número de itens selecionados no campo `FirstName`. * KPI 2: `=GetSelectedCount(Initials)`, para retornar o número de itens selecionados no campo `Initials`. Cada KPI retorna o número de itens selecionados em cada campo. Sem seleções nos filtros, ambos os KPIs retornam o valor `0`. Nota de dicaNeste exemplo, o estilo do KPI foi ajustado para usar um comportamento de layout ágil para facilitar a exibição do resultado. [Estilizando o KPI](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/KPI.htm#Styling). 3. Clique em Editar pasta para alternar para o modo de análise e, em seguida, selecione `John` no filtro `FirstName`. O KPI 1 retorna o valor `1` porque há um item selecionado no filtro `FirstName`. O KPI 2 ainda retorna `0` porque o filtro `Initials` não tem itens selecionados. ![Dois KPIs com dois painéis de filtro associados.](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetSelCnt-example.png) ## Exemplo – GetSelectedCount com o parâmetro include\_excluded [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm) #### Expressão de gráfico Visão geral Este exemplo usa o mesmo conjunto de dados do exemplo anterior, mas demonstra a diferença nos resultados quando o parâmetro `include_excluded` é definido como `True()`. Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção. O script de carregamento contém: * Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`. * Os campos a seguir na tabela de dados: * `FirstName` * `LastName` * `Initials` * `HasCellphone` Script de carregamento ``` Example: LOAD * inline [ FirstName|LastName|Initials|HasCellphone 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 1. Carregue os dados e abra uma pasta. Crie um novo painel de filtro e adicione estes campos como dimensões: * `Initials` * `HasCellPhone` 2. Crie dois objetos de KPI, um para cada uma das expressões de medida a seguir: * KPI 1: `=GetselectedCount(Initials)` para determinar o número de valores que foram selecionados no campo `Initials`. * KPI 2: `=GetSelectedCount([Initials], True())` para incluir os valores selecionados que estão atualmente excluídos por seleções em outros campos. Sem seleções no painel de filtro, cada KPI retorna o valor `0`. Nota de dicaNeste exemplo, o estilo do KPI foi ajustado para usar um comportamento de layout ágil para facilitar a exibição do resultado. [Estilizando o KPI](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/KPI/KPI.htm#Styling). 3. Clique em Editar pasta para alternar para o modo de análise. Selecione todos os valores no filtro `Initials` e, em seguida, selecione `Yes` no filtro `HasCellphone`. ![Dois KPIs com dois painéis de filtro associados.](https://help.qlik.com/pt-BR/sense/May2026/Subsystems/Hub/Content/Resources/Images/scripting-functions-GetSelCnt-example2.png) Ao comparar os resultados de cada KPI, você pode ver como cada um retorna um valor diferente, dependendo de o parâmetro `include_excluded` estar definido como `True()` ou não. O KPI 2 retorna o valor `6` porque inclui todos os valores selecionados no filtro `Initials`, mesmo que a seleção no filtro `HasCellphone` tenha reduzido os itens disponíveis para `4`. O KPI 1 retorna `4` porque não conta os valores excluídos selecionados em `Initials`.