version 5
AJOUTER SOUS ENREGISTREMENT (sousTable; formulaire{; *})
Paramètre | Type | Description | |
sousTable | Sous-table | Sous-table à utiliser pour la saisie des données | |
formulaire | Alpha | Formulaire à utiliser | |
* | * | Masquer les barres de défilement |
Description
AJOUTER SOUS ENREGISTREMENT permet d'ajouter un nouveau sous-enregistrement à sousTable, en utilisant formulaire. AJOUTER SOUS ENREGISTREMENT crée un nouveau sous-enregistrement en mémoire, en fait le sous-enregistrement courant et affiche formulaire. Il doit exister un enregistrement courant pour la table parente. S'il n'existe pas d'enregistrement de la table parente dans le process, AJOUTER SOUS ENREGISTREMENT ne fait rien. Le formulaire doit appartenir à sousTable.
Le sous-enregistrement reste en mémoire et sera sauvegardé si l'utilisateur clique sur un bouton de validation, appuie sur la touche Entrée ou si la commande VALIDER est exécutée. Dès que le sous-enregistrement a été ajouté ou modifié, l'enregistrement parent doit être sauvegardé pour que le sous-enregistrement soit sauvegardé.
Le sous-enregistrement n'est pas sauvegardé si l'utilisateur clique sur un bouton d'annulation, appuie sur les touches d'annulation (Echap sous Windows, Esc sous Mac OS), ou si la commande NE PAS VALIDER est exécutée.
Après un appel à AJOUTER SOUS ENREGISTREMENT, la variable système OK prend la valeur 1 si le sous-enregistrement a été validé, sinon elle prend la valeur 0.
Le formulaire est affiché dans la fenêtre de premier plan du process, avec des barres de défilement et une case de redimensionnement. Si vous spécifiez le paramètre optionnel astérisque (*), la fenêtre sera dessinée sans les barres de défilement ni la case de redimensionnement.
Exemple
L'exemple suivant fait partie d'une méthode. Ces lignes de code ajoutent un sous-enregistrement pour un nouvel enfant dans l'enregistrement d'un employé. Les données pour l'enfant sont stockées dans la sous-table [Employés]Enfants. Notez que l'enregistrement de la table [Employés] doit être sauvegardé pour que le sous-enregistrement le soit également :
AJOUTER SOUS ENREGISTREMENT ([Employés]Enfants; "AjouterEnfant") Si (OK = 1) ` Si l'utilisateur a validé le sous-enregistrement STOCKER ENREGISTREMENT ([Employés]) ` Stocker l'enregistrement parent Fin de si
Variables et ensembles système
Si le sous-enregistrement est validé, la variable système OK prend la valeur 1, sinon elle prend la valeur 0.
Référence
CREER SOUS ENREGISTREMENT, MODIFIER SOUS ENREGISTREMENT, NE PAS VALIDER, STOCKER ENREGISTREMENT, SUPPRIMER SOUS ENREGISTREMENT, VALIDER.