Top | ![]() |
![]() |
![]() |
![]() |
GtkWidget * | gtk_databox_ruler_new () |
void | gtk_databox_ruler_set_range () |
void | gtk_databox_ruler_set_max_length () |
void | gtk_databox_ruler_set_scale_type () |
void | gtk_databox_ruler_get_range () |
guint | gtk_databox_ruler_get_max_length () |
GtkDataboxScaleType | gtk_databox_ruler_get_scale_type () |
void | gtk_databox_ruler_set_orientation () |
GtkOrientation | gtk_databox_ruler_get_orientation () |
gdouble | lower | Read / Write |
guint | max-length | Read / Write |
guint | orientation | Read / Write / Construct Only |
gdouble | position | Read / Write |
gdouble | upper | Read / Write |
GtkDataboxRuler is a widget for the GTK+ library similar to GtkRuler.
It is improved in several ways:
It supports linear and logarithmic scales.
In the vertical orientation, the labels are rotated 90° (instead of being written as a vertical column of horizontal characters). This increases readability.
It works for very small and very large value ranges.
GtkWidget *
gtk_databox_ruler_new (GtkOrientation orientation
);
Creates a new GtkDataboxRuler widget with the given orientation
(horizontal or vertical).
void gtk_databox_ruler_set_range (GtkDataboxRuler *ruler
,gdouble lower
,gdouble upper
,gdouble position
);
Sets values indicating the range and current position of a GtkDataboxRuler.
void gtk_databox_ruler_set_max_length (GtkDataboxRuler *ruler
,guint max_length
);
This function sets the maximum number of digits to be used for each tick
label of the ruler
.
The max_length
cannot be smaller than 2 and not bigger than
GTK_DATABOX_RULER_MAX_MAX_LENGTH.
void gtk_databox_ruler_set_scale_type (GtkDataboxRuler *ruler
,guint scale_type
);
This function sets the scale type of the ruler
.
ruler |
A GtkDataboxRuler widget |
|
scale_type |
The new scale type for |
void gtk_databox_ruler_get_range (GtkDataboxRuler *ruler
,gdouble *lower
,gdouble *upper
,gdouble *position
);
Retrieves values indicating the range and current position of a GtkDataboxRuler.
See gtk_databox_ruler_set_range()
.
guint
gtk_databox_ruler_get_max_length (GtkDataboxRuler *ruler
);
This function returns the maximum number of digits to be used for each tick
label of the ruler
.
GtkDataboxScaleType
gtk_databox_ruler_get_scale_type (GtkDataboxRuler *ruler
);
This function returns the scale type of the ruler
(linear or logarithmic).
void gtk_databox_ruler_set_orientation (GtkDataboxRuler *ruler
,GtkOrientation orientation
);
Sets the orientation of the ruler
(horizontal or vertical).
GtkOrientation
gtk_databox_ruler_get_orientation (GtkDataboxRuler *ruler
);
Gets the orientation of the ruler
(horizontal or vertical).
#define GTK_DATABOX_RULER_MAX_MAX_LENGTH 63
The maximum upper limit of label length in characters
typedef struct _GtkDataboxRulerPrivate GtkDataboxRulerPrivate;
A private data structure used by the GtkDataboxRuler. It shields all internal things from developers who are just using the object.
“max-length”
property “max-length” guint
Maximum length of the labels (in digits).
Flags: Read / Write
Allowed values: [2,63]
Default value: 6
“orientation”
property “orientation” guint
Orientation of the ruler: horizontal or vertical.
Flags: Read / Write / Construct Only
Allowed values: <= 1
Default value: 0
“position”
property “position” gdouble
Position of mark on the ruler.
Flags: Read / Write
Default value: 0