4D Doc Center : CT Get refnum

4D Chart v13

CT Get refnum


CT Get refnum ( Bereich ; Geltungsbereich ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Bereich	Lange Ganzzahl	4D Chart Bereich
Geltungsbereich	Lange Ganzzahl	-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)