AfAbmFldLstItemCreate

AfAbmFldLstItemCreate(int1, alpha2, alpha3, var int4) : int
Zeile einer Mappenfeldliste erzeugen
int1 Nummer der Arbeitsmappe alpha2 Name des Feldes alpha3 Wert des Feldes int4 Nummer der erzeugten Zeile Resultat int Fehlerwert Siehe Verwandte Befehle, AfAbmFldLstItemDelete(), AfAbmFldLstItemSet()

Mit dieser Anweisung wird eine neue Zeile in der Mappenfeldliste erstellt. Der Befehl setzt gleichzeitig den Wert einer Spalte (eines Feldes der Liste). In den Parametern (int1), (alpha2) und (alpha3) werden die Nummer der Arbeitsmappe, der Name des Mappenfeldes und der Wert des Mappenfeldes übergeben. Liegt der Wert nicht als Zeichenkette vor, muss er zuvor mit den Konvertierungsanweisungen (siehe (siehe CONZEPT 16 Hilfe) ) gewandelt werden. In (int4) muss eine Variable vom Typ int übergeben werden. Nach erfolgreicher Ausführung der Anweisung befindet sich die Nummer der erzeugten Zeile in der Variablen. Diese Nummer wird für die weiteren Anweisungen benötigt.

Beispiel:

tErr # AfAbmFldLstItemCreate(tAbmNr,'ContactName','Support',var tContactNo);
...

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
sAfErrNoRecAbm	-20026	Die Arbeitsmappe existiert nicht.
sAfErrNoRights	-20029	Die Berechtigung ist nicht ausreichend.
sAfErrNoRecAbmFld	-20037	Das Arbeitsmappenfeld existiert nicht.
sAfErrNoAbmFldGrpDefined	-20040	Der Arbeitsmappe ist keine Gruppe von Arbeitsmappenfeldern zugeordnet.

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.