|
|
|
|
|
|
|
|
|
|
version 2004 (Modifiée)
MARQUER ENREGISTREMENTS ({table}{; nomEnsemble{; *}})
| Paramètre | Type | Description | |
| table | Table |  | Table de laquelle marquer les enregistrements |
| Si omis, table du formulaire courant | |||
| nomEnsemble | Alpha | | Ensemble d'enregistrements à marquer ou |
| Ensemble Userset si ce paramètre est omis | |||
| * | * | | Inactiver le défilement automatique de la liste |
Description
La commande MARQUER ENREGISTREMENTS permet de "surligner" des enregistrements dans un formulaire en liste. Cette opération est identique à la sélection en mode liste, par l'utilisateur, d'enregistrement(s) à l'aide des combinaisons Maj+clic ou Ctrl+clic (Windows) ou Commande+clic (Mac OS). La sélection courante n'est pas modifiée.
Note : L'ensemble des enregistrements marqués est mis à jour après le redessinement des enregistrements, c'est-à-dire après la fin de l'exécution de toute la méthode d'appel — et non immédiatement après l'exécution de la commande MARQUER ENREGISTREMENTS.
Le paramètre table permet de désigner la table de laquelle les enregistrements doivent être "marqués". Ce paramètre permet en particulier de marquer les enregistrements des sous-formulaires inclus — n'appartenant donc pas à la table courante (cf. ci-dessous).
• Si vous passez un nom d'ensemble valide dans le paramètre nomEnsemble, la commande s'appliquera aux enregistrements de cet ensemble pour la table définie.
• Si vous omettez le paramètre nomEnsemble, la commande marquera les enregistrements de l'ensemble système UserSet courant. Cet ensemble est géré uniquement en mode Utilisation ou dans le cadre de l'appel des commandes MODIFIER SELECTION / VISUALISER SELECTION). Si vous souhaitez marquer les enregistrements d'un sous-formulaire, vous devez passer un nom de table et d'ensemble. Pour plus d'informations sur l'ensemble UserSet, reportez-vous à la section Présentation des ensembles.
Le paramètre *, s'il est passé, provoque l'inactivation de la fonction de défilement automatique de la liste si les enregistrements marqués ne sont pas visibles. Ce mécanisme autorise la gestion personnalisée du défilement via la commande DEFILER LIGNES.
Note : Dans le cadre des sous-formulaires inclus, la commande MARQUER ENREGISTREMENTS ne fait rien si le sous-formulaire ne dispose pas de la propriété de sélection Multilignes. Dans ce contexte, pour marquer une ligne, vous devez utiliser la commande ALLER DANS SELECTION.
Exemple
Dans un formulaire en liste affiché par la commande MODIFIER SELECTION, vous souhaitez que l'utilisateur puisse effectuer des recherches, sans que la sélection courante soit modifiée. Pour cela, placez un bouton Chercher dans le formulaire et associez-lui la méthode suivante :
FIXER DESTINATION RECHERCHE(Vers ensemble;"UserSet") CHERCHER FIXER DESTINATION RECHERCHE(Vers sélection courante) MARQUER ENREGISTREMENTS
Lorsque l'utilisateur clique sur le bouton, la boîte de dialogue standard de recherche apparaît. Une fois la recherche validée, les enregistrements trouvés sont surlignés, sans que la sélection courante ne soit modifiée.
Référence
DEFILER LIGNES, LIRE ENREGISTREMENTS MARQUES.
|
|
|
|
|
|
|
|
|
|