AfArcFileBarcodePosGet

AfArcFileBarcodePosGet(alpha1, var rect2[, int3]) : int
Position eines Barcodes auf der Seite ermitteln
alpha1 Zeichenkette mit den Positionsinformationen rect2 Position des Barcodes auf der Seite int3 DPI mit der das Dokument texterkannt wurde (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcFileBarcodeLstGet()

Mit der Funktion wird die Position des Barcodes auf der Seite in eine rect-Variable (siehe CONZEPT 16 Hilfe) überführt. Im Parameter (alpha1) wird die Position des Barcodes aus der mit der Anweisung AfArcFileBarcodeLstGet() ermittelten Liste übergeben. In (rect4) muss eine Variable vom Typ rect (siehe CONZEPT 16 Hilfe) übergeben werden.

Nach dem Aufruf befindet sich die Position des Barcodes in der übergebenen rect-Variable.

:left	Abstand vom linken Seitenrand zum linken Rand des Barcodes
:top	Abstand vom oberen Seitenrand zum oberen Rand des Barcodes
:right	Abstand vom linken Seitenrand zum rechten Rand des Barcodes
:bottom	Abstand vom oberen Seitenrand zum unteren Rand des Barcodes

Die Angaben erfolgen in Punkten. Ist die DPI, mit der die Texterkennung des Dokuments erfolgt ist, bekannt, kann diese in (int3) übergeben werden. Die Position des Barcodes wird dann im Millimeter zurückgegeben.

Bei der Verwendung des Office-Servers der vorhergehnden Generation (ArcFlow Version bis einschließlich 4.0) werden standardmäßig PDF-Dokumente mit 400 DPI texterkannt. Die Auflösung kann aber durch den Eintrag OcrMaxDpiPdf=... in der afocr.cfg geändert werden. Bei TIF-Dokumenten hängt die Erkennung von den DPI ab, mit der das Dokument gescannt wurde.

Die Barcodes werden nur dann erkannt, wenn für den entsprechenden Dateityp die Barcodeerkennung aktiviert wurde (siehe Einstellungen / Erweitert / Dateitypen).

Beispiel:

tCteList # AfCteOpen(_CteList);
tResult # AfArcFileBarcodeLstGet('2016.0000205',1,tCteList);
for tCteItem # tCteList->CteRead(_CteFirst);
loop tCteItem # tCteList->CteRead(_CteNext,tCteItem);
while (tCteItem > 0)
{
  tBarcode # tCteItem->spName;
  tPositionString # tCteItem->spCustom;
  tResult # AfArcFileBarcodePosGet(tPositionString, var tPosition, 400);
  WinDialogBox(gAfActParentDlg,'',CnvAI(tPosition:left)+'/'+CnvAI(tPosition:top)+
    '->'+CnvAI(tPosition:right)+'/'+CnvAI(tPosition:bottom),0,0,0);
  ...
}
tCteList->AfCteCloseAll();

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

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_ErrValueInvalid	-188	Die übergebene Zeichenkette konnte nicht umgewandelt werden.

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