37 scrollbar

Eine scrollbar kann als analoges Anzeigeobjekt oder als analoger Einsteller verwendet werden. Sie kann horizontal oder vertikal ausgerichtet sein.

Definition

{ export | reexport } { model } scrollbar { <Bezeichner> }
{
  <Standardattribute>
  <Allgemeine Attribute>
  <Geometrieattribute>
  <Hierarchieattribute>
  <Layoutattribute>
  <Objektspezifische Attribute>
}

Ereignisse

cut

extevent

focus

help

key

paste

scroll

Kinder

document

record

transformer

Vater

groupbox

layoutbox

module

notepage

splitbox

toolbar

window

Menü

Popup-Menü

37.1 Attribute

.acc_label

.acc_text

.accelerator

.arrows

.bgc

.class

.control

.cursor

.curvalue

.cut_pending

.cut_pending_changed

.dialog

.direction

.document[integer]

.external

.external[integer]

.fgc

.firstrecord

.focus

.function

.groupbox

.height

.help

.index

.label

.lastrecord

.layoutbox

.linemotion

.mapped

.maxvalue

.member[integer]

.membercount

.menu

.minvalue

.model

.notepage

options[enum]

.pagemotion

.parent

.posraster

.real_height

.real_sensitive

.real_visible

.real_width

.real_x

.real_y

.record[integer]

.recordcount

.scope

.sensitive

.sizeraster

.statushelp

.toolbar

.toolhelp

.userdata

.visible

.width

.window

.xauto

.xleft

.xright

.yauto

.ybottom

.ytop

37.2 Spezifische Attribute

Attribut Beschreibung

.arrows

Definiert, ob zwei Pfeile existieren (true) oder nicht (false).

.curvalue

Position des Scrollbarsliders.

.direction

Bestimmt, ob das Objekt horizontal oder vertikal ausgerichtet ist.

.linemotion

Definiert um welchen Betrag sich .curvalue beim zeilenweisen Scrollen ändert.

Siehe auch „Scrollbarattribute“ in der „Attributreferenz“.

.maxvalue

Definiert den maximal möglichen Wert von .curvalue.

.minvalue

Definiert den minimal möglichen Wert von .curvalue.

options[enum]

Optionen des Objekts.

Index: opt_center_toolhelp (nur MS Windows)

.pagemotion

Definiert um welchen Betrag sich .curvalue beim seitenweisen Scrollen ändert.

Siehe auch „Scrollbarattribute“ in der „Attributreferenz“.

37.3 Berechnung des Scrollbarsliders

Abbildung 16-36: Attribute der scrollbar

Die Größe des Scrollbar-Sliders wird aus den Werten der Attribute .minvalue, .maxvalue und .pagemotion berechnet. Wenn der Gesamtbereich über den der Slider fahren kann, eine Länge von 1 Pixel hat, so gilt:

Slidergröße = 1 * .pagemotion/(.maxvalue - .minvalue),

wobei bei Bedarf gerundet wird.

Die Größe des Sliders verhält sich also zum Darstellungsbereich wie .pagemotion zur Differenz von .maxvalue und .minvalue.

Diese Berechnung gilt sowohl für die Scrollbar als Objekt als auch für Scrollbars, die an ein Objekt gefügt sind.

Sie gilt jedoch nicht für sog. "scale widgets" (.arrows = false), wo sie eine feste Größe haben, die nicht zu beeinflussen ist.

37.4 Anmerkungen zur Scrollbar unter Microsoft Windows

Wenn das Attribut ..arrows = false gesetzt wird, verwendet der Dialog Manager das Objekt "slider" anstatt des Objekts Scrollbar.

Slider werden gewöhnlich dazu verwendet, um ein allmähliches Anwachsen von Werten, wie z.B. Grade, Prozente usw., anzuzeigen (weitere Information finden Sie beim Attribut .arrows in der „Attributreferenz“).

Scrollbar-Objekte mit .arrows = false verwenden die Hintergrundfarbe ihres Vaterobjekts und nicht ihre eigene.

Zur Benutzung einer Radmaus zum Scrollen bitte Kapitel „Radmaus bzw. Radmausunterstützung unter Microsoft Windows“ beachten.

37.5 Beispiel

dialog D

color Red "RED", grey(0);

window Wn
{
  .width  355;
  .height 180;
  .title  "Beispielfenster";

  child scrollbar Sb1
  {
    .fgc Red;
    .bgc Red;
    .xleft  66;
    .ytop   89;
    .arrows false;
    .direction 2;
    .curvalue  50;
  }
}

Abbildung 16-37: scrollbar