## GtkScrollbar

GtkScrollbar — A Scrollbar

## Synopsis

    #include <gtk/gtk.h>

    struct              GtkScrollbar;
    GtkWidget *         gtk_scrollbar_new                   (GtkOrientation orientation,
                                                             GtkAdjustment *adjustment);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkRange
                         +----GtkScrollbar
                               +----GtkHScrollbar
                               +----GtkVScrollbar

## Implemented Interfaces

GtkScrollbar implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Style Properties

      "fixed-slider-length"      gboolean              : Read
      "has-backward-stepper"     gboolean              : Read
      "has-forward-stepper"      gboolean              : Read
      "has-secondary-backward-stepper" gboolean              : Read
      "has-secondary-forward-stepper" gboolean              : Read
      "min-slider-length"        gint                  : Read

## Description

The GtkScrollbar widget is a horizontal or vertical scrollbar, depending on the value of the "orientation" property.

The position of the thumb in a scrollbar is controlled by the scroll adjustments. See GtkAdjustment for the fields in an adjustment - for GtkScrollbar, the GtkAdjustment.value field represents the position of the scrollbar, which must be between the GtkAdjustment.lower field and GtkAdjustment.upper - GtkAdjustment.page_size. The GtkAdjustment.page_size field represents the size of the visible scrollable area. The GtkAdjustment.step_increment and GtkAdjustment.page_increment fields are used when the user asks to step down (using the small stepper arrows) or page down (using for example the PageDown key).

## Details

### struct GtkScrollbar

    struct GtkScrollbar;

### gtk_scrollbar_new ()

    GtkWidget *         gtk_scrollbar_new                   (GtkOrientation orientation,
                                                             GtkAdjustment *adjustment);

Creates a new scrollbar with the given orientation.

`orientation` : | the scrollbar's orientation.
`adjustment` : | the GtkAdjustment to use, or `NULL` to create a new adjustment. [allow-none]
Returns : | the new GtkScrollbar.

Since 3.0

## Style Property Details

### The `"fixed-slider-length"` style property

      "fixed-slider-length"      gboolean              : Read

Don't change slider size, just lock it to the minimum length.

Default value: FALSE

### The `"has-backward-stepper"` style property

      "has-backward-stepper"     gboolean              : Read

Display the standard backward arrow button.

Default value: TRUE

### The `"has-forward-stepper"` style property

      "has-forward-stepper"      gboolean              : Read

Display the standard forward arrow button.

Default value: TRUE

### The `"has-secondary-backward-stepper"` style property

      "has-secondary-backward-stepper" gboolean              : Read

Display a second backward arrow button on the opposite end of the scrollbar.

Default value: FALSE

### The `"has-secondary-forward-stepper"` style property

      "has-secondary-forward-stepper" gboolean              : Read

Display a second forward arrow button on the opposite end of the scrollbar.

Default value: FALSE

### The `"min-slider-length"` style property

      "min-slider-length"        gint                  : Read

Minimum length of scrollbar slider.

Allowed values: >= 0

Default value: 21

## See Also

GtkAdjustment, GtkScrolledWindow