4D v16.3
GET HIGHLIGHTED RECORDS
- 4D Programmiersprache
-
- Auswahl
-
- ALL RECORDS
- APPLY TO SELECTION
- Before selection
- CREATE SELECTION FROM ARRAY
- DELETE SELECTION
- DISPLAY SELECTION
- Displayed line number
- End selection
- FIRST RECORD
- GET HIGHLIGHTED RECORDS
- GOTO SELECTED RECORD
- HIGHLIGHT RECORDS
- LAST RECORD
- MOBILE Return selection
- MODIFY SELECTION
- NEXT RECORD
- ONE RECORD SELECT
- PREVIOUS RECORD
- Records in selection
- REDUCE SELECTION
- SCAN INDEX
- Selected record number
- TRUNCATE TABLE
GET HIGHLIGHTED RECORDS
| GET HIGHLIGHTED RECORDS ( {Tabellenname ;} Mengenname ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| Tabellenname | Tabelle |
|
Tabelle, in der die markierten Datensätze gelesen werden. Ohne Angabe Tabelle des aktuellen Formulars | |||||
| Mengenname | String |
|
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).
Produkt: 4D
Thema: Auswahl
Nummer:
902
Erstellt: 4D 2004
4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)
