Top | ![]() |
![]() |
![]() |
![]() |
void | gwy_ruler_set_range () |
void | gwy_ruler_get_range () |
void | gwy_ruler_set_si_unit () |
GwySIUnit * | gwy_ruler_get_si_unit () |
GwyUnitsPlacement | gwy_ruler_get_units_placement () |
void | gwy_ruler_set_units_placement () |
void | gwy_ruler_move_marker () |
gdouble | gwy_ruler_coord_real_to_widget () |
gdouble | gwy_ruler_coord_widget_to_real () |
double | lower | Read / Write |
double | max-size | Read / Write |
double | position | Read / Write |
GwyUnitsPlacement | units-placement | Read / Write |
double | upper | Read / Write |
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GwyRuler ├── GwyHRuler ╰── GwyVRuler
GwyRuler is a ruler similar to GtkRuler, but it is more suited for a scientific application. It is
scale-independent and thus has no arbitrary limits on the ranges or interpretation of displayed values. It can
display units on the ruler (this can be controlled with gwy_ruler_set_units_placement()
) and cooperates with
GwySIUnit (see gwy_ruler_set_si_unit()
). It also better follows Gtk+ theme than GtkRuler.
void gwy_ruler_set_range (GwyRuler *ruler
,gdouble lower
,gdouble upper
,gdouble position
,gdouble max_size
);
Sets range and current value of a ruler.
ruler |
A GwyRuler |
|
lower |
Lower limit of the ruler. |
|
upper |
Upper limit of the ruler. |
|
position |
Current position of the mark on the ruler. |
|
max_size |
Maximum value used for calculating size of text labels. |
void gwy_ruler_get_range (GwyRuler *ruler
,gdouble *lower
,gdouble *upper
,gdouble *position
,gdouble *max_size
);
Retrieves values indicating the range and current position of a GwyRuler. See gwy_ruler_set_range()
.
ruler |
A GwyRuler |
|
lower |
Location to store lower limit of the ruler, or |
|
upper |
Location to store upper limit of the ruler, or |
|
position |
Location to store the current position of the mark on the ruler, or |
|
max_size |
Location to store the maximum size of the ruler used when calculating the space to leave for the text,
or |
void gwy_ruler_set_si_unit (GwyRuler *ruler
,GwySIUnit *units
);
Sets the base units a ruler displays.
Setting units to NULL
effectively disables them.
GwySIUnit *
gwy_ruler_get_si_unit (GwyRuler *ruler
);
Returns the base units a ruler uses.
GwyUnitsPlacement
gwy_ruler_get_units_placement (GwyRuler *ruler
);
Gets current units placement of ruler ruler
.
void gwy_ruler_set_units_placement (GwyRuler *ruler
,GwyUnitsPlacement placement
);
Sets whether and where units should be placed on the ruler.
void gwy_ruler_move_marker (GwyRuler *ruler
,gdouble value
);
Changes the position of a ruler marker.
The position is also automatically updated when pointer is moved over the marker. This function is meant for updating the ruler when pointer moves over other widgets.
gdouble gwy_ruler_coord_real_to_widget (GwyRuler *ruler
,gdouble value
);
Transforms real coordinate to position on the ruler widget.
gdouble gwy_ruler_coord_widget_to_real (GwyRuler *ruler
,gdouble pos
);
Transforms pixel position a ruler to real coordinate value.
struct GwyRulerClass { GtkWidgetClass parent_class; GwyRulerClassPrivate *priv; /* Virtual methods */ void (*prepare_sizes)(GwyRuler *ruler); void (*draw_layout) (GwyRuler *ruler, cairo_t *cr, gint hpos, gint vpos); void (*draw_tick) (GwyRuler *ruler, cairo_t *cr, gdouble pos, gdouble length); void (*draw_pos) (GwyRuler *ruler, cairo_t *cr); void (*queue_marker_redraw) (GwyRuler *ruler, gdouble value); void (*reserved1)(void); void (*reserved2)(void); };
“lower”
property “lower” double
Lower limit (minimum value).
Owner: GwyRuler
Flags: Read / Write
Default value: 0
“max-size”
property “max-size” double
Maximum magnigude of values.
Owner: GwyRuler
Flags: Read / Write
Default value: 0
“position”
property “position” double
Value where a mark should be drawn.
Owner: GwyRuler
Flags: Read / Write
Default value: 0
“units-placement”
property“units-placement” GwyUnitsPlacement
Placement of units.
Owner: GwyRuler
Flags: Read / Write
Default value: GWY_UNITS_PLACEMENT_NONE