![]() |
![]() |
![]() |
GIMP Widgets Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Style Properties |
GimpRuler; GtkWidget * gimp_ruler_new (GtkOrientation orientation); void gimp_ruler_set_unit (GimpRuler *ruler, GimpUnit unit); GimpUnit gimp_ruler_get_unit (GimpRuler *ruler); void gimp_ruler_set_position (GimpRuler *ruler, gdouble position); gdouble gimp_ruler_get_position (GimpRuler *ruler); void gimp_ruler_set_range (GimpRuler *ruler, gdouble lower, gdouble upper, gdouble max_size); void gimp_ruler_get_range (GimpRuler *ruler, gdouble *lower, gdouble *upper, gdouble *max_size);
"lower" gdouble : Read / Write "max-size" gdouble : Read / Write "orientation" GtkOrientation : Read / Write "position" gdouble : Read / Write "unit" GimpUnit : Read / Write "upper" gdouble : Read / Write
GtkWidget * gimp_ruler_new (GtkOrientation orientation);
Creates a new ruler.
orientation : | the ruler's orientation. |
Returns : | a new GimpRuler widget. |
Since GIMP 2.8
GimpUnit gimp_ruler_get_unit (GimpRuler *ruler);
ruler : | a GimpRuler |
Returns : | the unit currently used in the ruler widget. |
Since GIMP 2.8
void gimp_ruler_set_position (GimpRuler *ruler, gdouble position);
This sets the position of the ruler.
ruler : | a GimpRuler |
position : | the position to set the ruler to |
Since GIMP 2.8
gdouble gimp_ruler_get_position (GimpRuler *ruler);
ruler : | a GimpRuler |
Returns : | the current position of the ruler widget. |
Since GIMP 2.8
void gimp_ruler_set_range (GimpRuler *ruler, gdouble lower, gdouble upper, gdouble max_size);
This sets the range of the ruler.
ruler : | a GimpRuler |
lower : | the lower limit of the ruler |
upper : | the upper limit of the ruler |
max_size : | the maximum size of the ruler used when calculating the space to leave for the text |
Since GIMP 2.8
void gimp_ruler_get_range (GimpRuler *ruler, gdouble *lower, gdouble *upper, gdouble *max_size);
Retrieves values indicating the range and current position of a GimpRuler. See gimp_ruler_set_range().
ruler : | a GimpRuler |
lower : | location to store lower limit of the ruler, or NULL |
upper : | location to store upper limit of the ruler, or NULL |
max_size : | location to store the maximum size of the ruler used when calculating the space to leave for the text, or NULL. |
Since GIMP 2.8
"max-size" gdouble : Read / Write
Maximum size of the ruler.
Default value: 0
"orientation" GtkOrientation : Read / Write
The orientation of the ruler.
Default value: GTK_ORIENTATION_HORIZONTAL
"position" gdouble : Read / Write
Position of mark on the ruler.
Default value: 0
"unit" GimpUnit : Read / Write
Unit of ruler.
Allowed values: [0,65535]
Default value: 0
"font-scale" gdouble : Read
Allowed values: >= 0
Default value: 0.833333