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.