4D v16.3
CREATE SELECTION FROM ARRAY
- 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
CREATE SELECTION FROM ARRAY
| CREATE SELECTION FROM ARRAY ( Tabellenname ; DatensatzArray {; Auswahlname} ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| Tabellenname | Tabelle |
|
Tabelle zum Erstellen der Auswahl | |||||
| DatensatzArray | Lange Ganzzahl, Array Boolean |
|
Array der Datensatznummern oder Array der Booleans: Wahr = Datensatz in Auswahl Falsch = Datensatz nicht in Auswahl |
|||||
| Auswahlname | String |
|
Name der zu erstellenden temporären Auswahl Ohne Angabe Befehl auf die aktuelle Auswahl anwenden |
|||||
Der Befehl CREATE SELECTION FROM ARRAY erstellt die temporäre Auswahl Auswahlname:
- entweder aus einem Array der absoluten Datensatznummern DatensatzArray aus Tabellenname,
- oder aus einem Array mit Booleans. In diesem Fall geben die Werte des Array für jeden Datensatz an, ob er in Tabellenname zu Auswahlname gehört (True) oder nicht (False).
Übergeben Sie den Parameter Auswahlname nicht oder einen leeren String, arbeitet der Befehl mit der aktuellen Auswahl, die dann aktualisiert wird.
Verwenden Sie mit diesem Befehl ein Array vom Typ Lange Ganzzahl, entsprechen die Nummern des Array den Datensatznummern in Auswahlname. Ist eine Nummer nicht korrekt (nicht erstellter Datensatz), wird der Fehler -10503 erzeugt.
Hinweis: Stellen Sie sicher, dass das Array keine Zeilen enthält, die denselben Wert haben, denn dann erhalten Sie als Ergebnis eine nicht korrekte Auswahl.
Verwenden Sie mit diesem Befehl ein Array vom Typ Boolean, gibt das N-te Element des Array an, ob der Datensatz mit der Nummer N in Auswahlname (True) ist oder nicht (False) ist. Die Anzahl der Elemente in DatensatzArray muss mit der Anzahl der Datensätze in Tabellenname übereinstimmen. Ist das Array kleiner als die Anzahl der Datensätze, können nur die im Array definierten Datensätze für die Auswahl verwendet werden.
Hinweis: Bei einem Array mit Booleans verwendet der Befehl Elemente der Nummern 0 bis N-1.
Warnung: Eine temporäre Auswahl wird im Speicher erstellt und geladen. Sorgen Sie deshalb vor Ausführen dieses Befehls für ausreichend Speicherplatz.
Bei einer ungültigen Datensatznummer (Datensatz wird nicht erstellt) wird der Fehler -10503 generiert. Sie können ihn mit einer Methode abfangen, die über den Befehl ON ERR CALL aufgerufen wird.
CLEAR NAMED SELECTION
COPY NAMED SELECTION
CREATE SET FROM ARRAY
LONGINT ARRAY FROM SELECTION
Namenskonventionen
USE NAMED SELECTION
Produkt: 4D
Thema: Auswahl
Nummer:
640
Geändert: 4D v6.7
4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)
