Function DE Version 10.02

@IncrementViewPos

View

Syntax

@IncrementViewPos(VIEWPOS);
@IncrementViewPos(VIEWPOS;FNLEVEL);

Beschreibung

Erhöht den Zeiger in VIEWPOS VIEWPOS um 1 um auf das nächste Dokument in der Ansicht zu verweisen und schreibt das Ergebnis direkt in VIEWPOS VIEWPOS zurück.
im Erfolgsfall liefert die @Function TRUE andernfalls @Error zurück.

FN FNLEVEL (Optional):
Ohne Angabe dieses Parameters, erhöhte diese @Function stehts das letzte Level.
Soll ein anderes Level (z.b. die Kategorie in der navigiert wird) hochgezählt werden, so kann es in FN FNLEVEL angegeben werden.

Beispiel: @IncrementViewPos(VIEWPOS)

VIEWPOS:=@ViewPos(1:1);
@LogReport(VIEWPOS;3);
@IncrementViewPos(VIEWPOS);
@LogReport(VIEWPOS;3);

Das Skript erzeugt folgende Log-Einträge:
I:VIEWPOS Matches:00000000 Level:01 MaxLevel:00 MinLevel:00 Tumbler[00]:1 Tumbler[01]:1
I:VIEWPOS Matches:00000000 Level:01 MaxLevel:00 MinLevel:00 Tumbler[00]:1 Tumbler[01]:2

In der zweiten Zeile ist zu sehen, dass der letzte Zähler (das letzte Level) um 1 erhöht wurde.