| Operatoren |
get_region_runs — Zugriff auf die Lauflängenkodierung einer Region.
get_region_runs(Region : : : Row, ColumnBegin, ColumnEnd)
get_region_runs gibt die Regionendaten in Form von Sehnentupeln aus. Die Sehnendarstellung entsteht, indem man eine Region zeilenweise mit aufsteigender Zeilenzahl (= von „oben“ nach „unten“) untersucht. Jede Zeile wird von links nach rechts durchlaufen (aufsteigende Spaltenzahl). Dabei werden alle Anfangs- und Endpunkte von Regionenabschnitten (= Sehnen) gespeichert. Eine Region lässt sich somit durch eine Folge von Sehnen beschreiben, wobei eine Sehne durch Zeilennummer, Anfangs- und Endpunkte (Spaltennummer) definiert ist. get_region_runs liefert die drei Komponenten der Sehnen in Form von Tupeln. Bei einer leeren Region werden drei leere Tupel zurückgegeben.
Es darf nur eine Region übergeben werden.
Auszugebende Region.
Zeilennummern der Sehnen.
Spaltennummern der Anfangspunkte der Sehnen.
Parameteranzahl: ColumnBegin == Row
Spaltennummern der Endpunkte der Sehnen.
Parameteranzahl: ColumnEnd == Row
get_region_runs liefert normalerweise den Wert 2 (H_MSG_TRUE). Wird mehr als eine Region übergeben, wird eine Fehlerbehandlung ausgelöst. Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels set_system('no_object_result',<Result>) festlegen.
Foundation
| Operatoren |