Adjustment#

class Adjustment(*args, **kwargs)#

Superclasses: InitiallyUnowned, Object

GtkAdjustment is a model for a numeric value.

The GtkAdjustment has an associated lower and upper bound. It also contains step and page increments, and a page size.

Adjustments are used within several GTK widgets, including SpinButton, Viewport, Scrollbar and Scale.

The GtkAdjustment object does not update the value itself. Instead it is left up to the owner of the GtkAdjustment to control the value.

Constructors#

class Adjustment
classmethod new(value: float, lower: float, upper: float, step_increment: float, page_increment: float, page_size: float) → Adjustment#

Creates a new GtkAdjustment.

Parameters:

  • value – the initial value

  • lower – the minimum value

  • upper – the maximum value

  • step_increment – the step increment

  • page_increment – the page increment

  • page_size – the page size

Methods#

class Adjustment
clamp_page(lower: float, upper: float) → None#

Updates the value property to ensure that the range between lower and upper is in the current page.

The current page goes from value to value + page-size. If the range is larger than the page size, then only the start of it will be in the current page.

A value_changed signal will be emitted if the value is changed.

Parameters:

  • lower – the lower value

  • upper – the upper value

configure(value: float, lower: float, upper: float, step_increment: float, page_increment: float, page_size: float) → None#

Sets all properties of the adjustment at once.

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

Parameters:

  • 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

do_changed(self) → None#
do_value_changed(self) → None#
get_lower() → float#

Retrieves the minimum value of the adjustment.

get_minimum_increment() → float#

Gets the smaller of step increment and page increment.

get_page_increment() → float#

Retrieves the page increment of the adjustment.

get_page_size() → float#

Retrieves the page size of the adjustment.

get_step_increment() → float#

Retrieves the step increment of the adjustment.

get_upper() → float#

Retrieves the maximum value of the adjustment.

get_value() → float#

Gets the current value of the adjustment.

set_lower(lower: float) → None#

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 ::notify signals of the changed properties, it’s possible to compress the changed signals into one by calling freeze_notify() and thaw_notify() around the calls to the individual setters.

Alternatively, using a single set() for all the properties to change, or using configure has the same effect.

Parameters:

lower – the new minimum value

set_page_increment(page_increment: float) → None#

Sets the page increment of the adjustment.

See set_lower about how to compress multiple emissions of the changed signal when setting multiple adjustment properties.

Parameters:

page_increment – the new page increment

set_page_size(page_size: float) → None#

Sets the page size of the adjustment.

See set_lower about how to compress multiple emissions of the changed signal when setting multiple adjustment properties.

Parameters:

page_size – the new page size

set_step_increment(step_increment: float) → None#

Sets the step increment of the adjustment.

See set_lower about how to compress multiple emissions of the changed signal when setting multiple adjustment properties.

Parameters:

step_increment – the new step increment

set_upper(upper: float) → None#

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 set_lower about how to compress multiple emissions of the changed signal when setting multiple adjustment properties.

Parameters:

upper – the new maximum value

set_value(value: float) → None#

Sets the GtkAdjustment value.

The value is clamped to lie between lower and upper.

Note that for adjustments which are used in a GtkScrollbar, the effective range of allowed values goes from lower to upper - page_size.

Parameters:

value – the new value

Properties#

class Adjustment
props.lower: float#

The type of the None singleton.

props.page_increment: float#

The type of the None singleton.

props.page_size: float#

The type of the None singleton.

props.step_increment: float#

The type of the None singleton.

props.upper: float#

The type of the None singleton.

props.value: float#

The type of the None singleton.

Signals#

class Adjustment.signals
changed() → None#

The type of the None singleton.

value_changed() → None#

The type of the None singleton.

Virtual Methods#

class Adjustment
do_changed() → None#

The type of the None singleton.

do_value_changed() → None#

The type of the None singleton.

Fields#

class Adjustment
parent_instance#