4D Doc Center : OBJECT SET SCROLL POSITION

4D v13.4

OBJECT SET SCROLL POSITION


OBJECT SET SCROLL POSITION ( {* ;} Objekt {; vPosition {; hPosition}}{; *} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (string) Ohne *: Objekt ist Tabelle oder Variable
Objekt	Formularobjekt	Mit : Objektname, ohne : Tabelle
vPosition	Lange Ganzzahl	Anzuzeigende Zeilennummer (Listbox) oder vertikales Scrollen in Pixel (Bilder)
hPosition	Lange Ganzzahl	Anzuzeigende Spaltennummer (Listbox) oder horizontales Scrollen in Pixel (Bilder)
*	Operator	Anzeige der Zeile (und Spalte, wenn der Parameter hPosition übergeben wurde) an der ersten Position nach dem Scrollen

Beschreibung

Der Befehl OBJECT SET SCROLL POSITION scrollt den Inhalt verschiedener Objekttypen: Zeilen in einem Unterformular, einem Listenformular, das über die Befehle MODIFY SELECTION, DISPLAY SELECTION angezeigt wird, oder eine hierarchische Liste Zeilen oder Spalten einer Listbox, und sogar Pixel eines Bildes.

Hinweis: Das Scrollen per Programmierung bleibt auch bei ausgeblendeten Rollbalken im Formular möglich.

Geben Sie den ersten optionalen Parameter * an, definieren Sie, dass der Parameter Objekt der Name eines Unterformulars, einer hierarchischen Liste, Listbox oder Variablen/ Feld vom Typ Bild ist. In diesem Fall übergeben Sie einen String in Objekt. Ohne Angabe definieren Sie, dass der Parameter Objekt eine Tabelle (Listenformular oder Untertabelle) eine Variable (ListRef einer hierarchischen Liste, Listbox oder Bild) oder ein Feld ist.

Mit dem Parameter vPosition können Sie die Nummer der anzuzeigenden Zeile angeben bzw. im Falle eines Bildes vertikal anzuwendendes Scrollen.
Geben Sie den Parameter vPosition nicht an, löst der Befehl vertikales Scrollen der Zeilen in der Liste aus, so dass die erste hervorgehobene Zeile in der Liste sichtbar ist. Wurde keine Zeile ausgewählt oder ist mindestens eine ausgewählte Zeile bereits sichtbar, wird kein vertikales Scrollen ausgeführt.
Geben Sie diesen Parameter an, löst der Befehl vertikales Scrollen der Zeilen in der Liste aus, so dass die gesetzte Zeile (hervorgehoben oder nicht) in der Liste sichtbar ist. Ist die Zeile bereits sichtbar, führt der Befehl nichts aus, außer der zweite Parameter * ist übergeben.

Für Listen- und Unterformulare ist diese Nummer die Zeilennummer in der aktuellen Auswahl, d.h. ihre Position.
Bei hierarchischen Listen berücksichtigt der Befehl den Status auf-/zugeklappt der Einträge.
Für Listboxen ist es die Zeilennummer unter allen Objektzeilen, inkl. ausgeblendeter Zeilen. Gehört die in vPosition übergebene Nummer zu einer ausgeblendeten Zeile in der Listbox, zeigt der Befehl die erste sichtbare Zeile an.
Hinweis: Beachten Sie, dass dieser Befehl immer auf der Standardanzeige (nicht-hierarchisch) der Listbox basiert, selbst wenn diese im hierarchischen Modus angezeigt wird. Deshalb kann das Ergebnis unterschiedlich sein, je nachdem ob die Listbox im standardmäßigen oder hierarchischen Modus angezeigt wird (siehe Beispiel).
Für Bilder, die in einem Formular angezeigt werden, gibt vPosition das vertikale Scrollen für das Bild an. Übergeben Sie 0 in vPosition, wenn das Bild nicht vertikal gescrollt werden soll. Die Werte müssen in Pixel in Bezug zum Ursprung des Bildes im lokalen Kontext ausgedrückt werden (außer, der 2. Parameter * ist übergeben - siehe unten). Das Bild muss im Format "Abgeschnitten (nicht-zentriert)" erscheinen.

Geben Sie den zweiten optionalen Parameter * an, gilt folgendes:

wird die über den Befehl sichtbar gemachte Zeile – sofern die Liste gescrollt wurde – an die erste Position der Liste gesetzt. Liegt die Zeile am Ende der Liste, hat diese Option keine Auswirkung.
Bilder werden in Bezug auf ihre aktuelle Position und nicht in Bezug auf ihren Ursprung gescrollt.

Hinweis: Der Befehl HIGHLIGHT RECORDS enthält den optionalen Parameter *, über den Sie das Verwalten von Scrollen an den Befehl OBJECT SET SCROLL POSITION abgeben können.

Beispiel

Dieses Beispiel zeigt die unterschiedliche Funktionsweise des Befehls, je nachdem ob die Listbox im standardmäßigen oder hierarchischen Modus angezeigt wird:

 OBJECT SET SCROLL POSITION(*;"mylistbox";4;2;*) // zeigt die 4. Zeile der 2. Spalte der Listbox in der ersten Position an.

Wird diese Anweisung auf eine Listbox im Standardmodus angewandt:

... scrollen die Zeilen und Spalten der Listbox folgendermaßen:

Wird dieselbe Anweisung auf eine Listbox im hierarchischen Modus angewandt, scrollen die Zeilen, aber nicht die Spalten, da die 2. Spalte zur Hierarchie gehört: