1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>PhatSliderButton</TITLE><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHAT Reference Manual" HREF="index.html"><LINK REL="UP" TITLE="PHAT Widgets" HREF="phatwidgets.html"><LINK REL="PREVIOUS" TITLE="PhatVFanSlider" HREF="phatvfanslider.html"><META NAME="GENERATOR" CONTENT="GTK-Doc V1.2 (SGML mode)"><STYLE TYPE="text/css">.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
padding: 0.5em;
}
.programlisting {
background: #eeeeff;
border: solid 1px #aaaaff;
padding: 0.5em;
}
.variablelist {
padding: 4px;
margin-left: 3em;
}
.navigation {
background: #ffeeee;
border: solid 1px #ffaaaa;
margin-top: 0.5em;
margin-bottom: 0.5em;
}
.navigation a {
color: #770000;
}
.navigation a:visited {
color: #550000;
}
.navigation .title {
font-size: 200%;
}</STYLE></HEAD><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF"><TABLE WIDTH="100%" CLASS="navigation" SUMMARY="Navigation header" CELLPADDING="2" CELLSPACING="2"><TR VALIGN="middle"><TD><A ACCESSKEY="p" HREF="phatvfanslider.html"><IMG SRC="left.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Prev"></A></TD><TD><A ACCESSKEY="u" HREF="phatwidgets.html"><IMG SRC="up.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Up"></A></TD><TD><A ACCESSKEY="h" HREF="index.html"><IMG SRC="home.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Home"></A></TD><TH WIDTH="100%" align="center">PHAT Reference Manual</TH></TR></TABLE><H1><A NAME="PHATSLIDERBUTTON"></A>PhatSliderButton</H1><DIV CLASS="REFNAMEDIV"><A NAME="AEN692"></A><H2>Name</H2>PhatSliderButton -- retrieve an integer or floating-point number from the user</DIV><DIV CLASS="REFSYNOPSISDIV"><A NAME="AEN695"></A><H2>Synopsis</H2><PRE CLASS="SYNOPSIS">
struct <A HREF="phatsliderbutton.html#PHATSLIDERBUTTON-STRUCT">PhatSliderButton</A>;
GtkWidget* <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-NEW">phat_slider_button_new</A> (GtkAdjustment *adjustment,
const char *format);
GtkWidget* <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-NEW-WITH-RANGE">phat_slider_button_new_with_range</A>
(double value,
double lower,
double upper,
double step,
const char *format);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-VALUE">phat_slider_button_set_value</A> (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double value);
double <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-GET-VALUE">phat_slider_button_get_value</A> (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-RANGE">phat_slider_button_set_range</A> (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double lower,
double upper);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-GET-RANGE">phat_slider_button_get_range</A> (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double *lower,
double *upper);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-ADJUSTMENT">phat_slider_button_set_adjustment</A>
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
GtkAdjustment *adjustment);
GtkAdjustment* <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-GET-ADJUSTMENT">phat_slider_button_get_adjustment</A>
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-INCREMENT">phat_slider_button_set_increment</A>
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double step,
double page);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-GET-INCREMENT">phat_slider_button_get_increment</A>
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double *step,
double *page);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-FORMAT">phat_slider_button_set_format</A> (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
const char *format,
const char *prefix,
const char *postfix);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-GET-FORMAT">phat_slider_button_get_format</A> (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
char **format,
char **prefix,
char **postfix);
void <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-THRESHOLD">phat_slider_button_set_threshold</A>
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
guint threshold);
int <A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-GET-THRESHOLD">phat_slider_button_get_threshold</A>
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button);
</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN763"></A><H2>Object Hierarchy</H2><PRE CLASS="SYNOPSIS"> GObject
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBox
+----GtkHBox
+----PhatSliderButton</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN772"></A><H2>Implemented Interfaces</H2><P>PhatSliderButton implements
AtkImplementorIface.</P></DIV><DIV CLASS="REFSECT1"><A NAME="AEN776"></A><H2>Signal Prototypes</H2><PRE CLASS="SYNOPSIS"> "<A HREF="phatsliderbutton.html#PHATSLIDERBUTTON-CHANGED">changed</A>" void user_function (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
gpointer user_data);
"<A HREF="phatsliderbutton.html#PHATSLIDERBUTTON-VALUE-CHANGED">value-changed</A>"
void user_function (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
gpointer user_data);</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN787"></A><H2>Description</H2><P>A <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A> can be used in place of a <SPAN CLASS="TYPE">GtkSpinButton</SPAN>. It's a
better choice than a <A HREF="phatfanslider.html"><SPAN CLASS="TYPE">PhatFanSlider</SPAN></A> when you want the user to clearly
see the value they are setting, or want to constrain their selection
to a set of discrete values (fansliders are "continuous").</P><P>Sliderbuttons allow the user to change the value by grabbing the
widget and dragging. They can also make small "one off" adjustments
via the arrow buttons, or click the button to enter the value
directly. They have a slightly higher learning curve than standard
spinbuttons, but they offer much more efficiency to the user.</P><P>The way the current value of a sliderbutton is displayed is controlled
with a printf style format specifier supplied at widget creation.
Since sliderbuttons operate with doubles, the specifier should be in
the form of "%<VAR CLASS="LITERAL">f</VAR>" or any of the other double compatible printf escapes.
You should resist the urge to embed other information in the format
specifier, since that extra text will also wind up in the entry when
the user clicks the button. Instead, use
<A HREF="phatsliderbutton.html#PHAT-SLIDER-BUTTON-SET-FORMAT"><CODE CLASS="FUNCTION">phat_slider_button_set_format()</CODE></A> to set prefix and/or postfix text.</P></DIV><DIV CLASS="REFSECT1"><A NAME="AEN801"></A><H2>Details</H2><DIV CLASS="REFSECT2"><A NAME="AEN803"></A><H3><A NAME="PHATSLIDERBUTTON-STRUCT"></A>struct PhatSliderButton</H3><PRE CLASS="PROGRAMLISTING">struct PhatSliderButton;</PRE><P>The <A HREF="phatsliderbutton.html#PHATSLIDERBUTTON-STRUCT"><SPAN CLASS="TYPE">PhatSliderButton-struct</SPAN></A> struct contains private data only, and
should be accessed using the functions below.</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN812"></A><H3><A NAME="PHAT-SLIDER-BUTTON-NEW"></A>phat_slider_button_new ()</H3><PRE CLASS="PROGRAMLISTING">GtkWidget* phat_slider_button_new (GtkAdjustment *adjustment,
const char *format);</PRE><P>Creates a new <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A>. <VAR CLASS="PARAMETER">format</VAR> is used to determine the
way that the current value will be displayed, and should contain a
"%<VAR CLASS="LITERAL">f</VAR>" or similar escape somewhere, or Bad Things are bound to
happen.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN828"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">adjustment</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the <SPAN CLASS="TYPE">GtkAdjustment</SPAN> that the new button will use</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN835"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">format</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a printf style format specifier for the button's label</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN840"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a newly created <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A> </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN847"></A><H3><A NAME="PHAT-SLIDER-BUTTON-NEW-WITH-RANGE"></A>phat_slider_button_new_with_range ()</H3><PRE CLASS="PROGRAMLISTING">GtkWidget* phat_slider_button_new_with_range
(double value,
double lower,
double upper,
double step,
const char *format);</PRE><P>Creates a new <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A>. The slider will create a new
<SPAN CLASS="TYPE">GtkAdjustment</SPAN> from <VAR CLASS="PARAMETER">value</VAR>, <VAR CLASS="PARAMETER">lower</VAR>, <VAR CLASS="PARAMETER">upper</VAR>, and <VAR CLASS="PARAMETER">step</VAR>. If these
parameters represent a bogus configuration, the program will
terminate.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN870"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">value</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the initial value the new button should have</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN875"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">lower</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the lowest value the new button will allow</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN880"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">upper</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the highest value the new button will allow</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN885"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">step</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> increment added or subtracted when sliding</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN890"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">format</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a printf style format specifier for the button's label</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN895"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a newly created <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A> </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN902"></A><H3><A NAME="PHAT-SLIDER-BUTTON-SET-VALUE"></A>phat_slider_button_set_value ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_set_value (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double value);</PRE><P>Sets the current value of the button. If the value is outside the
range of values allowed by <VAR CLASS="PARAMETER">button</VAR>, it will be clamped. The button
emits the "value-changed" signal if the value changes.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN915"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN922"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">value</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a new value for the button</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN927"></A><H3><A NAME="PHAT-SLIDER-BUTTON-GET-VALUE"></A>phat_slider_button_get_value ()</H3><PRE CLASS="PROGRAMLISTING">double phat_slider_button_get_value (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button);</PRE><P>Retrieves the current value of the button.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN938"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN945"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> current value of the button </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN950"></A><H3><A NAME="PHAT-SLIDER-BUTTON-SET-RANGE"></A>phat_slider_button_set_range ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_set_range (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double lower,
double upper);</PRE><P>Sets the range of allowable values for the button, and clamps the
button's current value to be between <VAR CLASS="PARAMETER">lower</VAR> and <VAR CLASS="PARAMETER">upper</VAR>.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN965"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN972"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">lower</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> lowest allowable value</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN977"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">upper</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> highest allowable value</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN982"></A><H3><A NAME="PHAT-SLIDER-BUTTON-GET-RANGE"></A>phat_slider_button_get_range ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_get_range (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double *lower,
double *upper);</PRE><P>Places the range of allowable values for <VAR CLASS="PARAMETER">button</VAR> into <VAR CLASS="PARAMETER">lower</VAR>
and <VAR CLASS="PARAMETER">upper</VAR>. Either variable may be set to <VAR CLASS="LITERAL">NULL</VAR> if you are not
interested in its value.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN999"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1006"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">lower</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves lowest allowable value</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1011"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">upper</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves highest allowable value</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1016"></A><H3><A NAME="PHAT-SLIDER-BUTTON-SET-ADJUSTMENT"></A>phat_slider_button_set_adjustment ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_set_adjustment
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
GtkAdjustment *adjustment);</PRE><P>Sets the adjustment used by <VAR CLASS="PARAMETER">button</VAR>. If <VAR CLASS="PARAMETER">adjustment</VAR> is <VAR CLASS="LITERAL">NULL</VAR>, a
new adjustment with a value of zero and a range of [-1.0, 1.0] will
be created.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1031"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1038"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">adjustment</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <SPAN CLASS="TYPE">GtkAdjustment</SPAN></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1045"></A><H3><A NAME="PHAT-SLIDER-BUTTON-GET-ADJUSTMENT"></A>phat_slider_button_get_adjustment ()</H3><PRE CLASS="PROGRAMLISTING">GtkAdjustment* phat_slider_button_get_adjustment
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button);</PRE><P>Retrives the current adjustment in use by <VAR CLASS="PARAMETER">button</VAR>.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1057"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1064"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> <VAR CLASS="PARAMETER">button</VAR>'s current <SPAN CLASS="TYPE">GtkAdjustment</SPAN> </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1072"></A><H3><A NAME="PHAT-SLIDER-BUTTON-SET-INCREMENT"></A>phat_slider_button_set_increment ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_set_increment
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double step,
double page);</PRE><P>Sets the increments the button should use.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1085"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1092"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">step</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> step increment value</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1097"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">page</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> page increment value</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1102"></A><H3><A NAME="PHAT-SLIDER-BUTTON-GET-INCREMENT"></A>phat_slider_button_get_increment ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_get_increment
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
double *step,
double *page);</PRE><P>Places the button's increment values into <VAR CLASS="PARAMETER">step</VAR> and <VAR CLASS="PARAMETER">page</VAR>. Either
variable may be set to <VAR CLASS="LITERAL">NULL</VAR> if you are not interested in its
value.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1118"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1125"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">step</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves step increment value</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1130"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">page</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves page increment value</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1135"></A><H3><A NAME="PHAT-SLIDER-BUTTON-SET-FORMAT"></A>phat_slider_button_set_format ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_set_format (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
const char *format,
const char *prefix,
const char *postfix);</PRE><P>Sets the format and extra text <VAR CLASS="PARAMETER">button</VAR> uses to render it's label.
If the first character in either <VAR CLASS="PARAMETER">prefix</VAR> or <VAR CLASS="PARAMETER">postfix</VAR> is '\0' the
corresponding parameter will be unset. If <VAR CLASS="PARAMETER">format</VAR> is not a valid
string with a "%<VAR CLASS="LITERAL">f</VAR>" or compatible escape somewhere, woe betide
you. Any field you aren't interested in adjusting may be set to
<VAR CLASS="LITERAL">NULL</VAR>.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1155"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1162"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">format</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a printf style format specifier</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1167"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">prefix</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> text to prepend to number</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1172"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">postfix</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> text to append to number</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1177"></A><H3><A NAME="PHAT-SLIDER-BUTTON-GET-FORMAT"></A>phat_slider_button_get_format ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_get_format (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
char **format,
char **prefix,
char **postfix);</PRE><P>Retrieves the format specifier <VAR CLASS="PARAMETER">button</VAR> uses to create its label.
The value returned will point to the button's local copy,
so don't write to it.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1192"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1199"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">format</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves the format specifier</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1204"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">prefix</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves text prepended to number</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1209"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">postfix</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> retrieves text appended to number</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1214"></A><H3><A NAME="PHAT-SLIDER-BUTTON-SET-THRESHOLD"></A>phat_slider_button_set_threshold ()</H3><PRE CLASS="PROGRAMLISTING">void phat_slider_button_set_threshold
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
guint threshold);</PRE><P>Sets the threshold for <VAR CLASS="PARAMETER">button</VAR>. The threshold is how far the user
has to move the mouse to effect a change when sliding.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1227"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1234"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">threshold</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> an unsigned int >= 1</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1239"></A><H3><A NAME="PHAT-SLIDER-BUTTON-GET-THRESHOLD"></A>phat_slider_button_get_threshold ()</H3><PRE CLASS="PROGRAMLISTING">int phat_slider_button_get_threshold
(<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button);</PRE><P>Retrieves the threshold for <VAR CLASS="PARAMETER">button</VAR></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1251"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="phatsliderbutton.html"><SPAN CLASS="TYPE">PhatSliderButton</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1258"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the threshold for <VAR CLASS="PARAMETER">button</VAR>, or -1 if <VAR CLASS="PARAMETER">button</VAR> is invalid </P></TD></TR></TBODY></TABLE></DIV></DIV><DIV CLASS="REFSECT1"><A NAME="AEN1265"></A><H2>Signals</H2><DIV CLASS="REFSECT2"><A NAME="AEN1267"></A><H3><A NAME="PHATSLIDERBUTTON-CHANGED"></A>The "changed" signal</H3><PRE CLASS="PROGRAMLISTING">void user_function (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
gpointer user_data);</PRE><P>The "changed" signal is emitted when any parameter of the
slider's adjustment changes, except for the <VAR CLASS="LITERAL">value</VAR> parameter.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1278"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the object on which the signal was emitted</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1283"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">user_data</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>user data set when the signal handler was connected.</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN1288"></A><H3><A NAME="PHATSLIDERBUTTON-VALUE-CHANGED"></A>The "value-changed" signal</H3><PRE CLASS="PROGRAMLISTING">void user_function (<A HREF="phatsliderbutton.html">PhatSliderButton</A> *button,
gpointer user_data);</PRE><P>The "value-changed" signal is emitted when the value of the
button's adjustment changes.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1298"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">button</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the object on which the signal was emitted</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN1303"><SPAN STYLE="white-space: nowrap"><VAR CLASS="PARAMETER">user_data</VAR> :</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>user data set when the signal handler was connected.</P></TD></TR></TBODY></TABLE></DIV></DIV><TABLE CLASS="navigation" WIDTH="100%" SUMMARY="Navigation footer" CELLPADDING="2" CELLSPACING="2"><TR VALIGN="middle"><TD ALIGN="left"><A ACCESSKEY="p" HREF="phatvfanslider.html"><B><<< PhatVFanSlider</B></A></TD><TD ALIGN="right"></TD></TR></TABLE></BODY></HTML>
|
