4D v16.3

GET HIGHLIGHTED RECORDS

Accueil

 
4D v16.3
GET HIGHLIGHTED RECORDS

GET HIGHLIGHTED RECORDS 


 

GET HIGHLIGHTED RECORDS ( {laTable ;} nomEnsemble ) 
Paramètre Type   Description
laTable  Table in Table de laquelle lire les enregistrements marqués Si omis, table du formulaire courant
nomEnsemble  Chaîne in Ensemble dans lequel stocker les enregistrements marqués

La commande GET HIGHLIGHTED RECORDS stocke dans l’ensemble désigné par le paramètre nomEnsemble les enregistrements marqués (c'est-à-dire, les enregistrements “surlignés” par l'utilisateur dans le formulaire liste) de laTable passée en paramètre. Si le paramètre laTable est omis, la table du formulaire ou du sous-formulaire courant est utilisée.

En mode Développement ou dans le cadre de l'exécution des commandes DISPLAY SELECTION /MODIFY SELECTION, cette commande peut être remplacée par l'appel de l'ensemble système UserSet, automatiquement maintenu par 4D. Toutefois, comme elle permet de désigner la table de laquelle récupérer les enregistrements marqués, la commande GET HIGHLIGHTED RECORDS peut en outre gérer les sélections d’enregistrements dans les sous-formulaires inclus. En effet dans ce cas, les sélections des sous-formulaires pouvant provenir de tables différentes, l'ensemble système UserSet n'est pas géré par 4D. Pour plus d'informations sur l'ensemble UserSet, reportez-vous à la section Ensembles.

La commande GET HIGHLIGHTED RECORDS peut être appelée hors du contexte d’un formulaire, cependant dans ce cas l’ensemble retourné est vide.
L’ensemble désigné par le paramètre nomEnsemble peut être local/client, process ou interprocess.

Note : Dans le cadre des sous-formulaires inclus, la commande GET HIGHLIGHTED RECORDS retourne un ensemble vide si le sous-formulaire ne dispose pas de la propriété de sélection Multilignes. Dans ce contexte, pour connaître la ligne sélectionnée, vous devez utiliser la commande Selected record number.

Exemple  

Cette méthode indique combien d’enregistrements sont sélectionnés dans le sous-formulaire affichant les enregistrements de la table [CDs] :

 GET HIGHLIGHTED RECORDS([CDs];"$highlight")
 ALERT(String(Enregistrements dans ensemble("$highlight"))"+"enregistrements sélectionnés.")
 CLEAR SET("$highlight")

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0.



Voir aussi  

HIGHLIGHT RECORDS

 
PROPRIÉTÉS 

Produit : 4D
Thème : Sélections
Numéro : 902

Cette commande modifie la variable système OK

 
HISTORIQUE 

Créé : 4D 2004

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)