Trait gtk::prelude::AdjustmentExt
source · [−]pub trait AdjustmentExt: 'static {
Show 23 methods
fn clamp_page(&self, lower: f64, upper: f64);
fn configure(
&self,
value: f64,
lower: f64,
upper: f64,
step_increment: f64,
page_increment: f64,
page_size: f64
);
fn lower(&self) -> f64;
fn minimum_increment(&self) -> f64;
fn page_increment(&self) -> f64;
fn page_size(&self) -> f64;
fn step_increment(&self) -> f64;
fn upper(&self) -> f64;
fn value(&self) -> f64;
fn set_lower(&self, lower: f64);
fn set_page_increment(&self, page_increment: f64);
fn set_page_size(&self, page_size: f64);
fn set_step_increment(&self, step_increment: f64);
fn set_upper(&self, upper: f64);
fn set_value(&self, value: f64);
fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
fn connect_value_changed<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
fn connect_lower_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
fn connect_page_increment_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
fn connect_page_size_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
fn connect_step_increment_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
fn connect_upper_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
fn connect_value_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId;
}
Expand description
Required Methods
fn clamp_page(&self, lower: f64, upper: f64)
fn clamp_page(&self, lower: f64, upper: f64)
Updates the property::Adjustment::value
property to ensure that the range
between lower
and upper
is in the current page (i.e. between
property::Adjustment::value
and property::Adjustment::value
+ property::Adjustment::page-size
).
If the range is larger than the page size, then only the start of it will
be in the current page.
A signal::Adjustment::value-changed
signal will be emitted if the value is changed.
lower
the lower value
upper
the upper value
Sets all properties of the adjustment at once.
Use this function to avoid multiple emissions of the
signal::Adjustment::changed
signal. See set_lower()
for an alternative way of compressing multiple emissions of
signal::Adjustment::changed
into one.
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
fn minimum_increment(&self) -> f64
fn minimum_increment(&self) -> f64
fn page_increment(&self) -> f64
fn page_increment(&self) -> f64
Retrieves the page increment of the adjustment.
Returns
The current page increment of the adjustment
fn step_increment(&self) -> f64
fn step_increment(&self) -> f64
Retrieves the step increment of the adjustment.
Returns
The current step increment of the adjustment.
Gets the current value of the adjustment.
See set_value()
.
Returns
The current value of the adjustment
Sets the minimum value of the adjustment.
When setting multiple adjustment properties via their individual
setters, multiple signal::Adjustment::changed
signals will be emitted.
However, since the emission of the signal::Adjustment::changed
signal
is tied to the emission of the signal::glib::Object::notify
signals of the changed
properties, it’s possible to compress the signal::Adjustment::changed
signals into one by calling [ObjectExtManual::freeze_notify()
][crate::glib::prelude::ObjectExtManual::freeze_notify()] and
[ObjectExtManual::thaw_notify()
][crate::glib::prelude::ObjectExtManual::thaw_notify()] around the calls to the individual setters.
Alternatively, using a single [ObjectExtManual::set()
][crate::glib::prelude::ObjectExtManual::set()] for all the properties
to change, or using configure()
has the same effect
of compressing signal::Adjustment::changed
emissions.
lower
the new minimum value
fn set_page_increment(&self, page_increment: f64)
fn set_page_increment(&self, page_increment: f64)
Sets the page increment of the adjustment.
See set_lower()
about how to compress multiple
emissions of the signal::Adjustment::changed
signal when setting
multiple adjustment properties.
page_increment
the new page increment
fn set_page_size(&self, page_size: f64)
fn set_page_size(&self, page_size: f64)
Sets the page size of the adjustment.
See set_lower()
about how to compress multiple
emissions of the GtkAdjustment::changed signal when setting
multiple adjustment properties.
page_size
the new page size
fn set_step_increment(&self, step_increment: f64)
fn set_step_increment(&self, step_increment: f64)
Sets the step increment of the adjustment.
See set_lower()
about how to compress multiple
emissions of the signal::Adjustment::changed
signal when setting
multiple adjustment properties.
step_increment
the new step increment
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 signal::Adjustment::changed
signal when setting
multiple adjustment properties.
upper
the new maximum value
Sets the Adjustment
value. The value is clamped to lie between
property::Adjustment::lower
and property::Adjustment::upper
.
Note that for adjustments which are used in a Scrollbar
, the
effective range of allowed values goes from property::Adjustment::lower
to
property::Adjustment::upper
- property::Adjustment::page-size
.
value
the new value
fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
Emitted when one or more of the Adjustment
properties have been
changed, other than the property::Adjustment::value
property.
fn connect_value_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
fn connect_value_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId
Emitted when the property::Adjustment::value
property has been changed.