SETSCROLLPOSITION

Setzt die Scroll-Position eines Tabellen-Widgets.

Syntax

SETSCROLLPOSITION(widget; position; orientation)

• widget - das Widget, für das die Scroll-Position gesetzt werden soll - Wertetyp: widget

• position - die Position (Nummer der Zeile), auf die die vertikale Scrollleiste für das Widget gesetzt werden soll - Wertetyp: number

• orientation - gibt an, ob die neue Position auf die Zeilen oder die Spalten des Tabellen-Widgets angewendet werden soll - Wertetyp: constant (optional, Standard: vertical)

  Mögliche Werte sind

  • vertical - Position wird auf die vertikale Scrollleiste angewendet

  • horizontal - Position wird auf die horizontale Scrollleiste angewendet

Anmerkungen

• Wenn die Funktion aufgerufen wird, wird die Tabelle so gescrollt, dass die durch position definierte Zeile/Spalte oben in der Tabelle steht (Position 1 - Zeile 1 ist oben, Position 2 - Zeile 2 ist oben, …). Es spielt keine Rolle, ob die Zeilen oder Spalten unterschiedliche Höhen oder Breiten haben.

• Wenn widget als "Scroll-Binding"-Widget von anderen Widgets verwendet wird, werden diese Widgets ebenfalls gescrollt (pixelbasiert, wie üblich).

• Wenn widget ein "Scroll-Binding"-Widget verwendet, tut die Funktion nichts.

• Wenn sich widget auf einer anderen Seite befindet, tut die Funktion nichts.

• Wenn widget kein Tabellen-Widget ist, tut die Funktion nichts.

• Wenn position kleiner als 1 ist, wird stattdessen Position 1 verwendet.

• Wenn position größer als die maximale Scroll-Position der Tabelle ist, wird stattdessen die maximale Scroll-Position verwendet.

• Die Scroll-Position wird angewendet, sobald das Ergebnis der aktuellen Benutzerinteraktion an das Frontend zurückgegeben wird.

• Wenn die Funktion mehrmals für ein Widget aufgerufen wird, wird nur die zuletzt definierte Position angewendet.

• Es ist möglich, die neue Scroll-Position für mehrere verschiedene Widgets zu setzen.