AfAbmFldLstItemGet

AfAbmFldLstItemGet(int1, alpha2, int3, var alpha4) : int
Feld in einer Mappenfeldliste lesen
int1 Nummer der Arbeitsmappe alpha2 Name des Feldes int3 Nummer der Zeile alpha4 gelesener Wert Resultat int Fehlerwert Siehe Verwandte Befehle, AfAbmFldLstItemSet()

Mit dieser Funktion kann der Wert eines Feldes in einer Zeile ermittelt werden. In den Parametern muss die Nummer der Arbeitsmappe (int1), der Name des Mappenfeldes (alpha2) und die Nummer der Zeile (int3) angegeben werden. In (alpha4) wird eine Variable vom Typ alpha übergeben. Nach erfolgreicher Ausführung der Anweisung, steht der Inhalt des Mappenfeldes in der Variablen zur Verfügung. Möglicherweise muss der Wert zur weiteren Verarbeitung mit einer Konvertierungsanweisung (siehe (siehe CONZEPT 16 Hilfe) ) gewandelt werden.

Die Nummer der Zeile wird entweder von der Anweisung AfAbmFldLstItemCreate() zurückgegeben, oder kann über AfAbmFldLstGet() ermittelt werden.

Beispiel:

tCteList # AfCteOpen(_CteList);
tErr # AfAbmFldLstGet(gAfAbmId,'ContactName',tCteList);
for tCteItem # tCteList->CteRead(_CteFirst)
loop tCteItem # tCteList->CteRead(_CteNext,tCteItem)
while (tCteItem > 0)
{
  tContactNo # CnvIA(tCteItem->spName);
  tContactName # CteItem->spCustom;
  tErr # AfAbmFldLstItemGet(gAfAbmId,'ContactTelephone',tContactNo,var tContactTelephone);
  ...
}
tCteList->AfCteCloseAll();

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.