4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>GimpMemsizeEntry</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GIMP Widgets Library Reference Manual">
8
8
<link rel="up" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
9
9
<link rel="prev" href="GimpIntStore.html" title="GimpIntStore">
10
10
<link rel="next" href="GimpOffsetArea.html" title="GimpOffsetArea">
11
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="libgimpwidgets-widgets.html" title="Part I. GIMP Widgets">
14
14
<link rel="chapter" href="libgimpwidgets-hierarchy.html" title="Object Hierarchy">
15
<link rel="chapter" href="libgimpwidgets-gallery.html" title="Widget Gallery">
15
16
<link rel="chapter" href="libgimpwidgets-cell-renderers.html" title="Cell Renderers for GtkTreeView">
16
17
<link rel="part" href="libgimpwidgets-colordisplay.html" title="Part II. GIMP Display Filters">
17
18
<link rel="part" href="libgimpwidgets-colorselector.html" title="Part III. GIMP Color Selectors">
18
19
<link rel="part" href="libgimpwidgets-controller.html" title="Part IV. GIMP Controllers">
19
20
<link rel="part" href="libgimpwidgets-utils.html" title="Part V. GIMP Widgets Utilities">
20
21
<link rel="part" href="libgimpwidgets-deprecated.html" title="Part VI. Deprecated API">
22
<link rel="index" href="libgimpwidgets-index.html" title="Index">
23
<link rel="index" href="libgimpwidgets-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
24
<link rel="index" href="libgimpwidgets-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
25
<link rel="index" href="libgimpwidgets-index-deprecated.html" title="Index of deprecated symbols">
22
27
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
28
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
28
33
<th width="100%" align="center">GIMP Widgets Library Reference Manual</th>
29
34
<td><a accesskey="n" href="GimpOffsetArea.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
33
<a href="#desc" class="shortcut">Description</a>
35
<a href="#object_hierarchy" class="shortcut">Object Hierarchy</a>
37
<a href="#signal_proto" class="shortcut">Signals</a></nobr></td></tr>
36
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2557702" class="shortcut">Top</a>
38
<a href="#id2615519" class="shortcut">Description</a>
40
<a href="#id2615412" class="shortcut">Object Hierarchy</a>
42
<a href="#id2615473" class="shortcut">Implemented Interfaces</a>
44
<a href="#id2615494" class="shortcut">Signals</a></nobr></td></tr>
39
46
<div class="refentry" lang="en">
40
47
<a name="GimpMemsizeEntry"></a><div class="titlepage"></div>
41
48
<div class="refnamediv"><table width="100%"><tr>
43
<h2><span class="refentrytitle"><a name="top_of_page"></a>GimpMemsizeEntry</span></h2>
51
<a name="id2557702"></a><span class="refentrytitle">GimpMemsizeEntry</span>
44
53
<p>GimpMemsizeEntry — A composite widget that allows to enter a memory size.</p>
46
<td valign="top" align="right"></td>
55
<td valign="top" align="right"><img src="gimp-memsize-entry.png"></td>
47
56
</tr></table></div>
48
57
<div class="refsynopsisdiv">
49
<a name="synopsis"></a><h2>Synopsis</h2>
50
59
<pre class="synopsis">
54
<a href="GimpMemsizeEntry.html#GimpMemsizeEntry-struct">GimpMemsizeEntry</a>;
55
GtkWidget* <a href="GimpMemsizeEntry.html#gimp-memsize-entry-new">gimp_memsize_entry_new</a> (guint64 value,
58
void <a href="GimpMemsizeEntry.html#gimp-memsize-entry-set-value">gimp_memsize_entry_set_value</a> (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry,
60
guint64 <a href="GimpMemsizeEntry.html#gimp-memsize-entry-get-value">gimp_memsize_entry_get_value</a> (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry);
63
<a href="GimpMemsizeEntry.html#GimpMemsizeEntry-struct">GimpMemsizeEntry</a>;
64
GtkWidget* <a href="GimpMemsizeEntry.html#gimp-memsize-entry-new">gimp_memsize_entry_new</a> (guint64 value,
67
void <a href="GimpMemsizeEntry.html#gimp-memsize-entry-set-value">gimp_memsize_entry_set_value</a> (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry,
69
guint64 <a href="GimpMemsizeEntry.html#gimp-memsize-entry-get-value">gimp_memsize_entry_get_value</a> (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry);
64
73
<div class="refsect1" lang="en">
65
<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>
74
<a name="id2615412"></a><h2>Object Hierarchy</h2>
66
75
<pre class="synopsis">
78
87
<div class="refsect1" lang="en">
79
<a name="impl_interfaces"></a><h2>Implemented Interfaces</h2>
88
<a name="id2615473"></a><h2>Implemented Interfaces</h2>
81
90
GimpMemsizeEntry implements
82
91
AtkImplementorIface.</p>
84
93
<div class="refsect1" lang="en">
85
<a name="signal_proto"></a><h2>Signals</h2>
94
<a name="id2615494"></a><h2>Signals</h2>
86
95
<pre class="synopsis">
88
"<a href="GimpMemsizeEntry.html#GimpMemsizeEntry-value-changed">value-changed</a>"
89
void user_function (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *gimpmemsizeentry,
90
gpointer user_data) : Run first
97
"<a href="GimpMemsizeEntry.html#GimpMemsizeEntry-value-changed">value-changed</a>" : Run First
93
100
<div class="refsect1" lang="en">
94
<a name="desc"></a><h2>Description</h2>
101
<a name="id2615519"></a><h2>Description</h2>
96
103
Similar to a <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> but instead of lengths, this widget is used to let
97
104
the user enter memory sizes. An option menu allows to switch between
101
108
<div class="refsect1" lang="en">
102
<a name="details"></a><h2>Details</h2>
109
<a name="id2615545"></a><h2>Details</h2>
103
110
<div class="refsect2" lang="en">
104
<a name="id2568456"></a><h3>
111
<a name="id2615556"></a><h3>
105
112
<a name="GimpMemsizeEntry-struct"></a>GimpMemsizeEntry</h3>
106
<a class="indexterm" name="id2568468"></a><pre class="programlisting">typedef struct _GimpMemsizeEntry GimpMemsizeEntry;</pre>
113
<a class="indexterm" name="id2615568"></a><pre class="programlisting">typedef struct _GimpMemsizeEntry GimpMemsizeEntry;</pre>
108
115
The <a href="GimpSizeEntry.html" title="GimpSizeEntry"><span class="type">GimpSizeEntry</span></a> struct is considered private.
112
119
<div class="refsect2" lang="en">
113
<a name="id2568491"></a><h3>
120
<a name="id2615591"></a><h3>
114
121
<a name="gimp-memsize-entry-new"></a>gimp_memsize_entry_new ()</h3>
115
<a class="indexterm" name="id2568502"></a><pre class="programlisting">GtkWidget* gimp_memsize_entry_new (guint64 value,
117
guint64 upper);</pre>
122
<a class="indexterm" name="id2615602"></a><pre class="programlisting">GtkWidget* gimp_memsize_entry_new (guint64 value,
124
guint64 upper);</pre>
119
126
Creates a new <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a> which is a <span class="type">GtkHBox</span> with a <span class="type">GtkSpinButton</span>
120
127
and a <span class="type">GtkOptionMenu</span> all setup to allow the user to enter memory sizes.</p>
125
132
<col align="left" valign="top">
129
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
135
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
130
136
<td> the initial value (in Bytes)
135
<span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
140
<td><span class="term"><em class="parameter"><code>lower</code></em> :</span></td>
136
141
<td> the lower limit for the value (in Bytes)
141
<span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
145
<td><span class="term"><em class="parameter"><code>upper</code></em> :</span></td>
142
146
<td> the upper limit for the value (in Bytes)
147
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
150
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
148
151
<td> Pointer to the new <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a>.
155
158
<div class="refsect2" lang="en">
156
<a name="id2574898"></a><h3>
159
<a name="id2613325"></a><h3>
157
160
<a name="gimp-memsize-entry-set-value"></a>gimp_memsize_entry_set_value ()</h3>
158
<a class="indexterm" name="id2574910"></a><pre class="programlisting">void gimp_memsize_entry_set_value (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry,
159
guint64 value);</pre>
161
<a class="indexterm" name="id2613336"></a><pre class="programlisting">void gimp_memsize_entry_set_value (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry,
162
guint64 value);</pre>
161
164
Sets the <em class="parameter"><code>entry</code></em>'s value. Please note that the <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a> rounds
162
165
the value to full Kilobytes.</p>
167
170
<col align="left" valign="top">
171
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
173
<td><span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
172
174
<td> a <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a>
177
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
178
<td><span class="term"><em class="parameter"><code>value</code></em> :</span></td>
178
179
<td> the new value (in Bytes)
185
186
<div class="refsect2" lang="en">
186
<a name="id2575001"></a><h3>
187
<a name="id2613427"></a><h3>
187
188
<a name="gimp-memsize-entry-get-value"></a>gimp_memsize_entry_get_value ()</h3>
188
<a class="indexterm" name="id2575013"></a><pre class="programlisting">guint64 gimp_memsize_entry_get_value (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry);</pre>
189
<a class="indexterm" name="id2613438"></a><pre class="programlisting">guint64 gimp_memsize_entry_get_value (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *entry);</pre>
190
191
Retrieves the current value from a <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a>.</p>
195
196
<col align="left" valign="top">
199
<span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
199
<td><span class="term"><em class="parameter"><code>entry</code></em> :</span></td>
200
200
<td> a <a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry"><span class="type">GimpMemsizeEntry</span></a>
205
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
204
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
206
205
<td> the current value of <em class="parameter"><code>entry</code></em> (in Bytes).
213
212
<div class="refsect1" lang="en">
214
<a name="signals"></a><h2>Signal Details</h2>
213
<a name="id2610383"></a><h2>Signal Details</h2>
215
214
<div class="refsect2" lang="en">
216
<a name="id2575108"></a><h3>
215
<a name="id2610394"></a><h3>
217
216
<a name="GimpMemsizeEntry-value-changed"></a>The "value-changed" signal</h3>
218
<a class="indexterm" name="id2571551"></a><pre class="programlisting">void user_function (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *gimpmemsizeentry,
219
gpointer user_data) : Run first</pre>
217
<a class="indexterm" name="id2610402"></a><pre class="programlisting">void user_function (<a href="GimpMemsizeEntry.html" title="GimpMemsizeEntry">GimpMemsizeEntry</a> *gimpmemsizeentry,
218
gpointer user_data) : Run First</pre>
224
223
<col align="left" valign="top">
228
<span class="term"><em class="parameter"><code>gimpmemsizeentry</code></em> :</span></td>
226
<td><span class="term"><em class="parameter"><code>gimpmemsizeentry</code></em> :</span></td>
229
227
<td>the object which received the signal.
235
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
232
<td><span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
236
233
<td>user data set when the signal handler was connected.</td>