~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkFileSelection.html#gtk-file-selection-new" title="gtk_file_selection_new ()">gtk_file_selection_new</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *title</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkFileSelection.html#gtk-file-selection-new" title="gtk_file_selection_new ()">gtk_file_selection_new</a> (<code>const gchar *title</code>);

#define <a class="link" href="GtkFileSelection.html#gtk-file-selection-set-filename" title="gtk_file_selection_set_filename">gtk_file_selection_set_filename</a>

#define <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-filename" title="gtk_file_selection_get_filename">gtk_file_selection_get_filename</a>

void <a class="link" href="GtkFileSelection.html#gtk-file-selection-complete" title="gtk_file_selection_complete ()">gtk_file_selection_complete</a> (<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *pattern</code>);

<code>const gchar *pattern</code>);

void <a class="link" href="GtkFileSelection.html#gtk-file-selection-show-fileop-buttons" title="gtk_file_selection_show_fileop_buttons ()">gtk_file_selection_show_fileop_buttons</a>

(<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>);

void <a class="link" href="GtkFileSelection.html#gtk-file-selection-hide-fileop-buttons" title="gtk_file_selection_hide_fileop_buttons ()">gtk_file_selection_hide_fileop_buttons</a>

#define <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-selections" title="gtk_file_selection_get_selections">gtk_file_selection_get_selections</a>

void <a class="link" href="GtkFileSelection.html#gtk-file-selection-set-select-multiple" title="gtk_file_selection_set_select_multiple ()">gtk_file_selection_set_select_multiple</a>

(<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> select_multiple</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-select-multiple" title="gtk_file_selection_get_select_multiple ()">gtk_file_selection_get_select_multiple</a>

<code>gboolean select_multiple</code>);

gboolean <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-select-multiple" title="gtk_file_selection_get_select_multiple ()">gtk_file_selection_get_select_multiple</a>

(<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>);

</pre>

</div>

<a name="GtkFileSelection.properties"></a><h2>Properties</h2>

"<a class="link" href="GtkFileSelection.html#GtkFileSelection--filename" title='The "filename" property'>filename</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write

"<a class="link" href="GtkFileSelection.html#GtkFileSelection--select-multiple" title='The "select-multiple" property'>select-multiple</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write

"<a class="link" href="GtkFileSelection.html#GtkFileSelection--show-fileops" title='The "show-fileops" property'>show-fileops</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write

"<a class="link" href="GtkFileSelection.html#GtkFileSelection--filename" title='The "filename" property'>filename</a>" gchar* : Read / Write

"<a class="link" href="GtkFileSelection.html#GtkFileSelection--select-multiple" title='The "select-multiple" property'>select-multiple</a>" gboolean : Read / Write

"<a class="link" href="GtkFileSelection.html#GtkFileSelection--show-fileops" title='The "show-fileops" property'>show-fileops</a>" gboolean : Read / Write

</pre>

</div>

123

124

125

126

<a name="id1258328"></a>Example 64. Getting a filename from the user.

126

<a name="id1389229"></a>Example 64. Getting a filename from the user.

127

128

129

<tbody>

160

GtkWidget *file_selector = GTK_WIDGET (user_data);

161

const gchar *selected_filename;

162

selected_filename = <a href="GtkFileSelection.html#gtk-file-selection-get-filename">gtk_file_selection_get_filename</a> (GTK_FILE_SELECTION (file_selector));

163

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a> ("Selected filename: %s\n", selected_filename);

163

g_print ("Selected filename: %s\n", selected_filename);

164

}

165

