112
108
<title role="details.title">Details</title>
113
109
<refsect2 id="GimpPageSelector-struct" role="struct">
114
110
<title>GimpPageSelector</title>
115
<indexterm zone="GimpPageSelector-struct"><primary>GimpPageSelector</primary></indexterm><programlisting>typedef struct _GimpPageSelector GimpPageSelector;</programlisting>
111
<indexterm zone="GimpPageSelector-struct"><primary sortas="GimpPageSelector">GimpPageSelector</primary></indexterm><programlisting>typedef struct _GimpPageSelector GimpPageSelector;</programlisting>
118
113
</para></refsect2>
119
114
<refsect2 id="GimpPageSelectorTarget" role="enum">
120
115
<title>enum GimpPageSelectorTarget</title>
121
<indexterm zone="GimpPageSelectorTarget"><primary>GimpPageSelectorTarget</primary></indexterm><programlisting>typedef enum
116
<indexterm zone="GimpPageSelectorTarget"><primary sortas="GimpPageSelectorTarget">GimpPageSelectorTarget</primary></indexterm><programlisting>typedef enum
123
118
GIMP_PAGE_SELECTOR_TARGET_LAYERS, /*< desc="Layers" >*/
124
119
GIMP_PAGE_SELECTOR_TARGET_IMAGES /*< desc="Images" >*/
125
120
} GimpPageSelectorTarget;
126
121
</programlisting>
129
123
</para></refsect2>
130
124
<refsect2 id="gimp-page-selector-new" role="function" condition="since:GIMP 2.4">
131
125
<title>gimp_page_selector_new ()</title>
132
<indexterm zone="gimp-page-selector-new" role="GIMP 2.4"><primary>gimp_page_selector_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gimp_page_selector_new (void);</programlisting>
126
<indexterm zone="gimp-page-selector-new" role="GIMP 2.4"><primary sortas="gimp_page_selector_new">gimp_page_selector_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> * gimp_page_selector_new (void);</programlisting>
134
128
Creates a new <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link> widget.</para>
137
130
</para><variablelist role="params">
138
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> Pointer to the new <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link> widget.
131
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> Pointer to the new <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link> widget.
140
133
</simpara></listitem></varlistentry>
141
</variablelist><para role="since">Since GIMP 2.4
134
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
143
135
<refsect2 id="gimp-page-selector-set-n-pages" role="function" condition="since:GIMP 2.4">
144
136
<title>gimp_page_selector_set_n_pages ()</title>
145
<indexterm zone="gimp-page-selector-set-n-pages" role="GIMP 2.4"><primary>gimp_page_selector_set_n_pages</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_n_pages (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
137
<indexterm zone="gimp-page-selector-set-n-pages" role="GIMP 2.4"><primary sortas="gimp_page_selector_set_n_pages">gimp_page_selector_set_n_pages</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_n_pages (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
146
138
<link linkend="gint">gint</link> n_pages);</programlisting>
148
140
Sets the number of pages in the document to open.</para>
151
142
</para><variablelist role="params">
152
<varlistentry><term><parameter>selector</parameter> :</term>
143
<varlistentry><term><parameter>selector</parameter> :</term>
153
144
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
154
145
</simpara></listitem></varlistentry>
155
<varlistentry><term><parameter>n_pages</parameter> :</term>
146
<varlistentry><term><parameter>n_pages</parameter> :</term>
156
147
<listitem><simpara> The number of pages.
157
148
</simpara></listitem></varlistentry>
158
</variablelist><para role="since">Since GIMP 2.4
149
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
160
150
<refsect2 id="gimp-page-selector-get-n-pages" role="function" condition="since:GIMP 2.4">
161
151
<title>gimp_page_selector_get_n_pages ()</title>
162
<indexterm zone="gimp-page-selector-get-n-pages" role="GIMP 2.4"><primary>gimp_page_selector_get_n_pages</primary></indexterm><programlisting><link linkend="gint">gint</link> gimp_page_selector_get_n_pages (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
152
<indexterm zone="gimp-page-selector-get-n-pages" role="GIMP 2.4"><primary sortas="gimp_page_selector_get_n_pages">gimp_page_selector_get_n_pages</primary></indexterm><programlisting><link linkend="gint">gint</link> gimp_page_selector_get_n_pages (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
167
156
</para><variablelist role="params">
168
<varlistentry><term><parameter>selector</parameter> :</term>
157
<varlistentry><term><parameter>selector</parameter> :</term>
169
158
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
170
159
</simpara></listitem></varlistentry>
171
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the number of pages in the document to open.
160
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the number of pages in the document to open.
173
162
</simpara></listitem></varlistentry>
174
</variablelist><para role="since">Since GIMP 2.4
163
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
176
164
<refsect2 id="gimp-page-selector-set-target" role="function" condition="since:GIMP 2.4">
177
165
<title>gimp_page_selector_set_target ()</title>
178
<indexterm zone="gimp-page-selector-set-target" role="GIMP 2.4"><primary>gimp_page_selector_set_target</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_target (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
166
<indexterm zone="gimp-page-selector-set-target" role="GIMP 2.4"><primary sortas="gimp_page_selector_set_target">gimp_page_selector_set_target</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_target (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
179
167
<link linkend="GimpPageSelectorTarget">GimpPageSelectorTarget</link> target);</programlisting>
184
171
</para><variablelist role="params">
185
<varlistentry><term><parameter>selector</parameter> :</term>
172
<varlistentry><term><parameter>selector</parameter> :</term>
186
173
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
187
174
</simpara></listitem></varlistentry>
188
<varlistentry><term><parameter>target</parameter> :</term>
175
<varlistentry><term><parameter>target</parameter> :</term>
189
176
<listitem><simpara> How to open the selected pages.
190
177
</simpara></listitem></varlistentry>
191
</variablelist><para role="since">Since GIMP 2.4
178
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
193
179
<refsect2 id="gimp-page-selector-get-target" role="function" condition="since:GIMP 2.4">
194
180
<title>gimp_page_selector_get_target ()</title>
195
<indexterm zone="gimp-page-selector-get-target" role="GIMP 2.4"><primary>gimp_page_selector_get_target</primary></indexterm><programlisting><link linkend="GimpPageSelectorTarget">GimpPageSelectorTarget</link> gimp_page_selector_get_target (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
181
<indexterm zone="gimp-page-selector-get-target" role="GIMP 2.4"><primary sortas="gimp_page_selector_get_target">gimp_page_selector_get_target</primary></indexterm><programlisting><link linkend="GimpPageSelectorTarget">GimpPageSelectorTarget</link> gimp_page_selector_get_target (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
200
185
</para><variablelist role="params">
201
<varlistentry><term><parameter>selector</parameter> :</term>
186
<varlistentry><term><parameter>selector</parameter> :</term>
202
187
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
203
188
</simpara></listitem></varlistentry>
204
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> How the selected pages should be opened.
189
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> How the selected pages should be opened.
206
191
</simpara></listitem></varlistentry>
207
</variablelist><para role="since">Since GIMP 2.4
192
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
209
193
<refsect2 id="gimp-page-selector-set-page-thumbnail" role="function" condition="since:GIMP 2.4">
210
194
<title>gimp_page_selector_set_page_thumbnail ()</title>
211
<indexterm zone="gimp-page-selector-set-page-thumbnail" role="GIMP 2.4"><primary>gimp_page_selector_set_page_thumbnail</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_page_thumbnail
195
<indexterm zone="gimp-page-selector-set-page-thumbnail" role="GIMP 2.4"><primary sortas="gimp_page_selector_set_page_thumbnail">gimp_page_selector_set_page_thumbnail</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_page_thumbnail
212
196
(<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
213
197
<link linkend="gint">gint</link> page_no,
214
198
<link linkend="GdkPixbuf">GdkPixbuf</link> *thumbnail);</programlisting>
216
200
Sets the thumbnail for given <link linkend="page-no"><literal>page_no</literal></link>. A default "page" icon will
217
201
be used if no page thumbnail is set.</para>
220
203
</para><variablelist role="params">
221
<varlistentry><term><parameter>selector</parameter> :</term>
204
<varlistentry><term><parameter>selector</parameter> :</term>
222
205
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
223
206
</simpara></listitem></varlistentry>
224
<varlistentry><term><parameter>page_no</parameter> :</term>
207
<varlistentry><term><parameter>page_no</parameter> :</term>
225
208
<listitem><simpara> The number of the page to set the thumbnail for.
226
209
</simpara></listitem></varlistentry>
227
<varlistentry><term><parameter>thumbnail</parameter> :</term>
210
<varlistentry><term><parameter>thumbnail</parameter> :</term>
228
211
<listitem><simpara> The thumbnail pixbuf.
229
212
</simpara></listitem></varlistentry>
230
</variablelist><para role="since">Since GIMP 2.4
213
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
232
214
<refsect2 id="gimp-page-selector-get-page-thumbnail" role="function" condition="since:GIMP 2.4">
233
215
<title>gimp_page_selector_get_page_thumbnail ()</title>
234
<indexterm zone="gimp-page-selector-get-page-thumbnail" role="GIMP 2.4"><primary>gimp_page_selector_get_page_thumbnail</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link>* gimp_page_selector_get_page_thumbnail
216
<indexterm zone="gimp-page-selector-get-page-thumbnail" role="GIMP 2.4"><primary sortas="gimp_page_selector_get_page_thumbnail">gimp_page_selector_get_page_thumbnail</primary></indexterm><programlisting><link linkend="GdkPixbuf">GdkPixbuf</link> * gimp_page_selector_get_page_thumbnail
235
217
(<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
236
218
<link linkend="gint">gint</link> page_no);</programlisting>
241
222
</para><variablelist role="params">
242
<varlistentry><term><parameter>selector</parameter> :</term>
223
<varlistentry><term><parameter>selector</parameter> :</term>
243
224
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
244
225
</simpara></listitem></varlistentry>
245
<varlistentry><term><parameter>page_no</parameter> :</term>
226
<varlistentry><term><parameter>page_no</parameter> :</term>
246
227
<listitem><simpara> The number of the page to get the thumbnail for.
247
228
</simpara></listitem></varlistentry>
248
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The page's thumbnail, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if none is set. The returned
229
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The page's thumbnail, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if none is set. The returned
249
230
pixbuf is owned by <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link> and must not be
250
231
unref'ed when no longer needed.
252
233
</simpara></listitem></varlistentry>
253
</variablelist><para role="since">Since GIMP 2.4
234
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
255
235
<refsect2 id="gimp-page-selector-set-page-label" role="function" condition="since:GIMP 2.4">
256
236
<title>gimp_page_selector_set_page_label ()</title>
257
<indexterm zone="gimp-page-selector-set-page-label" role="GIMP 2.4"><primary>gimp_page_selector_set_page_label</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_page_label (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
237
<indexterm zone="gimp-page-selector-set-page-label" role="GIMP 2.4"><primary sortas="gimp_page_selector_set_page_label">gimp_page_selector_set_page_label</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_set_page_label (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
258
238
<link linkend="gint">gint</link> page_no,
259
239
const <link linkend="gchar">gchar</link> *label);</programlisting>
264
243
</para><variablelist role="params">
265
<varlistentry><term><parameter>selector</parameter> :</term>
244
<varlistentry><term><parameter>selector</parameter> :</term>
266
245
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
267
246
</simpara></listitem></varlistentry>
268
<varlistentry><term><parameter>page_no</parameter> :</term>
247
<varlistentry><term><parameter>page_no</parameter> :</term>
269
248
<listitem><simpara> The number of the page to set the label for.
270
249
</simpara></listitem></varlistentry>
271
<varlistentry><term><parameter>label</parameter> :</term>
250
<varlistentry><term><parameter>label</parameter> :</term>
272
251
<listitem><simpara> The label.
273
252
</simpara></listitem></varlistentry>
274
</variablelist><para role="since">Since GIMP 2.4
253
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
276
254
<refsect2 id="gimp-page-selector-get-page-label" role="function" condition="since:GIMP 2.4">
277
255
<title>gimp_page_selector_get_page_label ()</title>
278
<indexterm zone="gimp-page-selector-get-page-label" role="GIMP 2.4"><primary>gimp_page_selector_get_page_label</primary></indexterm><programlisting><link linkend="gchar">gchar</link>* gimp_page_selector_get_page_label (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
256
<indexterm zone="gimp-page-selector-get-page-label" role="GIMP 2.4"><primary sortas="gimp_page_selector_get_page_label">gimp_page_selector_get_page_label</primary></indexterm><programlisting><link linkend="gchar">gchar</link> * gimp_page_selector_get_page_label (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
279
257
<link linkend="gint">gint</link> page_no);</programlisting>
284
261
</para><variablelist role="params">
285
<varlistentry><term><parameter>selector</parameter> :</term>
262
<varlistentry><term><parameter>selector</parameter> :</term>
286
263
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
287
264
</simpara></listitem></varlistentry>
288
<varlistentry><term><parameter>page_no</parameter> :</term>
265
<varlistentry><term><parameter>page_no</parameter> :</term>
289
266
<listitem><simpara> The number of the page to get the thumbnail for.
290
267
</simpara></listitem></varlistentry>
291
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The page's label, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if none is set. This is a newly
268
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The page's label, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if none is set. This is a newly
292
269
allocated string that should be <link linkend="g-free"><function>g_free()</function></link>'d when no longer
295
272
</simpara></listitem></varlistentry>
296
</variablelist><para role="since">Since GIMP 2.4
273
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
298
274
<refsect2 id="gimp-page-selector-select-all" role="function" condition="since:GIMP 2.4">
299
275
<title>gimp_page_selector_select_all ()</title>
300
<indexterm zone="gimp-page-selector-select-all" role="GIMP 2.4"><primary>gimp_page_selector_select_all</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_select_all (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
276
<indexterm zone="gimp-page-selector-select-all" role="GIMP 2.4"><primary sortas="gimp_page_selector_select_all">gimp_page_selector_select_all</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_select_all (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
302
278
Selects all pages.</para>
305
280
</para><variablelist role="params">
306
<varlistentry><term><parameter>selector</parameter> :</term>
281
<varlistentry><term><parameter>selector</parameter> :</term>
307
282
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
308
283
</simpara></listitem></varlistentry>
309
</variablelist><para role="since">Since GIMP 2.4
284
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
311
285
<refsect2 id="gimp-page-selector-unselect-all" role="function" condition="since:GIMP 2.4">
312
286
<title>gimp_page_selector_unselect_all ()</title>
313
<indexterm zone="gimp-page-selector-unselect-all" role="GIMP 2.4"><primary>gimp_page_selector_unselect_all</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_unselect_all (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
287
<indexterm zone="gimp-page-selector-unselect-all" role="GIMP 2.4"><primary sortas="gimp_page_selector_unselect_all">gimp_page_selector_unselect_all</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_unselect_all (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
315
289
Unselects all pages.</para>
318
291
</para><variablelist role="params">
319
<varlistentry><term><parameter>selector</parameter> :</term>
292
<varlistentry><term><parameter>selector</parameter> :</term>
320
293
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
321
294
</simpara></listitem></varlistentry>
322
</variablelist><para role="since">Since GIMP 2.4
295
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
324
296
<refsect2 id="gimp-page-selector-select-page" role="function" condition="since:GIMP 2.4">
325
297
<title>gimp_page_selector_select_page ()</title>
326
<indexterm zone="gimp-page-selector-select-page" role="GIMP 2.4"><primary>gimp_page_selector_select_page</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_select_page (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
298
<indexterm zone="gimp-page-selector-select-page" role="GIMP 2.4"><primary sortas="gimp_page_selector_select_page">gimp_page_selector_select_page</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_select_page (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
327
299
<link linkend="gint">gint</link> page_no);</programlisting>
329
301
Adds a page to the selection.</para>
332
303
</para><variablelist role="params">
333
<varlistentry><term><parameter>selector</parameter> :</term>
304
<varlistentry><term><parameter>selector</parameter> :</term>
334
305
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
335
306
</simpara></listitem></varlistentry>
336
<varlistentry><term><parameter>page_no</parameter> :</term>
307
<varlistentry><term><parameter>page_no</parameter> :</term>
337
308
<listitem><simpara> The number of the page to select.
338
309
</simpara></listitem></varlistentry>
339
</variablelist><para role="since">Since GIMP 2.4
310
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
341
311
<refsect2 id="gimp-page-selector-unselect-page" role="function" condition="since:GIMP 2.4">
342
312
<title>gimp_page_selector_unselect_page ()</title>
343
<indexterm zone="gimp-page-selector-unselect-page" role="GIMP 2.4"><primary>gimp_page_selector_unselect_page</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_unselect_page (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
313
<indexterm zone="gimp-page-selector-unselect-page" role="GIMP 2.4"><primary sortas="gimp_page_selector_unselect_page">gimp_page_selector_unselect_page</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_unselect_page (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
344
314
<link linkend="gint">gint</link> page_no);</programlisting>
346
316
Removes a page from the selection.</para>
349
318
</para><variablelist role="params">
350
<varlistentry><term><parameter>selector</parameter> :</term>
319
<varlistentry><term><parameter>selector</parameter> :</term>
351
320
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
352
321
</simpara></listitem></varlistentry>
353
<varlistentry><term><parameter>page_no</parameter> :</term>
322
<varlistentry><term><parameter>page_no</parameter> :</term>
354
323
<listitem><simpara> The number of the page to unselect.
355
324
</simpara></listitem></varlistentry>
356
</variablelist><para role="since">Since GIMP 2.4
325
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
358
326
<refsect2 id="gimp-page-selector-page-is-selected" role="function" condition="since:GIMP 2.4">
359
327
<title>gimp_page_selector_page_is_selected ()</title>
360
<indexterm zone="gimp-page-selector-page-is-selected" role="GIMP 2.4"><primary>gimp_page_selector_page_is_selected</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_page_selector_page_is_selected (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
328
<indexterm zone="gimp-page-selector-page-is-selected" role="GIMP 2.4"><primary sortas="gimp_page_selector_page_is_selected">gimp_page_selector_page_is_selected</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> gimp_page_selector_page_is_selected (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
361
329
<link linkend="gint">gint</link> page_no);</programlisting>
366
333
</para><variablelist role="params">
367
<varlistentry><term><parameter>selector</parameter> :</term>
334
<varlistentry><term><parameter>selector</parameter> :</term>
368
335
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
369
336
</simpara></listitem></varlistentry>
370
<varlistentry><term><parameter>page_no</parameter> :</term>
337
<varlistentry><term><parameter>page_no</parameter> :</term>
371
338
<listitem><simpara> The number of the page to check.
372
339
</simpara></listitem></varlistentry>
373
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the page is selected, <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
340
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the page is selected, <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> otherwise.
375
342
</simpara></listitem></varlistentry>
376
</variablelist><para role="since">Since GIMP 2.4
343
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
378
344
<refsect2 id="gimp-page-selector-get-selected-pages" role="function" condition="since:GIMP 2.4">
379
345
<title>gimp_page_selector_get_selected_pages ()</title>
380
<indexterm zone="gimp-page-selector-get-selected-pages" role="GIMP 2.4"><primary>gimp_page_selector_get_selected_pages</primary></indexterm><programlisting><link linkend="gint">gint</link>* gimp_page_selector_get_selected_pages
346
<indexterm zone="gimp-page-selector-get-selected-pages" role="GIMP 2.4"><primary sortas="gimp_page_selector_get_selected_pages">gimp_page_selector_get_selected_pages</primary></indexterm><programlisting><link linkend="gint">gint</link> * gimp_page_selector_get_selected_pages
381
347
(<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
382
348
<link linkend="gint">gint</link> *n_selected_pages);</programlisting>
387
352
</para><variablelist role="params">
388
<varlistentry><term><parameter>selector</parameter> :</term>
353
<varlistentry><term><parameter>selector</parameter> :</term>
389
354
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
390
355
</simpara></listitem></varlistentry>
391
<varlistentry><term><parameter>n_selected_pages</parameter> :</term>
356
<varlistentry><term><parameter>n_selected_pages</parameter> :</term>
392
357
<listitem><simpara> Returns the number of selected pages.
393
358
</simpara></listitem></varlistentry>
394
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A sorted array of page numbers of selected pages. Use <link linkend="g-free"><function>g_free()</function></link> if
359
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A sorted array of page numbers of selected pages. Use <link linkend="g-free"><function>g_free()</function></link> if
395
360
you don't need the array any longer.
397
362
</simpara></listitem></varlistentry>
398
</variablelist><para role="since">Since GIMP 2.4
363
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
400
364
<refsect2 id="gimp-page-selector-select-range" role="function" condition="since:GIMP 2.4">
401
365
<title>gimp_page_selector_select_range ()</title>
402
<indexterm zone="gimp-page-selector-select-range" role="GIMP 2.4"><primary>gimp_page_selector_select_range</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_select_range (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
366
<indexterm zone="gimp-page-selector-select-range" role="GIMP 2.4"><primary sortas="gimp_page_selector_select_range">gimp_page_selector_select_range</primary></indexterm><programlisting><link linkend="void">void</link> gimp_page_selector_select_range (<link linkend="GimpPageSelector">GimpPageSelector</link> *selector,
403
367
const <link linkend="gchar">gchar</link> *range);</programlisting>
405
369
Selectes the pages described by <link linkend="range"><literal>range</literal></link>. The range string is a
411
375
Invalid pages and ranges will be silently ignored, duplicate and
412
376
overlapping pages and ranges will be merged.</para>
415
378
</para><variablelist role="params">
416
<varlistentry><term><parameter>selector</parameter> :</term>
379
<varlistentry><term><parameter>selector</parameter> :</term>
417
380
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
418
381
</simpara></listitem></varlistentry>
419
<varlistentry><term><parameter>range</parameter> :</term>
382
<varlistentry><term><parameter>range</parameter> :</term>
420
383
<listitem><simpara> A string representing the set of selected pages.
421
384
</simpara></listitem></varlistentry>
422
</variablelist><para role="since">Since GIMP 2.4
385
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
424
386
<refsect2 id="gimp-page-selector-get-selected-range" role="function" condition="since:GIMP 2.4">
425
387
<title>gimp_page_selector_get_selected_range ()</title>
426
<indexterm zone="gimp-page-selector-get-selected-range" role="GIMP 2.4"><primary>gimp_page_selector_get_selected_range</primary></indexterm><programlisting><link linkend="gchar">gchar</link>* gimp_page_selector_get_selected_range
388
<indexterm zone="gimp-page-selector-get-selected-range" role="GIMP 2.4"><primary sortas="gimp_page_selector_get_selected_range">gimp_page_selector_get_selected_range</primary></indexterm><programlisting><link linkend="gchar">gchar</link> * gimp_page_selector_get_selected_range
427
389
(<link linkend="GimpPageSelector">GimpPageSelector</link> *selector);</programlisting>
432
393
</para><variablelist role="params">
433
<varlistentry><term><parameter>selector</parameter> :</term>
394
<varlistentry><term><parameter>selector</parameter> :</term>
434
395
<listitem><simpara> Pointer to a <link linkend="GimpPageSelector"><type>GimpPageSelector</type></link>.
435
396
</simpara></listitem></varlistentry>
436
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A newly allocated string representing the set of selected
397
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> A newly allocated string representing the set of selected
437
398
pages. See <link linkend="gimp-page-selector-set-selected-range"><function>gimp_page_selector_set_selected_range()</function></link> for the
438
399
format of the string.
440
401
</simpara></listitem></varlistentry>
441
</variablelist><para role="since">Since GIMP 2.4
402
</variablelist><para role="since">Since GIMP 2.4</para></refsect2>
445
405
<refsect1 id="GimpPageSelector.property-details" role="property_details">
446
406
<title role="property_details.title">Property Details</title>
447
<refsect2 id="GimpPageSelector--n-pages"><title>The <literal>"n-pages"</literal> property</title>
448
<indexterm zone="GimpPageSelector--n-pages" role="GIMP 2.4"><primary>GimpPageSelector:n-pages</primary></indexterm><programlisting> "n-pages" <link linkend="gint">gint</link> : Read / Write</programlisting>
407
<refsect2 id="GimpPageSelector--n-pages" role="property"><title>The <literal>"n-pages"</literal> property</title>
408
<indexterm zone="GimpPageSelector--n-pages" role="GIMP 2.4"><primary sortas="GimpPageSelector:n-pages">GimpPageSelector:n-pages</primary></indexterm><programlisting> "n-pages" <link linkend="gint">gint</link> : Read / Write</programlisting>
450
410
The number of pages of the document to open.</para>
453
412
</para><para>Allowed values: >= 0</para>
454
413
<para>Default value: 0</para>
414
<para>Since GIMP 2.4</para>
458
<refsect2 id="GimpPageSelector--target"><title>The <literal>"target"</literal> property</title>
459
<indexterm zone="GimpPageSelector--target" role="GIMP 2.4"><primary>GimpPageSelector:target</primary></indexterm><programlisting> "target" <link linkend="GimpPageSelectorTarget">GimpPageSelectorTarget</link> : Read / Write</programlisting>
416
<refsect2 id="GimpPageSelector--target" role="property"><title>The <literal>"target"</literal> property</title>
417
<indexterm zone="GimpPageSelector--target" role="GIMP 2.4"><primary sortas="GimpPageSelector:target">GimpPageSelector:target</primary></indexterm><programlisting> "target" <link linkend="GimpPageSelectorTarget">GimpPageSelectorTarget</link> : Read / Write</programlisting>
461
419
The target to open the document to.</para>
464
421
</para><para>Default value: GIMP_PAGE_SELECTOR_TARGET_LAYERS</para>
422
<para>Since GIMP 2.4</para>
471
426
<refsect1 id="GimpPageSelector.signal-details" role="signals">
472
427
<title role="signals.title">Signal Details</title>
473
<refsect2 id="GimpPageSelector-activate"><title>The <literal>"activate"</literal> signal</title>
474
<indexterm zone="GimpPageSelector-activate" role="GIMP 2.4"><primary>GimpPageSelector::activate</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpPageSelector">GimpPageSelector</link> *widget,
428
<refsect2 id="GimpPageSelector-activate" role="signal"><title>The <literal>"activate"</literal> signal</title>
429
<indexterm zone="GimpPageSelector-activate" role="GIMP 2.4"><primary sortas="GimpPageSelector::activate">GimpPageSelector::activate</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpPageSelector">GimpPageSelector</link> *widget,
475
430
<link linkend="gpointer">gpointer</link> user_data) : Run First / Action</programlisting>
477
432
The "activate" signal on GimpPageSelector is an action signal. It
478
433
is emitted when a user double-clicks an item in the page selection.</para>
481
435
</para><variablelist role="params">
482
<varlistentry><term><parameter>widget</parameter> :</term>
436
<varlistentry><term><parameter>widget</parameter> :</term>
483
437
<listitem><simpara> the object which received the signal.
484
438
</simpara></listitem></varlistentry>
485
<varlistentry><term><parameter>user_data</parameter> :</term>
439
<varlistentry><term><parameter>user_data</parameter> :</term>
486
440
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
487
</variablelist><para>Since GIMP 2.4
488
</para></refsect2><refsect2 id="GimpPageSelector-selection-changed"><title>The <literal>"selection-changed"</literal> signal</title>
489
<indexterm zone="GimpPageSelector-selection-changed" role="GIMP 2.4"><primary>GimpPageSelector::selection-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpPageSelector">GimpPageSelector</link> *widget,
441
</variablelist><para>Since GIMP 2.4</para></refsect2><refsect2 id="GimpPageSelector-selection-changed" role="signal"><title>The <literal>"selection-changed"</literal> signal</title>
442
<indexterm zone="GimpPageSelector-selection-changed" role="GIMP 2.4"><primary sortas="GimpPageSelector::selection-changed">GimpPageSelector::selection-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="GimpPageSelector">GimpPageSelector</link> *widget,
490
443
<link linkend="gpointer">gpointer</link> user_data) : Run First</programlisting>
492
445
This signal is emitted whenever the set of selected pages changes.</para>
495
447
</para><variablelist role="params">
496
<varlistentry><term><parameter>widget</parameter> :</term>
448
<varlistentry><term><parameter>widget</parameter> :</term>
497
449
<listitem><simpara> the object which received the signal.
498
450
</simpara></listitem></varlistentry>
499
<varlistentry><term><parameter>user_data</parameter> :</term>
451
<varlistentry><term><parameter>user_data</parameter> :</term>
500
452
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
501
</variablelist><para>Since GIMP 2.4
453
</variablelist><para>Since GIMP 2.4</para></refsect2>