Package org.gnome.gtk

Class Adjustment

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gobject.InitiallyUnowned

org.gnome.gtk.Adjustment

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class Adjustment
extends InitiallyUnowned

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.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Adjustment.AdjustmentClass
static class	Adjustment.Builder<B extends Adjustment.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static interface	Adjustment.ChangedCallback	Functional interface declaration of the ChangedCallback callback.
static interface	Adjustment.ValueChangedCallback	Functional interface declaration of the ValueChangedCallback callback.

Nested classes/interfaces inherited from class org.gnome.gobject.InitiallyUnowned

InitiallyUnowned.InitiallyUnownedClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
Adjustment()	Creates a new Adjustment.
Adjustment(double value, double lower, double upper, double stepIncrement, double pageIncrement, double pageSize)	Creates a new GtkAdjustment.
Adjustment(MemorySegment address)	Create a Adjustment proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected Adjustment	asParent()	Returns this instance as if it were its parent type.
static Adjustment.Builder<? extends Adjustment.Builder>	builder()	A Adjustment.Builder object constructs a Adjustment with the specified properties.
protected void	changed()
void	clampPage(double lower, double upper)	Updates the value of the adjustment to ensure that the given range is contained in the current page.
void	configure(double value, double lower, double upper, double stepIncrement, double pageIncrement, double pageSize)	Sets all properties of the adjustment at once.
void	emitChanged()	Emits the "changed" signal.
void	emitValueChanged()	Emits the "value-changed" signal.
double	getLower()	Retrieves the minimum value of the adjustment.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
double	getMinimumIncrement()	Gets the smaller of step increment and page increment.
double	getPageIncrement()	Retrieves the page increment of the adjustment.
double	getPageSize()	Retrieves the page size of the adjustment.
double	getStepIncrement()	Retrieves the step increment of the adjustment.
static @Nullable Type	getType()	Get the GType of the Adjustment class
double	getUpper()	Retrieves the maximum value of the adjustment.
double	getValue()	Gets the current value of the adjustment.
SignalConnection<Adjustment.ChangedCallback>	onChanged(Adjustment.ChangedCallback handler)	Emitted when one or more of the GtkAdjustment properties have been changed.
SignalConnection<Adjustment.ValueChangedCallback>	onValueChanged(Adjustment.ValueChangedCallback handler)	Emitted when the value has been changed.
void	setLower(double lower)	Sets the minimum value of the adjustment.
void	setPageIncrement(double pageIncrement)	Sets the page increment of the adjustment.
void	setPageSize(double pageSize)	Sets the page size of the adjustment.
void	setStepIncrement(double stepIncrement)	Sets the step increment of the adjustment.
void	setUpper(double upper)	Sets the maximum value of the adjustment.
void	setValue(double value)	Sets the GtkAdjustment value.
protected void	valueChanged()

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Adjustment

public Adjustment(MemorySegment address)

Create a Adjustment proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Adjustment

public Adjustment(double value,
 double lower,
 double upper,
 double stepIncrement,
 double pageIncrement,
 double pageSize)

Creates a new GtkAdjustment.

Parameters:

value - the initial value

lower - the minimum value

upper - the maximum value

stepIncrement - the step increment

pageIncrement - the page increment

pageSize - the page size

Adjustment

public Adjustment()

Creates a new Adjustment.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the Adjustment class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected Adjustment asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class InitiallyUnowned

clampPage

public void clampPage(double lower,
 double upper)

Updates the value of the adjustment to ensure that the given range is contained 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 Gtk.Adjustment::value-changed signal will be emitted if the value is changed.

Parameters:

lower - the lower value

upper - the upper value

configure

public void configure(double value,
 double lower,
 double upper,
 double stepIncrement,
 double pageIncrement,
 double pageSize)

Sets all properties of the adjustment at once.

