![]() |
![]() |
A Gtk::Scale is a slider control used to select a numeric value. To use it, you'll probably want to investigate the methods on its base class, Gtk::Range, in addition to the methods for Gtk::Scale itself. To set the value of a scale, you would normally use set_value(). To detect changes to the value, you would normally use signal_value_changed().
The Gtk::Scale widget is an abstract class, used only for deriving the subclasses Gtk::HScale and Gtk::VScale, so you should instantiate them instead.
Public Member Functions | |
int | get_digits () const |
Get the number of decimal digits. | |
bool | get_draw_value () const |
Get whether the current value is displayed as a string next to the slider. | |
Glib::RefPtr<const Pango::Layout> | get_layout () const |
Gets the Pango::Layout used to display the scale. | |
Glib::RefPtr<Pango::Layout> | get_layout () |
Gets the Pango::Layout used to display the scale. | |
void | get_layout_offsets (int& x, int& y) const |
Obtains the coordinates where the scale will draw the Pango::Layout representing the text in the scale. | |
PositionType | get_value_pos () const |
Get the position in which the value is displayed. | |
const GtkScale* | gobj () const |
Provides access to the underlying C GtkObject. | |
GtkScale* | gobj () |
Provides access to the underlying C GtkObject. | |
Glib::PropertyProxy_ReadOnly< int > | property_digits () const |
The number of decimal places that are displayed in the value. | |
Glib::PropertyProxy<int> | property_digits () |
The number of decimal places that are displayed in the value. | |
Glib::PropertyProxy_ReadOnly< bool > | property_draw_value () const |
Whether the current value is displayed as a string next to the slider. | |
Glib::PropertyProxy<bool> | property_draw_value () |
Whether the current value is displayed as a string next to the slider. | |
Glib::PropertyProxy_ReadOnly< PositionType > | property_value_pos () const |
The position in which the current value is displayed. | |
Glib::PropertyProxy<PositionType> | property_value_pos () |
The position in which the current value is displayed. | |
void | set_digits (int digits) |
Set the number of decimal digits. | |
void | set_draw_value (bool draw_value=true) |
Set whether the current value is displayed as a string next to the slider. | |
void | set_value_pos (PositionType pos) |
Set the position in which the value is displayed. | |
Glib::SignalProxy1< Glib::ustring, double > | signal_format_value () |
Determines how the value is formatted. | |
virtual | ~Scale () |
Protected Member Functions | |
virtual int | calc_digits_ (double step) const |
virtual void | draw_value_vfunc () |
virtual Glib::ustring | on_format_value (double value) |
Scale () | |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::Scale* | wrap (GtkScale* object, bool take_copy=false) |
|
|
|
|
|
|
|
|
|
Get the number of decimal digits.
|
|
Get whether the current value is displayed as a string next to the slider.
|
|
Gets the Pango::Layout used to display the scale. The returned object is owned by the scale so does not need to be freed by the caller.
|
|
Gets the Pango::Layout used to display the scale. The returned object is owned by the scale so does not need to be freed by the caller.
|
|
Obtains the coordinates where the scale will draw the Pango::Layout representing the text in the scale. Remember when using the Pango::Layout function you need to convert to and from pixels using PANGO_PIXELS() or Pango::SCALE.
If the draw_value property is
|
|
Get the position in which the value is displayed.
|
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Range. Reimplemented in Gtk::VScale, and Gtk::HScale. |
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Range. Reimplemented in Gtk::VScale, and Gtk::HScale. |
|
|
|
The number of decimal places that are displayed in the value. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The number of decimal places that are displayed in the value. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the current value is displayed as a string next to the slider. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the current value is displayed as a string next to the slider. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The position in which the current value is displayed. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The position in which the current value is displayed. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Set the number of decimal digits. This also causes the adjustment to be rounded off so the retrieved value matches the value the user sees. Setting digits to 1 gives for example 1.0, 2 gives 1.00, etc. |
|
Set whether the current value is displayed as a string next to the slider.
|
|
Set the position in which the value is displayed.
|
|
Determines how the value is formatted. This can be used to connect a custom function for determining how the value is formatted. The function (or function object) is given a the value as a double and should return the representation of it as a Glib::ustring. |
|
|