dataClass.newSelection()

Home

4D v19.8


dataClass.newSelection() ( {keepOrder} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
keepOrder	Lange Ganzzahl	dk keep ordered: Erstellt eine sortierte Entity-Selection dk non ordered: Erstellt eine unsortierte Entity-Selection (Standard ohne Angabe)
Funktionsergebnis	EntitySelection	Neue leere Entity Selection, verknüpft mit der DataClass

Beschreibung

Die Methode dataClass.newSelection() erstellt im Speicher eine neue leere, änderbare Entity-Selection, verknüpft mit der DataClass.

Hinweis: Weitere Informationen dazu finden Sie im Abschnitt Shareable vs alterable Entity-Selections.

Zum Erstellen einer sortierten Entity-Selection übergeben Sie im Parameter keepOrder den Selector dk keep ordered. Ohne diesen Parameter oder über den Selector dk non ordered erstellt die Methode eine unsortierte Entity-Selection. Diese sind zwar schneller, Sie können sich jedoch nicht auf die Position von Entities innerhalb der Selection verlassen. Weitere Informationen dazu finden Sie im Abschnitt Sortierte vs unsortierte Entity-Selections des Handbuchs 4D Designmodus.

Wird die Entity Selection angelegt, enthält sie keine Entities (mySelection.length gibt 0 zurück). Durch aufeinanderfolgende Aufrufe der Methode add( ) können Sie Entity-Selections schrittweise aufbauen.

Beispiel

 C_OBJECT($USelection;$OSelection)

 $USelection:=ds.Employee.newSelection() //Eine unsortierte leere Entity-Selection erstellen

 $OSelection:=ds.Employee.newSelection(dk keep ordered) //Eine sortierte leere Entity-Selection erstellen

Siehe auch

dataClass.query()