4D v14.3

GET HIGHLIGHTED RECORDS

Home

 
4D v14.3
GET HIGHLIGHTED RECORDS

GET HIGHLIGHTED RECORDS 


 

GET HIGHLIGHTED RECORDS ( {Tabellenname ;} Mengenname ) 
Parameter Typ   Beschreibung
Tabellenname  Tabelle in Tabelle, in der die markierten Datensätze gelesen werden. Ohne Angabe Tabelle des aktuellen Formulars
Mengenname  String in Menge, in der die markierten Datensätze gespeichert werden.

Der Befehl GET HIGHLIGHTED RECORDS speichert in Mengenname die markierten Datensätze (z.B. die von einem Benutzer im Listenformular markierten Datensätze) in Tabellenname. Ist der Parameter Tabellenname nicht angegeben, wird die Tabelle des aktuellen Formulars oder Unterformulars verwendet.

Im Anwendungsmodus oder beim Ausführen der Befehle DISPLAY SELECTION /MODIFY SELECTION lässt sich dieser Befehl ersetzen, und zwar durch Aufruf der Systemmenge UserSet. Diese wird von 4D automatisch verwaltet. Da GET HIGHLIGHTED RECORDS die Tabelle nimmt, welche markierte Datensätze empfängt, kann der Befehl auch Datensatzauswahlen in Unterformularen verwalten. In diesem Fall kann die Auswahl im Unterformular auch aus anderen Tabellen stammen. Weitere Informationen dazu finden Sie im Kapitel Mengen.

GET HIGHLIGHTED RECORDS lässt sich auch in einem Kontext ohne Formular aufrufen, dann ist die zurückgegebene Menge jedoch leer.
Die in Mengenname definierte Menge kann vom Typ lokal/Client, Prozess oder Interprozess sein.

Hinweis: In eingebundenen Unterformularen gibt GET HIGHLIGHTED RECORDS eine leere Menge zurück, wenn Unterformulare nicht als Eigenschaft Auswahlmodus Mehrfach haben. In diesem Fall müssen Sie die Funktion Selected record number verwenden, um die gewählte Zeile herauszufinden.

Nachfolgende Methode zeigt an, wieviel Datensätze im Unterformular ausgewählt sind, das die Datensätze der Tabelle [CDs] anzeigt:

 GET HIGHLIGHTED RECORDS([CDs];"$highlight")
 ALERT(String(Records in set("$highlight"))"+"selected records.")
 CLEAR SET("$highlight")

Wurde der Befehl korrekt ausgeführt, wird die Systemvariable auf OK gesetzt, sonst auf 0 (Null).

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Auswahl
Nummer: 902

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

Erstellt: 4D 2004

 
SIEHE AUCH 

HIGHLIGHT RECORDS

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)