# SETSCROLLPOSITION

#### Syntax <a href="#syntax" id="syntax"></a>

**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 <a href="#remarks" id="remarks"></a>

* 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.