AfArcFileStampObjValueGet

Aus ArcFlow Wiki
Zur Navigation springen Zur Suche springen
Diese Seite enthält Bearbeitungen, die nicht zum Übersetzen freigegeben sind.
 AfArcFileStampObjValueGet(alpha1, int2, alpha3, int4, var alpha5) : int

Ausführbar von der APINicht ausführbar von der Programmierschnittstelle (DLL)Nicht ausführbar mit der Application Remote ControlAusführbar von der Script-API

Wert eines Stempelfeldes ermitteln
alpha1 Nummer des Archivs
int2 Nummer der Anhangdatei
alpha3 Name des Objekts im Stempel
int4 Nummer des Stempels
alpha5 Wert des Stempelobjekts
Resultat int Fehlerwert
Siehe

Verwandte Befehle, AfArcFileStampObjValueSet(), AfStampPropGet...()

Mit dieser Funktion kann der Inhalt eines Stempelfeldes ermittelt werden. Im Parameter (alpha1) wird die Nummer des Archivs und in (int2) die Nummer der Anhangdatei angegeben. Die Id des Stempels und der Name des abzufragenden Objekts werden in (int4) und (alpha3) übergeben. In (alpha5) muss eine Variable vom Typ alpha übergeben werden. Nach erfolgreichen Aufruf, steht der Inhalt des Stempelfeldes in dieser Variablen.

Die Anweisung kann nur außerhalb der Ereignisse während der Anzeige des Stempels (Stempel - Vor Anzeige, Stempel - Nach Anzeige, Stempel - Tastendruck und Stempel - Feldkontrolle verwendet werden (siehe AfStampPropGet...()).

Wird eine Checkbox abgefragt, steht der Inhalt "2" für eine angehakte Checkbox und der Wert "3" für eine leere Checkbox. Um andere Zeichenketten in die entsprechenden Datentypn zu wandeln, müssen folgende Konvertierungen gewählt werden:

Datentyp Konvertierung
float CnvFA(...,_FmtNumPoint)
decimal CnvMA(...,_FmtNumPoint)
int CnvIA(...)
date CnvDA(...,_FmtInternal)
time CnvTA(...)

Die Id eines Stempels kann mit der Anweisung AfArcFileStampLstGet() ermittelt werden.

Beispiel:

tCteList # AfCteOpen(_CteList);
tErr # AfArcFileStampLstGet(tArcNo,tArcFileNo,tCteList);
if (tErr = _ErrOk)
{
  for tCteItem # tCteList->CteRead(_CteFirst);
  loop tCteItem # tCteList->CteRead(_CteNext,tCteItem);
  while (tCteItem > 0)
  {
    tStampName # tCteItem->spName;
    tStampId   # tCTeItem->spId;
    AfArcFileStampObjValueGet(tArcNo,tArcFileNo,'edit01',tStampId,var tValue);
    ...
  }
}
tCteList->AfCteCloseAll();

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

Konstante Wert Bedeutung
_ErrOk 0 ok - kein Fehler aufgetreten
_rNoRec 5 Das angegebene Archiv existiert nicht
sAfErrNoRights -20029 Die Berechtigungen sind nicht ausreichend.
sAfErrArcFileNotExists -20031 Die Anhangdatei zu dem Archiv existiert nicht
sAfErrLayerNotExists -20550 Der in (int4) angegebene Stempel ist nicht vorhanden.
sAfErrObjNameInvalid -20552 Das in (alpha3) angegebene Stempelobjekt ist nicht vorhanden.

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