2.125 .firstchar

The .firstchar attribute determines the first displayed character and thus the horizontal scroll position.

Definition

  • Data type

    integer

  • Access

    get, set

  • changed event

    yes

  • C

    Identifier: AT_firstchar

    Data type: DT_integer

  • COBOL

    Identifier: AT-firstchar

    Data type: DT-integer

  • Default value

    1

  • Inheritance

    yes

  • Classification

    object-specific attribute

  • Objects

    listbox, treeview

The .firstchar attribute returns or sets the number of the first displayed character. This means that the attribute can be used to query and define the horizontal scroll position of the listbox or treeview.

The value range includes integer values > 0.

With the treeview, .firstchar refers to entries of the first hierarchy level.

Note

The character actually displayed first depends on several factors, among others whether a proportional or mono-spaced font is used, whether and in what size images are displayed at the entries (.picture[integer] attribute) and at the treeview additionally on the .style[enum] attribute.