1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkRuler
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
1999-08-20 19:52:36 +00:00
|
|
|
Base class for horizontal or vertical rulers
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
2003-04-12 23:29:46 +00:00
|
|
|
<note>
|
2001-02-03 01:09:41 +00:00
|
|
|
<para>
|
2003-04-12 23:29:46 +00:00
|
|
|
This widget is considered too specialized/little-used for
|
2001-02-03 01:09:41 +00:00
|
|
|
GTK+, and will in the future be moved to some other package. If
|
|
|
|
your application needs this widget, feel free to use it, as the
|
|
|
|
widget does work and is useful in some applications; it's just not
|
|
|
|
of general interest. However, we are not accepting new features for
|
|
|
|
the widget, and it will eventually move out of the GTK+
|
|
|
|
distribution.
|
|
|
|
</para>
|
2003-04-12 23:29:46 +00:00
|
|
|
</note>
|
1999-08-16 18:51:52 +00:00
|
|
|
<para>
|
1999-08-20 19:52:36 +00:00
|
|
|
The GTKRuler widget is a base class for horizontal and vertical rulers. Rulers
|
|
|
|
are used to show the mouse pointer's location in a window. The ruler can either
|
|
|
|
be horizontal or vertical on the window. Within the ruler a small triangle
|
2003-04-12 23:29:46 +00:00
|
|
|
indicates the location of the mouse relative to the horizontal or vertical
|
1999-08-20 19:52:36 +00:00
|
|
|
ruler. See #GtkHRuler to learn how to create a new horizontal ruler. See
|
|
|
|
#GtkVRuler to learn how to create a new vertical ruler.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
1999-08-20 19:52:36 +00:00
|
|
|
#GtkHRuler, #GtkVRuler
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkRuler ##### -->
|
|
|
|
<para>
|
1999-08-20 19:52:36 +00:00
|
|
|
All distances are in 1/72nd's of an inch. (According to Adobe thats a point, but
|
|
|
|
points are really 1/72.27 in.)
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2004-02-24 22:25:41 +00:00
|
|
|
<!-- ##### ARG GtkRuler:lower ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkRuler:max-size ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkRuler:position ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkRuler:upper ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### STRUCT GtkRulerMetric ##### -->
|
|
|
|
<para>
|
1999-08-20 19:52:36 +00:00
|
|
|
This should be points_per_unit. This is the size of the unit in 1/72nd's of an inch and has nothing to do with screen pixels.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
@metric_name:
|
|
|
|
@abbrev:
|
|
|
|
@pixels_per_unit:
|
|
|
|
@ruler_scale:
|
|
|
|
@subdivide:
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_ruler_set_metric ##### -->
|
|
|
|
<para>
|
1999-08-20 19:52:36 +00:00
|
|
|
This calls the #GTKMetricType to set the ruler to units defined. Available units
|
|
|
|
are GTK_PIXELS, GTK_INCHES, or GTK_CENTIMETERS. The default unit of measurement
|
|
|
|
is GTK_PIXELS.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-08-20 19:52:36 +00:00
|
|
|
@ruler: the gtkruler
|
|
|
|
@metric: the unit of measurement
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_ruler_set_range ##### -->
|
|
|
|
<para>
|
1999-08-20 19:52:36 +00:00
|
|
|
This sets the range of the ruler using gfloat lower, gfloat upper, gfloat position, and gfloat max_size.
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
1999-08-20 19:52:36 +00:00
|
|
|
@ruler: the gtkruler
|
1999-09-22 21:30:57 +00:00
|
|
|
@lower: the upper limit of the ruler
|
|
|
|
@upper: the lower limit of the ruler
|
|
|
|
@position: the mark on the ruler
|
|
|
|
@max_size: the maximum size of the ruler
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
2001-09-08 06:24:46 +00:00
|
|
|
<!-- ##### FUNCTION gtk_ruler_get_metric ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@ruler:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_ruler_get_range ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@ruler:
|
|
|
|
@lower:
|
|
|
|
@upper:
|
|
|
|
@position:
|
|
|
|
@max_size:
|
|
|
|
|
|
|
|
|