dataClass.newSelection( )

4D v19.8


dataClass.newSelection ( {garderOrdre} ) -> Résultat

Paramètre	Type	Description
garderOrdre	Entier long	dk keep ordered : crée une sélection d'entités ordonnée, dk non ordered : crée une sélection d'entités non ordonnée (par défaut si omis)
Résultat	EntitySelection	Nouvelle sélection d'entités reliée à la dataclass

Description

La méthode dataClass.newSelection( ) crée, en mémoire, une nouvelle sélection d'entités vide altérable liée à la dataclass.

Note : Pour plus d'informations, reportez-vous à Sélections d'entité partageables et non partageables.

Si vous voulez créer une sélection d'entités ordonnée, passez le sélecteur dk keep ordered dans le paramètre garderOrdre. Par défaut, si vous omettez ce paramètre ou si vous passez le sélecteur dk non ordered, la méthode crée une sélection d'entités non ordonnée. Les sélections d'entités non ordonnées sont plus rapides, mais vous ne pouvez pas vous fier aux positions des entités. Pour plus d'informations, reportez-vous au paragraphe Sélections d'entités triées vs Sélections d'entités non-triées dans le Manuel de développement 4D.

Une fois créée, la sélection d'entités ne contient aucune entité (mySelection.length retourne 0). Cette méthode vous permet de générer des sélections d'entités progressivement en effectuant des appels ultérieurs à la méthode add( ).

Exemple

 C_OBJECT($USelection;$OSelection)

 $USelection:=ds.Employee.newSelection() //crée une sélection d'entités non ordonnée vide

 $OSelection:=ds.Employee.newSelection(dk keep ordered) //crée une sélection d'entités ordonnée vide

Voir aussi

dataClass.query( )