Version 6.0.5
CT Get refnum (Bereich; Geltungsbereich) Lange Ganzzahl
| Parameter | Typ | Beschreibung | |
| Bereich | Lange Ganzzahl | 4D Chart Bereich | |
| Geltungsbereich | Lange Ganzzahl | Geltungsbereich der Funktion | |
| -2 = Standard | |||
| -1 = Alle | |||
| 0 = Gewählte Objekte | |||
| >0 = Objekt-Kennummer | |||
| Funktionsergebnis | Lange Ganzzahl | Referenznummer für die Objekte in Bereich |
Beschreibung
Die Funktion CT Get refnum gibt die Referenznummer für das/die Objekt(e) in Bereich zurück, definiert durch Geltungsbereich. Eine Referenznummer ist eine Lange Ganzzahl, die einem Objekt zugeordnet ist. Sie ist nicht unbedingt einmalig. Referenznummern lassen sich nur per Programmierung bearbeiten. Sie selbst weisen einem Objekt eine Referenznummer zu. Die Objekt-Kennummer dagegen wird von 4D Chart vergeben.
Bei Geltungsbereich gleich -2 gibt CT Get refnum die standardmäßige Referenznummer zurück.
Bei Geltungsbereich gleich -1 gibt CT Get refnum die Referenznummer für alle Objekte im Dokument zurück. Sind die Referenznummern für die Objekte nicht gleich, gibt CT Get refnum -32000 zurück.
Bei Geltungsbereich gleich 0 gibt CT Get refnum die Referenznummer für die ausgewählten Objekte zurück. Sind die Referenznummern für die Objekte nicht gleich, gibt CT Get refnum -32000 zurück.
Bei Geltungsbereich größer 0 muss sie einer bestimmten Objekt-Kennummer entsprechen und gibt dann die dazugehörige Referenznummer zurück. Existiert das Objekt nicht, gibt CT Get refnum -32000 zurück.
Beispiel
Dieses Beispiel ist die Objektmethode für eine Schaltfläche in einem Formular mit Bereich. Wird die Methode ausgeführt, prüft sie, ob nur ein Objekt ausgewählt ist, sucht in der Tabelle [Teile] nach dem entsprechenden Datensatz und zeigt die Beschreibung des Teils an.
QUERY ([Teile];[Teile]Refnum = CT Get refnum (Bereich;0))
ALERT ("Dieses Objekt ist ein " + [Teile]Beschreibung)
Referenz