GetSelectedCount() permet de déterminer le nombre de valeurs sélectionnées (en vert) d'un champ.
GetSelectedCount (field_name [, include_excluded [, state_name]])
entier
Les couleurs utilisées dans la barre de sélection et pour chaque état de sélection peuvent être remplacées par un thème personnalisé. Si vous utilisez une application qui applique un thème personnalisé, vous remarquerez peut-être que vos sélections ne s'affichent pas avec les mêmes couleurs que celles décrites dans la rubrique d'aide.
| Arguments | Description |
|---|---|
| field_name | Champ contenant la plage de données à mesurer. |
| include_excluded | Si cet argument est défini sur True(), le décompte inclut les valeurs sélectionnées, qui sont actuellement exclues par des sélections dans d'autres champs. Si l'argument est défini sur False ou s'il est omis, ces valeurs sont exclues. |
| state_name |
Nom d'un état alternatif ayant été choisi pour cette visualisation en particulier. Si l'argument state_name est utilisé, seules les sélections associées au nom d'état spécifié sont prises en compte. Pour plus d'informations, voir Utilisation d'états alternatifs à des fins d'analyse comparative. |
Le tableau suivant répertorie d'autres fonctions associées à cette fonction.
| Fonction | Interaction |
|---|---|
| GetStateCounts - fonction de graphique |
Si vous utilisez GetStateCounts(), vous pouvez combiner le calcul des nombres suivants à l'aide d'un seul appel de fonction :
|
| GetPossibleCount - fonction de graphique | Renvoie le nombre de valeurs possibles. |
| GetAlternativeCount - fonction de graphique | Renvoie le nombre de valeurs alternatives. |
| GetSelectedCount - fonction de graphique | Renvoie le nombre de valeurs exclues, à l'exclusion des valeurs exclues alternatives et sélectionnées. |
L'exemple suivant utilise trois champs chargés dans des volets de filtre différents, un pour le prénom First name, un autre pour les initiales Initials et un autre encore pour les propriétaires de téléphone portable Has cellphone.
| Exemples | Résultats |
|---|---|
|
Supposons que John est sélectionné dans First name. GetSelectedCount ([First name]) |
1, car une valeur est sélectionnée dans First name. |
|
Supposons que John est sélectionné dans First name. GetSelectedCount ([Initials]) |
0, car aucune valeur n'est sélectionnée dans Initials. |
|
Si aucune sélection n'est effectuée dans First name, sélectionnez toutes les valeurs contenues dans Initials, puis choisissez la valeur Yes dans Has cellphone. GetSelectedCount ([Initials], True()) |
6. Même si les sélections comportant les valeurs Initials MC et PD ont Has cellphone défini sur No, le résultat reste 6, car l'argument include_excluded est défini sur True(). |
Données utilisées dans l'exemple :
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 '|');