Use this function to avoid multiple emissions of the Gtk.Adjustment::changed signal. See setLower(double) for an alternative way of compressing multiple emissions of Gtk.Adjustment::changed into one.

Parameters:

value - the new value

lower - the new minimum value

upper - the new maximum value

stepIncrement - the new step increment

pageIncrement - the new page increment

pageSize - the new page size

getLower

public double getLower()

Retrieves the minimum value of the adjustment.

Returns:

the minimum value

getMinimumIncrement

public double getMinimumIncrement()

Gets the smaller of step increment and page increment.

Returns:

the minimum increment

getPageIncrement

public double getPageIncrement()

Retrieves the page increment of the adjustment.

Returns:

the page increment

getPageSize

public double getPageSize()

Retrieves the page size of the adjustment.

Returns:

the page size

getStepIncrement

public double getStepIncrement()

Retrieves the step increment of the adjustment.

Returns:

the step increment

getUpper

public double getUpper()

Retrieves the maximum value of the adjustment.

Returns:

the maximum value

getValue

public double getValue()

Gets the current value of the adjustment.

Returns:

the current value

setLower

public void setLower(double lower)

Sets the minimum value of the adjustment.

When setting multiple adjustment properties via their individual setters, multiple Gtk.Adjustment::changed signals will be emitted. However, since the emission of the Gtk.Adjustment::changed signal is tied to the emission of the ::notify signals of the changed properties, it’s possible to compress the Gtk.Adjustment::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 configure(double, double, double, double, double, double) has the same effect.

Parameters:

lower - the new minimum value

setPageIncrement

public void setPageIncrement(double pageIncrement)

Sets the page increment of the adjustment.

See setLower(double) about how to compress multiple emissions of the Gtk.Adjustment::changed signal when setting multiple adjustment properties.

Parameters:

pageIncrement - the new page increment

setPageSize

public void setPageSize(double pageSize)

Sets the page size of the adjustment.

See setLower(double) about how to compress multiple emissions of the Gtk.Adjustment::changed signal when setting multiple adjustment properties.

Parameters:

pageSize - the new page size

setStepIncrement

public void setStepIncrement(double stepIncrement)

Sets the step increment of the adjustment.

See setLower(double) about how to compress multiple emissions of the Gtk.Adjustment::changed signal when setting multiple adjustment properties.

Parameters:

stepIncrement - the new step increment

setUpper

public void setUpper(double 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 setLower(double) about how to compress multiple emissions of the Gtk.Adjustment::changed signal when setting multiple adjustment properties.

Parameters:

upper - the new maximum value

setValue

public void setValue(double value)

Sets the GtkAdjustment value.

The value is clamped to lie between Gtk.Adjustment:lower and Gtk.Adjustment:upper.

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

Parameters:

value - the new value

changed

protected void changed()

valueChanged

protected void valueChanged()

onChanged

public SignalConnection<Adjustment.ChangedCallback> onChanged(Adjustment.ChangedCallback handler)

Emitted when one or more of the GtkAdjustment properties have been changed.

Note that the Gtk.Adjustment:value property is covered by the Gtk.Adjustment::value-changed signal.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• Adjustment.ChangedCallback.run()

emitChanged

public void emitChanged()

Emits the "changed" signal. See onChanged(org.gnome.gtk.Adjustment.ChangedCallback).

onValueChanged

public SignalConnection<Adjustment.ValueChangedCallback> onValueChanged(Adjustment.ValueChangedCallback handler)

Emitted when the value has been changed.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• Adjustment.ValueChangedCallback.run()

emitValueChanged

public void emitValueChanged()

Emits the "value-changed" signal. See onValueChanged(org.gnome.gtk.Adjustment.ValueChangedCallback).

builder

public static Adjustment.Builder<? extends Adjustment.Builder> builder()

A Adjustment.Builder object constructs a Adjustment with the specified properties. Use the various set...() methods to set properties, and finish construction with Adjustment.Builder.build().

Returns:

the builder object