Composant Web Zone de sélection

Le composant Web Zone de sélection permet à l'utilisateur de sélectionner une ou plusieurs valeurs dans une zone de liste, à la différence du composant Web Zone de liste, qui ne permet de choisir qu'une seule valeur dans la liste.

Onglet Général (iwcl:WSelectionBox)

Nom
Indiquez un identificateur unique pour le composant Web IBM® i. Le nom ne doit comprendre ni blancs ni traits d'union. Voir Règles concernant les valeurs et les noms des composants Web IBM i.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Lignes
Indiquez le nombre de lignes visibles pour l'utilisateur. Le nombre de lignes par défaut est 4 et l'option Sélection multiple est admise. Si le nombre de lignes indiqué est limité à 1, le composant Web est semblable à une zone de liste.
Etat initial
Sélectionnez Activé, Masqué, Sélection multiple (ou une combinaison de ces options.)
Désactivé
Indique que le composant Web n'est pas disponible.
Masqué
Indique que le composant Web n'apparaît pas sur la page.
Sélection multiple
Indique que l'utilisateur peut sélectionner plusieurs valeurs dans le composant Web.
Orientation
Sélectionnez la valeur de votre choix pour définir le sens de lecture du texte et l'alignement du composant Web sur la page. Les valeurs possibles sont les suivantes : Par défaut, Gauche à droite, ou Droite à gauche.
Par défaut
Indique que le sens de lecture du texte et l'alignement du composant Web sur la page sont hérités de l'élément contenant.

Par exemple, si le composant Web est inséré dans un formulaire et que le sens de lecture sélectionné pour ce formulaire est Droite à gauche, ce sens s'applique également au composant Web.

La valeur par défaut est Gauche à droite.

Gauche à droite
Indique que le texte doit être lu de gauche à droite et que le composant Web est aligné à gauche sur la page. Cette valeur remplace la valeur héritée.
Droite à gauche
Indique que le texte doit être lu de droite à gauche et que le composant Web est aligné à droite sur la page. Cette valeur remplace la valeur héritée.
Infobulle
Entrez la description qui s'affiche lorsque le pointeur de la souris se trouve au niveau du composant Web.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Clé d'accès
Associez un caractère à une touche de raccourci pour permettre à l'utilisateur d'activer le composant Web.
Indice de tabulation
Entrez un numéro correspondant à l'ordre de tabulation du composant Web créé. Par exemple, la valeur 1 signifie que ce composant Web est le premier objet à être activé dans la séquence de tabulation.
Libellé
Entrez une légende pour le composant Web.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Position du libellé
Indiquez la position de la légende en sélectionnant Haut ou Gauche.
Haut
Positionne la légende au-dessus du composant Web.
Gauche
Permet de positionner la légende à gauche du composant Web lorsque l'orientation est définie comme Gauche à droite. Si Droite à gauche est indiqué, la légende est placée à droite du composant Web.

Onglet Données

Les données renvoyées par un programme hôte à un composant Web Zone de liste peuvent se présenter sous deux formats. Supposons que la zone de liste soit définie dans la vue Attributs, lors de la conception, avec trois données Pomme, Orange et Banane, chacune de ses données ayant, respectivement, les valeurs P, O et B. La donnée Banane est définie sur Vrai, ce qui indique qu'elle est présélectionnée dans la zone de liste.
  • Si la valeur renvoyée par le programme hôte est une zone unique sans délimiteur, de valeur O (Orange dans cet exemple), alors la zone de sélection affiche les éléments définis au départ, mais l'élément identifié par la valeur O devient l'élément présélectionné.
  • Si la valeur renvoyée est un tableau avec les éléments Pomme de terre;P;Faux, Carotte;C;Vrai et Tomate;T;Faux (c'est-à-dire au format clé-valeur-sélection avec délimiteurs), les données sont traitées en tant que données dynamiques et elles écrasent les données initiales définies pour la zone de liste. Dans ce cas, Carotte, définie comme Vrai, est l'élément présélectionné dans la zone de liste.
Délimiteur
Entrez le caractère à utiliser pour délimiter les valeurs des options du composant Web lorsque des données dynamiques sont utilisées pour constituer la zone de liste. Le caractère par défaut est le point-virgule.
Nom
Entrez un nom à associer à la valeur donnée. Il s'agit de la sélection effectuée dans la zone de liste. Lorsque l'utilisateur sélectionne ce nom, la valeur qui lui est associée est envoyée au programme.
Voir Substitution des chaînes de texte dans les libellés des composants Web IBM i pour plus d'informations sur l'externalisation de chaînes texte à des fins de remplacement de texte.
Valeur
Entrez la valeur envoyée au programme lorsque l'utilisateur sélectionne le nom associé. Notez que la longueur de la valeur ne peut pas être spécifiée. Lorsque vous définissez le paramètre dans votre procédure, vérifiez que la longueur prévue est suffisante pour contenir la valeur la plus longue. La valeur est limitée à la longueur du paramètre. Notez également que la valeur ne peut pas contenir le caractère de séparation défini dans la zone Délimiteur.
Sélectionné
La valeur par défaut est Faux, signifiant que les éléments de la zone de sélection ne sont pas présélectionnés. Pour définir cette valeur sur Vrai, signifiant ainsi qu'un élément est présélectionné, cliquez sur la zone Sélectionné de l'élément et sélectionnez Vrai dans la liste. Si vous avez indiqué Sélection multiple dans l'onglet Général, plusieurs éléments peuvent être affectés de la valeur Vrai.
Ajouter
Pour ajouter une option, cliquez sur Ajouter et entrez un nom et une valeur dans les zones respectives. Les valeurs de l'état sélectionné sont Faux et Vrai. La valeur par défaut est Faux.
Supprimer
Pour supprimer une option dans la liste, sélectionnez-la et cliquez sur Supprimer.
Haut
Pour déplacer une option vers le haut de la liste, sélectionnez-la et cliquez sur Haut.
Bas
Pour déplacer une option vers le bas de la liste, sélectionnez-la et cliquez sur Bas.

Onglet Evénements

Evénements
Dans la liste, choisissez un événement et utilisez le langage JavaScript™ pour coder l'action correspondante dans la zone Script. Par exemple, si vous sélectionnez OnBlur, vous pouvez coder le script alert ("non applicable"). Pour obtenir une brève description des événements qui s'appliquent à ce composant Web, voir Evénements du composant Web.

Onglet Styles

L'onglet Styles propose des styles internes pour le composant Web IBM i.
Style interne
Cliquez sur les boutons Polices, Styles de polices, Couleur d'arrière-plan et Présentation du texte pour ouvrir les fenêtres de définition de style respectives. Dans chaque fenêtre, sélectionnez les options que vous souhaitez appliquer au composant Web IBM i.

Commentaires en retour