CT INSERT EXPRESSION

4D - Documentation   Français   English   German   4D Chart, Befehle nach Themen   4D Chart, Befehle alphabetisch   Back   Previous   Next

Version 6.0.5


CT INSERT EXPRESSION (Bereich; Geltungsbereich; Erstes; Letztes; Ausdruck{; Format})

ParameterTypBeschreibung
BereichLange Ganzzahl4D Chart Bereich
GeltungsbereichLange Ganzzahl-1 = Erstes Objekt
0 = Erstes Objekt in Auswahl
>0 = Objekt-Kennummer
ErstesGanzzahlPosition des ersten Zeichens minus 1
LetztesGanzzahlPosition des letzten Zeichens
AusdruckStringAusdruck
FormatStringFormat des Ausdrucks

Beschreibung

Der Befehl CT INSERT EXPRESSION fügt eine Referenz von Ausdruck in das Textobjekt in Bereich ein, definiert durch Geltungsbereich.

Bei Geltungsbereich gleich -1 fügt CT INSERT EXPRESSION die Referenz in das erste Objekt des Dokuments ein.

Bei Geltungsbereich gleich 0 fügt CT INSERT EXPRESSION die Referenz in das erste Objekt ein.

Bei Geltungsbereich größer als 0 muss er der Kennummer eines bestimmten Textobjekts entsprechen, die Referenz wird dann in dieses Textobjekt eingefügt. Existiert das Objekt nicht, führt CT INSERT EXPRESSION nichts aus.

Ist das in Geltungsbereich beschriebene Objekt kein Textobjekt, führt CT INSERT EXPRESSION nichts aus.

Erstes und Letztes bestimmen, wo die Referenz eingefügt wird. Erstes ist das Zeichen vor dem ersten zu ersetzenden Zeichen, Letztes das letzte zu ersetzende Zeichen. Bei Erstes gleich Letztes werden keine Zeichen ersetzt, die Referenz wird zwischen Erstes und Erstes +1 eingefügt. Ist Letztes größer als die Anzahl Zeichen im Textobjekt, ersetzt CT INSERT EXPRESSION die Zeichen von Erstes bis zum letzten Zeichen im Textobjekt.

Ausdruck ist die Textentsprechung jedes gültigen 4th Dimension Ausdrucks, der einen Wert zurückgibt. Ausdruck kann eine Referenz auf eines der folgenden Objekte sein: Datenfeld, Variable, 4th Dimension Funktion, benutzerdefinierte Funktion (Projektmethode), Plug-In Funktion oder Statement.

Nachfolgende Tabelle zeigt Beispiele für die verschiedenen Ausdruckstypen:

BeispielTyp
[Drawings]ObjektDatenfeld
vCriteriaVariable
Current Date4th Dimension Funktion
GetNumBenutzerdefinierte Funktion (Projektmethode)
CT Count4D Chart Funktion
3 * "Hello"Statement

Der optionale Parameter Format ist das Anzeigeformat für die Referenz. Diese Option bewirkt dasselbe wie Auswählen eines Formats im Dialogfenster Format. Die Referenz auf ein Format ist entweder seine Nummer oder sein Name. Formate werden so numeriert, wie sie in der Liste des Dialogfensters Format erscheinen.

Ist Format ein ein- bzw. zweistelliger String, stammt das auf Feld angewandte Format aus der Liste. Ist Format kein ein- bzw. zweistelliger String, wird er mit den Textwerten jedes Formats in der Liste verglichen. Passt einer der Werte aus der Liste, wird dieses Format angewandt. Sie können sich also auf das erste Datumsformat entweder als "19" oder "Abgekürzt" beziehen.

Gibt es Format nicht in der Liste der Formate, wird es als eigenes numerisches Format interpretiert. Ist Format für den resultierenden Wert der Referenz ungeeignet, wird es ignoriert. Wenden Sie z.B. ein Datumsformat auf eine Zahl an, erscheint die Zahl ohne Formatierung.

Beispiel

Dieses Beispiel erstellt ein neues Textobjekt, füllt es mit einer Referenz auf die

4th Dimension Funktion Current date und verwendet das Datumsformat Ausgeschrieben.

   $ID := CT Draw text (Bereich;0.5;0.5;3.5;1;"Heute ist der: ")
   CT INSERT EXPRESSION (Bereich;$ID;32000;32000;"Current date";"Ausgeschrieben")

Referenz

CT INSERT FIELD.


4D - Documentation   Français   English   German   4D Chart, Befehle nach Themen   4D Chart, Befehle alphabetisch   Back   Previous   Next