void create_file_selection (void) {

166

GtkWidget *file_selector;

277

278

</tr>

279

<tr>

280

<td><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *<code><a name="GtkFileSelection-struct.history-list"></a>history_list</code>;</td>

280

<td>GList *<code><a name="GtkFileSelection-struct.history-list"></a>history_list</code>;</td>

281

282

</tr>

283

<tr>

291

292

</tr>

293

<tr>

294

<td><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GtkFileSelection-struct.fileop-file"></a>fileop_file</code>;</td>

294

<td>gchar *<code><a name="GtkFileSelection-struct.fileop-file"></a>fileop_file</code>;</td>

295

296

</tr>

297

<tr>

298

<td><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> <code><a name="GtkFileSelection-struct.cmpl-state"></a>cmpl_state</code>;</td>

298

<td>gpointer <code><a name="GtkFileSelection-struct.cmpl-state"></a>cmpl_state</code>;</td>

299

300

</tr>

301

<tr>

327

<hr>

328

329

<a name="gtk-file-selection-new"></a><h3>gtk_file_selection_new ()</h3>

330

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_file_selection_new (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *title</code>);</pre>

330

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_file_selection_new (<code>const gchar *title</code>);</pre>

331

332

<h3 class="title">Warning</h3>

333

<code class="literal">gtk_file_selection_new</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkFileChooserDialog.html#gtk-file-chooser-dialog-new" title="gtk_file_chooser_dialog_new ()"><code class="function">gtk_file_chooser_dialog_new()</code></a> instead

373

374

375

The encoding of <code>filename</code> is preferred GLib file name encoding, which

376

may not be UTF-8. See <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-filename-from-utf8"><code class="function">g_filename_from_utf8()</code></a>.

376

may not be UTF-8. See <code class="function">g_filename_from_utf8()</code>.

377

378

379

403

</div>

404

405

This function returns the selected filename in the GLib file name

406

encoding. To convert to UTF-8, call <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a>. The

406

encoding. To convert to UTF-8, call <code class="function">g_filename_to_utf8()</code>. The

407

returned string points to a statically allocated buffer and should

408

be copied if you plan to keep it around.

409

425

426

<a name="gtk-file-selection-complete"></a><h3>gtk_file_selection_complete ()</h3>

427

<pre class="programlisting">void gtk_file_selection_complete (<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>,

428

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *pattern</code>);</pre>

428

<code>const gchar *pattern</code>);</pre>

429

430

<h3 class="title">Warning</h3>

431

<code class="literal">gtk_file_selection_complete</code> is deprecated and should not be used in newly-written code.

515

516

517

The filenames are in the GLib file name encoding. To convert to

518

UTF-8, call <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> on each string.

518

UTF-8, call <code class="function">g_filename_to_utf8()</code> on each string.

519

520

521

524

</colgroup>

525

526

<td>Returns :</td>

527

<td>a newly-allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. Use

528

<a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> to free it.</td>

527

<td>a newly-allocated <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array of strings. Use

528

<code class="function">g_strfreev()</code> to free it.</td>

529

</tr></tbody>

530

</table></div>

531

</div>

534

<a name="gtk-file-selection-set-select-multiple"></a><h3>gtk_file_selection_set_select_multiple ()</h3>

535

<pre class="programlisting">void gtk_file_selection_set_select_multiple

536

(<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>,

537

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> select_multiple</code>);</pre>

537

<code>gboolean select_multiple</code>);</pre>

538

539

<h3 class="title">Warning</h3>

540

<code class="literal">gtk_file_selection_set_select_multiple</code> is deprecated and should not be used in newly-written code.

565

<hr>

566

567

<a name="gtk-file-selection-get-select-multiple"></a><h3>gtk_file_selection_get_select_multiple ()</h3>

568

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_file_selection_get_select_multiple

568

<pre class="programlisting">gboolean gtk_file_selection_get_select_multiple

569

(<code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel</code>);</pre>

570

571

<h3 class="title">Warning</h3>

589

<tr>

590

<td>Returns :</td>

591

<td>

592

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the user is allowed to select multiple files in the

592

<code class="literal">TRUE</code> if the user is allowed to select multiple files in the

593

file list</td>

594

</tr>

595

</tbody>

600

<a name="GtkFileSelection.property-details"></a><h2>Property Details</h2>

601

602

<a name="GtkFileSelection--filename"></a><h3>The <code class="literal">"filename"</code> property</h3>

603

<pre class="programlisting"> "filename" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

603

<pre class="programlisting"> "filename" gchar* : Read / Write</pre>

604

The currently selected filename.

605

Default value: NULL

606

</div>

607

<hr>

608

609

<a name="GtkFileSelection--select-multiple"></a><h3>The <code class="literal">"select-multiple"</code> property</h3>

610

<pre class="programlisting"> "select-multiple" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

610

<pre class="programlisting"> "select-multiple" gboolean : Read / Write</pre>

611

Whether to allow multiple files to be selected.

612

Default value: FALSE

613

</div>

614

<hr>

615

616

<a name="GtkFileSelection--show-fileops"></a><h3>The <code class="literal">"show-fileops"</code> property</h3>

617

<pre class="programlisting"> "show-fileops" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

617

<pre class="programlisting"> "show-fileops" gboolean : Read / Write</pre>

618

Whether buttons for creating/manipulating files should be displayed.

619

Default value: TRUE

620

</div>

639

</div>

640

641

<hr>

642

Generated by GTK-Doc V1.18</div>

642

Generated by GTK-Doc V1.18.1</div>

643

</body>

644

</html>

b'\\ No newline at end of file'

Older »