Function
GimpUiprop_scale_entry_new
Declaration [src]
GtkWidget*
gimp_prop_scale_entry_new (
GObject* config,
const gchar* property_name,
const gchar* label,
gdouble factor,
gboolean limit_scale,
gdouble lower_limit,
gdouble upper_limit
)
Description [src]
Creates a GimpScaleEntry
(slider and spin button) to set and display
the value of a specified int or double property with sensible default
settings depending on the range (decimal places, increments, etc.).
These settings can be overridden by the relevant widget methods.
If label
is NULL
, the property_name
‘s nick will be used as label
of the returned object.
If factor
is not 1.0, the widget’s range will be computed based of
property_name
‘s range multiplied by factor
. A typical usage would
be to display a [0.0, 1.0] range as [0.0, 100.0] by setting 100.0 as
factor
.
See gimp_scale_entry_set_bounds()
for more information on
limit_scale
, lower_limit
and upper_limit
.
Available since: | 2.4 |
Parameters
config |
GObject |
Object to which property is attached. |
|
The data is owned by the caller of the function. | |
property_name |
const gchar* |
Name of integer or double property controlled by the scale. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
label |
const gchar* |
The text for the |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
factor |
gdouble |
Optional multiplier to convert |
|
limit_scale |
gboolean |
|
|
lower_limit |
gdouble |
The scale’s lower boundary if |
|
upper_limit |
gdouble |
The scale’s upper boundary if |
Return value
Returns: | GtkWidget |
The newly allocated |
|
The caller of the function takes ownership of the data, and is responsible for freeing it. |