Formulaires › Concepteur de formulaires › Fonctions d'éléments de formulaire › Eléments de formulaire › Sélectionner › ca_pam_selectOption(_id, nom, valeur, isSelect)

ca_pam_selectOption(_id, nom, valeur, isSelect)

Sélectionne ou efface une option dans un champ de sélection d'après le nom d'option et la valeur. Vous pouvez également utiliser cette fonction pour empêcher qu'une option spécifique soit sélectionnée.

Cette fonction peut aussi bien sélectionner que désélectionner une option. Si une option n'est pas sélectionnée et que vous voulez sélectionner l'option à l'aide d'un programme, alors isSelect prend la valeur true. Si une option est déjà sélectionnée et que vous voulez désélectionner l'option, l'utilisation d'isSelect prend la valeur false.

Paramètres d'entrée

_id (string)

Spécifie l'identificateur unique du champ de sélection à définir.

name (string)

Spécifie le nom d'une option du champ de sélection spécifique.

value (string)

Définit la valeur d'une option du champ de sélection spécifique. Cette valeur est la valeur existante de l'option.

isSelect (boolean)

Spécifie si le champ est sélectionné (true) ou décoché (false).

Valeur de retour

Aucun.

Exemple :

ca_pam_selectOption('Form.City', 'Carrefour régional', 'Sydney', true);

Cet exemple définit le champ Ville sur l'option nommée Carrefour régional.

Si plusieurs options portent le nom de Carrefour régional, cette fonction applique l'option avec la valeur spécifiée. Cette distinction est importante. Vous pouvez utiliser ca_pam_getSelectedOptionValues(_id) pour identifier la valeur spécifique pour une option de champ, même lorsque plusieurs options ont le même nom. Par exemple, les utilisateurs peuvent continuer d'utiliser un ensemble de formulaires standard pour diriger les activités vers le carrefour régional même si la valeur change.