VISUALISER SELECTION

version 6.0 (Modifiée)

VISUALISER SELECTION ({table}{; *{; *}})

Paramètre	Type		Description
table	Table		Table à laquelle appartient la sélection ou
			Table par défaut si ce paramètre est omis
*			Utiliser le formulaire sortie en cas de sélection
			d'un seul enregistrement et masquer les barres de
			défilement dans le formulaire entrée
*			Afficher les barres de défilement dans le formulaire
			entrée (= annuler le second effet du premier
			paramètre *)

VISUALISER SELECTION affiche, pour le process en cours, la sélection courante de table dans le formulaire sortie courant. Les enregistrements sont affichés sous la forme d'une liste que l'on peut faire défiler, semblable à celle du mode Utilisation. Lorsque l'utilisateur double-clique sur un enregistrement, celui-ci s'affiche dans le formulaire entrée. La liste est placée dans la fenêtre de premier plan.

Si vous souhaitez afficher une sélection et pouvoir également modifier un enregistrement une fois que vous avez double-cliqué dessus (comme vous le faites dans la fenêtre du mode Utilisation) utilisez MODIFIER SELECTION au lieu de VISUALISER SELECTION. Toutes les explications suivantes s'appliquent à ces deux commandes, hormis la possibilité de modifier des enregistrements.

L'écran suivant présente un formulaire sortie affiché par la commande VISUALISER SELECTION.

Après qu'un VISUALISER SELECTION ait été exécuté, il n'y a plus d'enregistrement courant. Vous devez utiliser une commande telle que DEBUT SELECTION ou ALLER A DERNIER ENREGISTREMENT pour en récupérer un.

VISUALISER SELECTION ne permet pas à l'utilisateur de modifier un enregistrement affiché dans un formulaire entrée. En revanche, MODIFIER SELECTION permet cette opération.

Lorsque la sélection ne contient qu'un enregistrement, et que le premier paramètre optionnel * n'est pas passé, l'enregistrement s'affichera directement dans le formulaire entrée. Si le premier paramètre optionnel * est spécifié, l'enregistrement unique sera affiché dans le formulaire sortie. Si le premier paramètre optionnel * est spécifié et que l'utilisateur affiche l'enregistrement dans le formulaire entrée en double-cliquant dessus, les barres de défilement du formulaire seront masquées. Pour annuler ce second effet du premier paramètre optionnel *, passez le second paramètre optionnel *.

Un bouton libellé 'Quitter la liste' est automatiquement placé en bas de la liste. Un clic sur ce bouton provoque la fin de l'exécution de la commande VISUALISER SELECTION. L'ajout de toute variable ou de tout objet actif dans le formulaire entraîne la disparition de ce bouton. Vous pouvez placer des boutons personnalisés dans la zone de Pied de page du formulaire sortie. Vous pouvez utiliser des boutons automatiques Valider ou Annuler permettant de sortir de la liste ou utiliser une méthode objet qui appelle les commandes VALIDER ou NE PAS VALIDER.

L'utilisateur peut faire défiler la sélection et cliquer sur un enregistrement pour le sélectionner. S'il clique ensuite sur un autre enregistrement, le premier se désélectionne. Il est cependant possible de sélectionner plusieurs enregistrements contigus : il suffit pour cela de cliquer sur le premier enregistrement à sélectionner puis d'appuyer sur la touche Majuscule avant de cliquer sur le dernier. Pour sélectionner des enregistrements non adjacents, il suffit de cliquer sur chaque enregistrement en maintenant enfoncée la touche Ctrl (sous Windows) ou Commande (sous MacOS).

Pendant et après l'exécution d'un VISUALISER SELECTION, les enregistrements sélectionnés par l'utilisateur sont conservés dans un ensemble système nommé UserSet. Après l'exécution de la commande, l'ensemble UserSet est accessible pendant un VISUALISER SELECTION aux méthodes objet de boutons, aux méthodes appelées par des commandes de menu, ainsi que pour la méthode projet qui avait appelé VISUALISER SELECTION.

(1) L'exemple suivant sélectionne tous les enregistrements de la table [Personnes]. La commande VISUALISER SELECTION est alors utilisée pour afficher les enregistrements et permettre à l'utilisateur de désigner ceux qu'il souhaite imprimer. Enfin, les enregistrements sélectionnés sont récupérés à l'aide de la commande UTILISER ENSEMBLE et imprimés avec IMPRIMER SELECTION :

   TOUT SELECTIONNER([Personnes]) ` Sélection de tous les enregistrements 
   VISUALISER SELECTION ([Personnes]; *)` Affichage des enregistrements 
   UTILISER ENSEMBLE ("UserSet") ` Utiliser uniquement les enregistrements sélectionnés par l'utilisateur 
   IMPRIMER SELECTION ([Personnes]) ` Imprimer les enregistrements sélectionnés

(2) Reportez-vous à l'exemple n°6 de la commande Evenement formulaire ; il indique tous les tests que vous pourrez avoir besoin d'effectuer pour surveiller la totalité des événements intervenant pendant l'exécution de la commande VISUALISER SELECTION.

(3) Pour reproduire, par exemple, les fonctionnalités apportées par le menu Sélection du mode Utilisation lorsque vous utilisez MODIFIER SELECTION ou VISUALISER SELECTION en mode Menus créés, procédez de la manière suivante :

I. Dans le mode Structure, créez une barre de menus comportant les menus qui vous intéressent (par exemple Tout montrer, Recherche et Trier).

II. Associez cette barre de menus (à l'aide du menu "Barre de menus associée" dans la boîte de dialogue des propriétés du formulaire) au formulaire sortie utilisé avec les commandes VISUALISER SELECTION ou MODIFIER SELECTION.

III. Associez les méthodes projet suivantes à vos commandes de menu :

      ` M_TOUT_MONTRER (associée à la commande de menu Tout montrer)
   $vpCourTable:=Table du formulaire courant
   TOUT SELECTIONNER($vpCourTable->)

      ` M_Recherche (associée à la commande de menu Recherche)
   $vpCourTable:=Table du formulaire courant
   CHERCHER($vpCourTable->)

      ` M_TRIER (associée à la commande de menu Trier)
   $vpCourTable:=Table du formulaire courant
   TRIER($vpCourTable->)

Vous pouvez aussi utiliser d'autres commandes telles que IMPRIMER SELECTION, QR ETAT, etc. , afin de reproduire les commandes de menu "standard" à chaque fois que vous affichez ou modifiez une sélection en mode Menus créés. Grâce à la commande Table du formulaire courant, ces méthodes sont génériques et les barres de menus auxquelles elles sont associées peuvent être rattachées à tout formulaire de sortie ou à toute table.

Evenement formulaire, MODIFIER SELECTION, Présentation des ensembles.