forked from AuroraMiddleware/gtk
42f429be76
2001-06-03 Havoc Pennington <hp@pobox.com>
* gtk/gtkstyle.c (gtk_default_draw_slider): make this special-case
hscale/vscale details, so we can use it for scrollbar as well.
* tests/testgtk.c (reformat_value): honor digits from GtkScale
* gtk/gtkenums.h (GtkTroughType): Remove this enum
(GtkScrollType): add START and END from GtkTroughType
* gtk/gtkstyle.c (gtk_default_draw_slider): was not properly using
its x/y arguments
* gtk/gtkrange.h, gtk/gtkrange.c, gtk/gtkscrollbar.h,
gtk/gtkscrollbar.c, gtk/gtkscale.h, gtk/gtkscale.c,
gtk/gtkhscrollbar.h, gtk/gtkhscrollbar.c, gtk/gtkvscrollbar.h,
gtk/gtkvscrollbar.c, gtk/gtkhscale.h, gtk/gtkhscale.c,
gtk/gtkvscale.h, gtk/gtkvscale.c: Rewrite GtkRange and subclasses.
Notable changes in the process:
- stepper_size style property is the height for vertical
ranges, width for horizontal; the other dimension matches
the trough size
- add ability to do NeXT-style steppers (and several other styles
that don't make any sense)
- added min_slider_length, fixed_slider_length properties to
GtkScrollbar
- cleaned some private (or at least useless) functions out of
gtkscale.h
- moved bindings to GtkScale from subclasses, even arrow keys,
since blind users don't know scale orientation.
- change move_slider action signal to use new GtkScrollType,
remove GtkTroughType argument
- digits rounds the values a range will input to the given
number of decimals, but will not try to force adjustment
values set by other controllers. That is, we no longer
modify adjustment->value inside a value_changed handler.
- added getters for GtkScale setters
- middle-click begins a slider drag
99 lines
2.3 KiB
Plaintext
99 lines
2.3 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkScale
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
a base class for #GtkHScale and #GtkVScale.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkScale widget is an abstract class, used only for deriving the
|
|
subclasses #GtkHScale and #GtkVScale.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkScale ##### -->
|
|
<para>
|
|
The #GtkScale-struct struct contains the following fields.
|
|
(These fields should be considered read-only. They should never be set by
|
|
an application.)
|
|
|
|
<informaltable pgwide=1 frame="none" role="struct">
|
|
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
|
|
<tbody>
|
|
|
|
<row>
|
|
<entry>#guint <structfield>draw_value</structfield>;</entry>
|
|
<entry>non-zero if the scale's current value is displayed next to the
|
|
slider.</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry>#guint <structfield>value_pos</structfield>;</entry>
|
|
<entry>the position in which the textual value is displayed, selected from
|
|
#GtkPositionType.</entry>
|
|
</row>
|
|
|
|
</tbody></tgroup></informaltable>
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_set_digits ##### -->
|
|
<para>
|
|
Sets the number of decimal places that are displayed in the value. Also causes
|
|
the value of the adjustment to be rounded off to this number of digits, so the
|
|
retrieved value matches the value the user saw.
|
|
</para>
|
|
|
|
@scale: a #GtkScale.
|
|
@digits: the number of decimal places to display, e.g. use 1 to display 1.0,
|
|
2 to display 1.00 etc.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_set_draw_value ##### -->
|
|
<para>
|
|
Specifies whether the current value is displayed as a string next to the
|
|
slider.
|
|
</para>
|
|
|
|
@scale: a #GtkScale.
|
|
@draw_value:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_scale_set_value_pos ##### -->
|
|
<para>
|
|
Sets the position in which the current value is displayed.
|
|
</para>
|
|
|
|
@scale: a #GtkScale.
|
|
@pos: the position in which the current value is displayed.
|
|
|
|
|
|
<!-- ##### SIGNAL GtkScale::format-value ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@scale: the object which received the signal.
|
|
@arg1:
|
|
@Returns:
|
|
|
|
<!-- ##### ARG GtkScale:digits ##### -->
|
|
<para>
|
|
The number of decimal places that are displayed in the value.
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkScale:draw-value ##### -->
|
|
<para>
|
|
If the current value is displayed as a string next to the slider.
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkScale:value-pos ##### -->
|
|
<para>
|
|
The position in which the current value is displayed.
|
|
</para>
|
|
|