|
|
|
|
|
|
|
|
|
|
version 2003 (Modifiée)
INSERER ELEMENT (liste; avantElément | *; texteElément; réfElément{; sous_Liste; déployé})
| Paramètre | Type | Description | |
| liste | RéfListe |  | Numéro de référence de liste |
| avantElément | * | Entier long | * | | Numéro de référence d'élément ou |
| 0 pour le dernier élément ajouté à la liste ou | |||
| * pour l'élément de la liste actuellement | |||
| sélectionné | |||
| texteElément | Alpha | | Libellé du nouvel élément (255 caractères maxi) |
| réfElément | Entier long | | Numéro de référence unique du nouvel élément |
| sous_Liste | RefList | | Sous-liste optionnelle rattachée au nouvel élément |
| déployé | Booléen | | Indique si la sous-liste doit être déployée ou non |
Description
La commande INSERER ELEMENT insère l'élément désigné par le paramètre réfElément dans la liste dont le numéro de référence est passé dans liste.
Le paramètre avantElément permet de désigner l'élément avant lequel vous souhaitez insérer le nouvel élément :
• Vous pouvez passer la valeur 0 afin de désigner le dernier élément ajouté à la liste. Le nouvel élément devient l'élément sélectionné.
• Vous pouvez passer * afin que le nouvel élément soit inséré avant l'élément actuellement sélectionné dans la liste. Le nouvel élément devient l'élément sélectionné.
• Si vous souhaitez insérer le nouvel élément avant un élément spécifique, passez le numéro de référence de cet élément comme deuxième paramètre. Dans ce cas, le nouvel élément inséré n'est pas automatiquement sélectionné. Si le numéro que vous passez ne correspond à aucun élément de la liste, la commande ne fait rien.
Vous passez le texte et le numéro de référence du nouvel élément dans les paramètres texteElément et réfElément.
Si vous souhaitez que l'élément comporte des sous-éléments, passez un numéro de référence de liste valide dans le paramètre sous_Liste. Dans ce cas, vous devez également passer le paramètre déployé. Passez Vrai ou Faux dans ce paramètre pour que cette sous-liste s'affiche respectivement déployée ou contractée.
Exemple
L'exemple suivant insère un élément (associé à aucune sous-liste) juste devant l'élément actuellement sélectionné dans la liste hList:
vlUniqueRef:=vlUniqueRef+1 INSERER ELEMENT(hList;*;"Nouvel élément";vlUniqueRef) REDESSINER LISTE(hList)
Référence
|
|
|
|
|
|
|
|
|
|