GtkAdjustment

GtkAdjustment

Properties

gdouble lower Read / Write
gdouble page-increment Read / Write
gdouble page-size Read / Write
gdouble step-increment Read / Write
gdouble upper Read / Write
gdouble value Read / Write

Types and Values

struct GtkAdjustment

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkAdjustment

Includes

#include <gtk/gtk.h>

Description

Functions

gtk_adjustment_new ()

GtkObject *
gtk_adjustment_new (gdouble value,
                    gdouble lower,
                    gdouble upper,
                    gdouble step_increment,
                    gdouble page_increment,
                    gdouble page_size);

gtk_adjustment_get_value ()

gdouble
gtk_adjustment_get_value (GtkAdjustment *adjustment);

Gets the current value of the adjustment. See gtk_adjustment_set_value().

Parameters

adjustment

a GtkAdjustment

 

Returns

The current value of the adjustment.


gtk_adjustment_set_value ()

void
gtk_adjustment_set_value (GtkAdjustment *adjustment,
                          gdouble value);

gtk_adjustment_clamp_page ()

void
gtk_adjustment_clamp_page (GtkAdjustment *adjustment,
                           gdouble lower,
                           gdouble upper);

gtk_adjustment_changed ()

void
gtk_adjustment_changed (GtkAdjustment *adjustment);

gtk_adjustment_value_changed ()

void
gtk_adjustment_value_changed (GtkAdjustment *adjustment);

gtk_adjustment_configure ()

void
gtk_adjustment_configure (GtkAdjustment *adjustment,
                          gdouble value,
                          gdouble lower,
                          gdouble upper,
                          gdouble step_increment,
                          gdouble page_increment,
                          gdouble page_size);

Sets all properties of the adjustment at once.

Use this function to avoid multiple emissions of the "changed" signal. See gtk_adjustment_set_lower() for an alternative way of compressing multiple emissions of "changed" into one.

Parameters

adjustment

a GtkAdjustment

 

value

the new value

 

lower

the new minimum value

 

upper

the new maximum value

 

step_increment

the new step increment

 

page_increment

the new page increment

 

page_size

the new page size

 

Since: 2.14


gtk_adjustment_get_lower ()

gdouble
gtk_adjustment_get_lower (GtkAdjustment *adjustment);

Retrieves the minimum value of the adjustment.

Parameters

adjustment

a GtkAdjustment

 

Returns

The current minimum value of the adjustment.

Since: 2.14


gtk_adjustment_get_page_increment ()

gdouble
gtk_adjustment_get_page_increment (GtkAdjustment *adjustment);

Retrieves the page increment of the adjustment.

Parameters

adjustment

a GtkAdjustment

 

Returns

The current page increment of the adjustment.

Since: 2.14


gtk_adjustment_get_page_size ()

gdouble
gtk_adjustment_get_page_size (GtkAdjustment *adjustment);

Retrieves the page size of the adjustment.

Parameters

adjustment

a GtkAdjustment

 

Returns

The current page size of the adjustment.

Since: 2.14


gtk_adjustment_get_step_increment ()

gdouble
gtk_adjustment_get_step_increment (GtkAdjustment *adjustment);

Retrieves the step increment of the adjustment.

Parameters

adjustment

a GtkAdjustment

 

Returns

The current step increment of the adjustment.

Since: 2.14


gtk_adjustment_get_upper ()

gdouble
gtk_adjustment_get_upper (GtkAdjustment *adjustment);

Retrieves the maximum value of the adjustment.

Parameters

adjustment

a GtkAdjustment

 

Returns

The current maximum value of the adjustment.

Since: 2.14


gtk_adjustment_set_lower ()

void
gtk_adjustment_set_lower (GtkAdjustment *adjustment,
                          gdouble lower);

Sets the minimum value of the adjustment.

When setting multiple adjustment properties via their individual setters, multiple "changed" signals will be emitted. However, since the emission of the "changed" signal is tied to the emission of the "GObject::notify" signals of the changed properties, it's possible to compress the "changed" signals into one by calling g_object_freeze_notify() and g_object_thaw_notify() around the calls to the individual setters.

Alternatively, using a single g_object_set() for all the properties to change, or using gtk_adjustment_configure() has the same effect of compressing "changed" emissions.

Parameters

adjustment

a GtkAdjustment

 

lower

the new minimum value

 

Since: 2.14


gtk_adjustment_set_page_increment ()

void
gtk_adjustment_set_page_increment (GtkAdjustment *adjustment,
                                   gdouble page_increment);

Sets the page increment of the adjustment.

See gtk_adjustment_set_lower() about how to compress multiple emissions of the "changed" signal when setting multiple adjustment properties.

Parameters

adjustment

a GtkAdjustment

 

page_increment

the new page increment

 

Since: 2.14


gtk_adjustment_set_page_size ()

void
gtk_adjustment_set_page_size (GtkAdjustment *adjustment,
                              gdouble page_size);

Sets the page size of the adjustment.

See gtk_adjustment_set_lower() about how to compress multiple emissions of the "changed" signal when setting multiple adjustment properties.

Parameters

adjustment

a GtkAdjustment

 

page_size

the new page size

 

Since: 2.14


gtk_adjustment_set_step_increment ()

void
gtk_adjustment_set_step_increment (GtkAdjustment *adjustment,
                                   gdouble step_increment);

Sets the step increment of the adjustment.

See gtk_adjustment_set_lower() about how to compress multiple emissions of the "changed" signal when setting multiple adjustment properties.

Parameters

adjustment

a GtkAdjustment

 

step_increment

the new step increment

 

Since: 2.14


gtk_adjustment_set_upper ()

void
gtk_adjustment_set_upper (GtkAdjustment *adjustment,
                          gdouble upper);

Sets the maximum value of the adjustment.

Note that values will be restricted by upper - page-size if the page-size property is nonzero.

See gtk_adjustment_set_lower() about how to compress multiple emissions of the "changed" signal when setting multiple adjustment properties.

Parameters

adjustment

a GtkAdjustment

 

upper

the new maximum value

 

Since: 2.14

Types and Values

struct GtkAdjustment

struct GtkAdjustment;

Property Details

The “lower” property

  “lower”                    gdouble

The minimum value of the adjustment.

Flags: Read / Write

Default value: 0

Since: 2.4


The “page-increment” property

  “page-increment”           gdouble

The page increment of the adjustment.

Flags: Read / Write

Default value: 0

Since: 2.4


The “page-size” property

  “page-size”                gdouble

The page size of the adjustment. Note that the page-size is irrelevant and should be set to zero if the adjustment is used for a simple scalar value, e.g. in a GtkSpinButton.

Flags: Read / Write

Default value: 0

Since: 2.4


The “step-increment” property

  “step-increment”           gdouble

The step increment of the adjustment.

Flags: Read / Write

Default value: 0

Since: 2.4


The “upper” property

  “upper”                    gdouble

The maximum value of the adjustment. Note that values will be restricted by upper - page-size if the page-size property is nonzero.

Flags: Read / Write

Default value: 0

Since: 2.4


The “value” property

  “value”                    gdouble

The value of the adjustment.

Flags: Read / Write

Default value: 0

Since: 2.4

Signal Details

The “changed” signal

void
user_function (GtkAdjustment *adjustment,
               gpointer       user_data)

Flags: No Recursion


The “value-changed” signal

void
user_function (GtkAdjustment *adjustment,
               gpointer       user_data)

Flags: No Recursion