FORM LIRE ORDRE SAISIE

4D v20 R7


FORM LIRE ORDRE SAISIE ( nomsObjets {; numPage \| *} )

Paramètre	Type	Description
nomsObjets	Tableau texte	Noms des objets triés par ordre de saisie
numPage \| *	Entier long, Opérateur	Numéro de la page dont vous voulez lire l'ordre de saisie défini (page courante si omis), ou * pour obtenir l'ordre de saisie actuel de la page courante

Description

La commande FORM LIRE ORDRE SAISIE retourne dans nomsObjets les noms des objets dans l'ordre de saisie du formulaire courant.

Si vous ne passez pas le paramètre *, FORM LIRE ORDRE SAISIE retourne l'ordre de saisie tel qu'il a été précédemment déclaré avec la commande FORM FIXER ORDRE SAISIE. Avec cette syntaxe, vous pouvez omettre ou passer le paramètre numPage :
- si vous omettez le paramètre numPage, le tableau nomsObjets retourne l'ordre de saisie des objets de la page courante.
- si vous passez le paramètre numPage, le tableau nomsObjets retourne l'ordre de saisie des objets de la page dont le numéro est numPage.
Dans les deux cas, si la commande FORM FIXER ORDRE SAISIE n'a pas été précédemment appelée pour le formulaire courant, le tableau nomsObjets est retourné vide.

Si vous passez le paramètre *, FORM LIRE ORDRE SAISIE retourne l'ordre de saisie actuel de la page courante, c'est-à-dire que le tableau nomsObjets contient seulement les noms d'objets valides (pour plus d'informations sur les objets valides, veuillez vous référer à la description de la commande FORM FIXER ORDRE SAISIE). L'ordre de saisie actuel du formulaire peut être :
- l'ordre de saisie par défaut du formulaire, basé sur le plan des objets,
- ou l'ordre de saisie de l'éditeur de formulaire (voir Modifier l'ordre de saisie), s'il a été défini,
- ou l'ordre de saisie fixé par un appel à la commande FORM FIXER ORDRE SAISIE dans le process courant, si elle a été appelée.
L'ordre de saisie actuel inclut toujours les objets de la page 0 et des formulaires hérités.

Note : L'ordre de saisie dans un sous-formulaire n'est pas retourné lorsque la commande s'applique au formulaire parent.

Exemple

Vous voulez exclure certains objets de l'ordre de saisie :

 TABLEAU TEXTE($arrTabOrderObject;0)

 C_ENTIER LONG($vElem)

 FORM LIRE ORDRE SAISIE($arrTabOrderObject;*)  //on lit l'ordre de saisie actuel

 Repeter

    $vElem:=Chercher dans tableau($arrTabOrderObject;"Tot@")

    Si($vElem>0)  // On exclut de l'ordre de saisie les objets dont le nom commence par "Tot"

       SUPPRIMER DANS TABLEAU($arrTabOrderObject;$vElem)

    Fin de si

 Jusque($vElem<0)

 FORM FIXER ORDRE SAISIE($arrTabOrderObject)  // On applique le nouvel ordre de saisie

Voir aussi

FORM FIXER ORDRE SAISIE