1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkScale
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-10-11 20:10:52 +00:00
|
|
|
Base class for GtkHScale and GtkVScale
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2001-06-05 20:07:02 +00:00
|
|
|
A #GtkScale is a slider control used to select a numeric value.
|
2009-05-03 01:02:12 +00:00
|
|
|
To use it, you'll probably want to investigate the methods on
|
2001-06-05 20:07:02 +00:00
|
|
|
its base class, #GtkRange, in addition to the methods for #GtkScale itself.
|
2009-05-03 01:02:12 +00:00
|
|
|
To set the value of a scale, you would normally use gtk_range_set_value().
|
|
|
|
To detect changes to the value, you would normally use the "value_changed"
|
2001-06-05 20:07:02 +00:00
|
|
|
signal.
|
|
|
|
</para>
|
|
|
|
<para>
|
1999-08-16 18:51:52 +00:00
|
|
|
The #GtkScale widget is an abstract class, used only for deriving the
|
2009-05-03 01:02:12 +00:00
|
|
|
subclasses #GtkHScale and #GtkVScale. To create a scale widget,
|
2001-06-05 20:07:02 +00:00
|
|
|
call gtk_hscale_new_with_range() or gtk_vscale_new_with_range().
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2009-05-03 01:02:12 +00:00
|
|
|
<refsect2 id="GtkScale-BUILDER-UI"><title>GtkScale as GtkBuildable</title>
|
|
|
|
<para>
|
|
|
|
GtkScale supports a custom <marks> element, which
|
|
|
|
can contain multiple <mark> elements. The "value" and "position"
|
|
|
|
attributes have the same meaning as gtk_scale_add_mark() parameters of the
|
|
|
|
same name. If the element is not empty, its content is taken as the markup
|
|
|
|
to show at the mark. It can be translated with the usual "translatable and
|
|
|
|
"context" attributes.
|
|
|
|
</para>
|
2009-05-04 05:54:06 +00:00
|
|
|
</refsect2>
|
2009-05-03 01:02:12 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2005-06-20 22:06:27 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### STRUCT GtkScale ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
The fields of the #GtkScale-struct struct should only be accessed via
|
|
|
|
the accessor functions.
|
|
|
|
</para>
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
2008-12-29 02:36:39 +00:00
|
|
|
<!-- ##### SIGNAL GtkScale::format-value ##### -->
|
|
|
|
<para>
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2009-05-04 05:54:06 +00:00
|
|
|
@scale:
|
|
|
|
@value:
|
|
|
|
@Returns:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
2004-07-20 02:26:06 +00:00
|
|
|
<!-- ##### ARG GtkScale:digits ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkScale:draw-value ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkScale:value-pos ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkScale:slider-length ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkScale:value-spacing ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
<!-- ##### FUNCTION gtk_scale_set_digits ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2008-12-29 02:36:39 +00:00
|
|
|
@scale:
|
|
|
|
@digits:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_set_draw_value ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2008-12-29 02:36:39 +00:00
|
|
|
@scale:
|
2009-01-01 22:24:56 +00:00
|
|
|
@draw_value:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_set_value_pos ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
|
1999-08-16 18:51:52 +00:00
|
|
|
</para>
|
|
|
|
|
2009-01-01 22:24:56 +00:00
|
|
|
@scale:
|
2008-12-29 02:36:39 +00:00
|
|
|
@pos:
|
1999-08-16 18:51:52 +00:00
|
|
|
|
|
|
|
|
2001-09-08 06:24:46 +00:00
|
|
|
<!-- ##### FUNCTION gtk_scale_get_digits ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
|
2001-09-08 06:24:46 +00:00
|
|
|
</para>
|
|
|
|
|
2009-01-01 22:24:56 +00:00
|
|
|
@scale:
|
|
|
|
@Returns:
|
2001-09-08 06:24:46 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_get_draw_value ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
|
2001-09-08 06:24:46 +00:00
|
|
|
</para>
|
|
|
|
|
2008-12-29 02:36:39 +00:00
|
|
|
@scale:
|
|
|
|
@Returns:
|
2001-09-08 06:24:46 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_get_value_pos ##### -->
|
|
|
|
<para>
|
2008-12-29 02:36:39 +00:00
|
|
|
|
2001-09-08 06:24:46 +00:00
|
|
|
</para>
|
|
|
|
|
2009-01-01 22:24:56 +00:00
|
|
|
@scale:
|
|
|
|
@Returns:
|
2001-09-08 06:24:46 +00:00
|
|
|
|
|
|
|
|
2004-02-21 17:05:32 +00:00
|
|
|
<!-- ##### FUNCTION gtk_scale_get_layout ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@scale:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_get_layout_offsets ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@scale:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
|
|
|
|
|
2009-01-23 23:03:59 +00:00
|
|
|
<!-- ##### FUNCTION gtk_scale_add_mark ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@scale:
|
|
|
|
@value:
|
|
|
|
@position:
|
|
|
|
@markup:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_clear_marks ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@scale:
|
|
|
|
|
|
|
|
|