Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkfilechooser.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkFileChooser
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 File chooser interface used by GtkFileChooserWidget and GtkFileChooserDialog
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8     <para>
   9       #GtkFileChooser is an interface that can be implemented by file
  10       selection widgets.  In GTK+, the main objects that implement this
  11       interface are #GtkFileChooserWidget, #GtkFileChooserDialog, and
  12       #GtkFileChooserButton.  You do not need to write an object that
  13       implements the #GtkFileChooser interface unless you are trying to
  14       adapt an existing file selector to expose a standard programming
  15       interface.
  16     </para>
  17
  18     <para>
  19       #GtkFileChooser allows for shortcuts to various places in the filesystem.
  20       In the default implementation these are displayed in the left pane. It
  21       may be a bit confusing at first taht these shortcuts come from various
  22       sources and in various flavours, so lets explain the terminology here:
  23     </para>
  24       <variablelist>
  25          <varlistentry>
  26            <term>Bookmarks</term>
  27            <listitem><para>
  28              are created by the user, by dragging folders from the
  29              right pane to the left pane, or by using the "Add". Bookmarks
  30              can be renamed and deleted by the user.
  31            </para></listitem>
  32          </varlistentry>
  33          <varlistentry>
  34            <term>Shortcuts</term>
  35            <listitem><para>
  36              can be provided by the application or by the underlying filesystem
  37              abstraction (e.g. both the gnome-vfs and the Windows filesystems
  38              provide "Desktop" shortcuts). Shortcuts cannot be modified by the
  39              user.
  40            </para></listitem>
  41          </varlistentry>
  42          <varlistentry>
  43            <term>Volumes</term>
  44            <listitem><para>
  45              are provided by the underlying filesystem abstraction. They are
  46              the "roots" of the filesystem.
  47            </para></listitem>
  48          </varlistentry>
  49       </variablelist>
  50
  51     <refsect2 id="gtkfilechooser-encodings">
  52       <title>File Names and Encodings</title>
  53
  54       <para>
  55         When the user is finished selecting files in a
  56         #GtkFileChooser, your program can get the selected names
  57         either as filenames or as URIs.  For URIs, the normal escaping
  58         rules are applied if the URI contains non-ASCII characters.
  59         However, filenames are <emphasis>always</emphasis> returned in
  60         the character set specified by the
  61         <envar>G_FILENAME_ENCODING</envar> environment variable.
  62         Please see the Glib documentation for more details about this
  63         variable.
  64       </para>
  65
  66       <important>
  67         <para>
  68           This means that while you can pass the result of
  69           gtk_file_chooser_get_filename() to
  70           <function>open(2)</function> or
  71           <function>fopen(3)</function>, you may not be able to
  72           directly set it as the text of a #GtkLabel widget unless you
  73           convert it first to UTF-8, which all GTK+ widgets expect.
  74           You should use g_filename_to_utf8() to convert filenames
  75           into strings that can be passed to GTK+ widgets.
  76         </para>
  77       </important>
  78     </refsect2>
  79
  80     <refsect2 id="gtkfilechooser-preview">
  81       <title>Adding a Preview Widget</title>
  82
  83       <para>
  84         You can add a custom preview widget to a file chooser and then
  85         get notification about when the preview needs to be updated.
  86         To install a preview widget, use
  87         gtk_file_chooser_set_preview_widget().  Then, connect to the
  88         #GtkFileChooser::update-preview signal to get notified when
  89         you need to update the contents of the preview.
  90       </para>
  91
  92       <para>
  93         Your callback should use
  94         gtk_file_chooser_get_preview_filename() to see what needs
  95         previewing.  Once you have generated the preview for the
  96         corresponding file, you must call
  97         gtk_file_chooser_set_preview_widget_active() with a boolean
  98         flag that indicates whether your callback could successfully
  99         generate a preview.
 100       </para>
 101
 102       <example id="example-gtkfilechooser-preview">
 103         <title>Sample Usage</title>
 104
 105         <programlisting>
 106 {
 107   GtkImage *preview;
 108
 109   ...
 110
 111   preview = gtk_image_new (<!-- -->);
 112
 113   gtk_file_chooser_set_preview_widget (my_file_chooser, preview);
 114   g_signal_connect (my_file_chooser, "update-preview",
 115                     G_CALLBACK (update_preview_cb), preview);
 116 }
 117
 118 static void
 119 update_preview_cb (GtkFileChooser *file_chooser, gpointer data)
 120 {
 121   GtkWidget *preview;
 122   char *filename;
 123   GdkPixbuf *pixbuf;
 124   gboolean have_preview;
 125
 126   preview = GTK_WIDGET (data);
 127   filename = gtk_file_chooser_get_preview_filename (file_chooser);
 128
 129   pixbuf = gdk_pixbuf_new_from_file_at_size (filename, 128, 128, NULL);
 130   have_preview = (pixbuf != NULL);
 131   g_free (filename);
 132
 133   gtk_image_set_from_pixbuf (GTK_IMAGE (preview), pixbuf);
 134   if (pixbuf)
 135     gdk_pixbuf_unref (pixbuf);
 136
 137   gtk_file_chooser_set_preview_widget_active (file_chooser, have_preview);
 138 }
 139         </programlisting>
 140       </example>
 141     </refsect2>
 142
 143     <refsect2 id="gtkfilechooser-extra">
 144       <title>Adding Extra Widgets</title>
 145
 146       <para>
 147         You can add extra widgets to a file chooser to provide options
 148         that are not present in the default design.  For example, you
 149         can add a toggle button to give the user the option to open a
 150         file in read-only mode.  You can use
 151         gtk_file_chooser_set_extra_widget() to insert additional
 152         widgets in a file chooser.
 153       </para>
 154
 155       <example id="example-gtkfilechooser-extra">
 156         <title>Sample Usage</title>
 157
 158         <programlisting>
 159 {
 160   GtkWidget *toggle;
 161
 162   ...
 163
 164   toggle = gtk_check_button_new_with_label ("Open file read-only");
 165   gtk_widget_show (toggle);
 166   gtk_file_chooser_set_extra_widget (my_file_chooser, toggle);
 167 }
 168         </programlisting>
 169       </example>
 170
 171       <note>
 172         <para>
 173           If you want to set more than one extra widget in the file
 174           chooser, you can a container such as a GtkVBox or a GtkTable
 175           and include your widgets in it.  Then, set the container as
 176           the whole extra widget.
 177         </para>
 178       </note>
 179     </refsect2>
 180
 181     <refsect2 id="gtkfilechooser-key-bindings">
 182       <title>Key Bindings</title>
 183
 184       <para>
 185         Internally, GTK+ implements a file chooser's graphical user
 186         interface with the private
 187         <classname>GtkFileChooserDefaultClass</classname>.  This
 188         widget has several <link linkend="gtk-Bindings">key
 189         bindings</link> and their associated signals.  This section
 190         describes the available key binding signals.
 191       </para>
 192
 193       <example id="gtkfilechooser-key-binding-example">
 194         <title>GtkFileChooser key binding example</title>
 195
 196         <para>
 197           The default keys that activate the key-binding signals in
 198           <classname>GtkFileChooserDefaultClass</classname> are as
 199           follows:
 200         </para>
 201
 202         <informaltable>
 203           <tgroup cols="2">
 204             <tbody>
 205               <row>
 206                 <entry>Signal name</entry>
 207                 <entry>Key</entry>
 208               </row>
 209               <row>
 210                 <entry>location-popup</entry>
 211                 <entry><keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo></entry>
 212               </row>
 213               <row>
 214                 <entry>up-folder</entry>
 215                 <entry><keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo></entry>
 216               </row>
 217               <row>
 218                 <entry>down-folder</entry>
 219                 <entry><keycombo><keycap>Alt</keycap><keycap>Down</keycap></keycombo></entry>
 220               </row>
 221               <row>
 222                 <entry>home-folder</entry>
 223                 <entry><keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></entry>
 224               </row>
 225             </tbody>
 226           </tgroup>
 227         </informaltable>
 228
 229         <para>
 230           To change these defaults to something else, you could
 231           include the following fragment in your
 232           <filename>.gtkrc-2.0</filename> file:
 233         </para>
 234
 235         <programlisting>
 236 binding "my-own-gtkfilechooser-bindings" {
 237         bind "&lt;Alt&gt;&lt;Shift&gt;l" {
 238                 "location-popup" ()
 239         }
 240         bind "&lt;Alt&gt;&lt;Shift&gt;Up" {
 241                 "up-folder" ()
 242         }
 243         bind "&lt;Alt&gt;&lt;Shift&gt;Down" {
 244                 "down-folder" ()
 245         }
 246         bind "&lt;Alt&gt;&lt;Shift&gt;Home" {
 247                 "home-folder-folder" ()
 248         }
 249 }
 250
 251 class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
 252         </programlisting>
 253       </example>
 254
 255       <refsect3 id="GtkFileChooserDefault-location-popup">
 256         <title>The &quot;GtkFileChooserDefault::location-popup&quot; signal</title>
 257
 258         <programlisting>
 259           void user_function (GtkFileChooserDefault *chooser,
 260                               <link linkend="gpointer">gpointer</link> user_data);
 261         </programlisting>
 262
 263         <para>
 264           This is used to make the file chooser show a "Location"
 265           dialog which the user can use to manually type the name of
 266           the file he wishes to select.  By default this is bound to
 267           <keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>.
 268         </para>
 269
 270         <variablelist role="params">
 271           <varlistentry>
 272             <term><parameter>chooser</parameter>&nbsp;:</term>
 273             <listitem>
 274               <simpara>
 275                 the object which received the signal.
 276               </simpara>
 277             </listitem>
 278           </varlistentry>
 279           <varlistentry>
 280             <term><parameter>user_data</parameter>&nbsp;:</term>
 281             <listitem>
 282               <simpara>
 283                 user data set when the signal handler was connected.
 284               </simpara>
 285             </listitem>
 286           </varlistentry>
 287         </variablelist>
 288       </refsect3>
 289
 290       <refsect3 id="GtkFileChooserDefault-up-folder">
 291         <title>The &quot;GtkFileChooserDefault::up-folder&quot; signal</title>
 292
 293         <programlisting>
 294           void user_function (GtkFileChooserDefault *chooser,
 295                               <link linkend="gpointer">gpointer</link> user_data);
 296         </programlisting>
 297
 298         <para>
 299           This is used to make the file chooser go to the parent of
 300           the current folder in the file hierarchy.  By default this
 301           is bound to
 302           <keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo>.
 303         </para>
 304
 305         <variablelist role="params">
 306           <varlistentry>
 307             <term><parameter>chooser</parameter>&nbsp;:</term>
 308             <listitem>
 309               <simpara>
 310                 the object which received the signal.
 311               </simpara>
 312             </listitem>
 313           </varlistentry>
 314           <varlistentry>
 315             <term><parameter>user_data</parameter>&nbsp;:</term>
 316             <listitem>
 317               <simpara>
 318                 user data set when the signal handler was connected.
 319               </simpara>
 320             </listitem>
 321           </varlistentry>
 322         </variablelist>
 323       </refsect3>
 324
 325       <refsect3 id="GtkFileChooserDefault-down-folder">
 326         <title>The &quot;GtkFileChooserDefault::down-folder&quot; signal</title>
 327
 328         <programlisting>
 329           void user_function (GtkFileChooserDefault *chooser,
 330                               <link linkend="gpointer">gpointer</link> user_data);
 331         </programlisting>
 332
 333         <para>
 334           This is used to make the file chooser go to a child of the
 335           current folder in the file hierarchy.  The subfolder that
 336           will be used is displayed in the path bar widget of the file
 337           chooser.  For example, if the path bar is showing
 338           "/foo/<emphasis>bar/</emphasis>baz", then this will cause
 339           the file chooser to switch to the "baz" subfolder.  By
 340           default this is bound to
 341           <keycombo><keycap>Alt</keycap><keycap>Down</keycap></keycombo>.
 342         </para>
 343
 344         <variablelist role="params">
 345           <varlistentry>
 346             <term><parameter>chooser</parameter>&nbsp;:</term>
 347             <listitem>
 348               <simpara>
 349                 the object which received the signal.
 350               </simpara>
 351             </listitem>
 352           </varlistentry>
 353           <varlistentry>
 354             <term><parameter>user_data</parameter>&nbsp;:</term>
 355             <listitem>
 356               <simpara>
 357                 user data set when the signal handler was connected.
 358               </simpara>
 359             </listitem>
 360           </varlistentry>
 361         </variablelist>
 362       </refsect3>
 363
 364       <refsect3 id="GtkFileChooserDefault-home-folder">
 365         <title>The &quot;GtkFileChooserDefault::home-folder&quot; signal</title>
 366
 367         <programlisting>
 368           void user_function (GtkFileChooserDefault *chooser,
 369                               <link linkend="gpointer">gpointer</link> user_data);
 370         </programlisting>
 371
 372         <para>
 373           This is used to make the file chooser show the user's home
 374           folder in the file list.  By default this is bound to
 375           <keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo>.
 376         </para>
 377
 378         <variablelist role="params">
 379           <varlistentry>
 380             <term><parameter>chooser</parameter>&nbsp;:</term>
 381             <listitem>
 382               <simpara>
 383                 the object which received the signal.
 384               </simpara>
 385             </listitem>
 386           </varlistentry>
 387           <varlistentry>
 388             <term><parameter>user_data</parameter>&nbsp;:</term>
 389             <listitem>
 390               <simpara>
 391                 user data set when the signal handler was connected.
 392               </simpara>
 393             </listitem>
 394           </varlistentry>
 395         </variablelist>
 396       </refsect3>
 397     </refsect2>
 398
 399 <!-- ##### SECTION See_Also ##### -->
 400     <para>
 401       #GtkFileChooserDialog, #GtkFileChooserWidget, #GtkFileChooserButton
 402     </para>
 403
 404 <!-- ##### SECTION Stability_Level ##### -->
 405
 406
 407 <!-- ##### STRUCT GtkFileChooser ##### -->
 408 <para>
 409
 410 </para>
 411
 412
 413 <!-- ##### SIGNAL GtkFileChooser::confirm-overwrite ##### -->
 414     <para>
 415       This signal gets emitted whenever it is appropriate to present a
 416       confirmation dialog when the user has selected a file name that
 417       already exists.  The signal only gets emitted when the file
 418       chooser is in #GTK_FILE_CHOOSER_ACTION_SAVE mode.
 419     </para>
 420
 421     <para>
 422       Most applications just need to turn on the <link
 423       linkend="GtkFileChooser--do-overwrite-confirmation">do-overwrite-confirmation</link>
 424       property (or call the
 425       gtk_file_chooser_set_do_overwrite_confirmation() function), and
 426       they will automatically get a stock confirmation dialog.
 427       Applications which need to customize this behavior should do
 428       that, and also connect to the <symbol>confirm-overwrite</symbol>
 429       signal.
 430     </para>
 431
 432     <para>
 433       A signal handler for this signal must return a
 434       #GtkFileChooserConfirmation value, which indicates the action to
 435       take.  If the handler determines that the user wants to select a
 436       different filename, it should return
 437       #GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN.  If it determines
 438       that the user is satisfied with his choice of file name, it
 439       should return #GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME.
 440       On the other hand, if it determines that the stock confirmation
 441       dialog should be used, it should return
 442       #GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM.  The following example
 443       illustrates this.
 444     </para>
 445
 446     <example id="gtkfilechooser-confirmation">
 447       <title>Custom confirmation</title>
 448
 449       <programlisting>
 450 static GtkFileChooserConfirmation
 451 confirm_overwrite_callback (GtkFileChooser *chooser, gpointer data)
 452 {
 453   char *uri;
 454
 455   uri = gtk_file_chooser_get_uri (chooser);
 456
 457   if (is_uri_read_only (uri))
 458     {
 459       if (user_wants_to_replace_read_only_file (uri))
 460         return GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME;
 461       else
 462         return GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN;
 463     } else
 464       return GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM; /* fall back to the default dialog */
 465 }
 466
 467 ...
 468
 469 chooser = gtk_file_chooser_dialog_new (...);
 470
 471 gtk_file_chooser_set_do_overwrite_confirmation (GTK_FILE_CHOOSER (dialog), TRUE);
 472 g_signal_connect (chooser, "confirm-overwrite",
 473                   G_CALLBACK (confirm_overwrite_callback), NULL);
 474
 475 if (gtk_dialog_run (chooser) == GTK_RESPONSE_ACCEPT)
 476         save_to_file (gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (chooser));
 477
 478 gtk_widget_destroy (chooser);
 479       </programlisting>
 480     </example>
 481
 482 @filechooser: the object which received the signal.
 483 @Returns: #GtkFileChooserConfirmation value that indicates which
 484     action to take after emitting the signal.
 485
 486     <para>
 487       Since 2.8
 488     </para>
 489
 490 <!-- ##### SIGNAL GtkFileChooser::current-folder-changed ##### -->
 491 <para>
 492
 493 </para>
 494
 495 @filechooser: the object which received the signal.
 496
 497 <!-- ##### SIGNAL GtkFileChooser::file-activated ##### -->
 498 <para>
 499
 500 </para>
 501
 502 @filechooser: the object which received the signal.
 503
 504 <!-- ##### SIGNAL GtkFileChooser::selection-changed ##### -->
 505 <para>
 506
 507 </para>
 508
 509 @filechooser: the object which received the signal.
 510
 511 <!-- ##### SIGNAL GtkFileChooser::update-preview ##### -->
 512 <para>
 513
 514 </para>
 515
 516 @filechooser: the object which received the signal.
 517
 518 <!-- ##### ARG GtkFileChooser:action ##### -->
 519 <para>
 520
 521 </para>
 522
 523 <!-- ##### ARG GtkFileChooser:do-overwrite-confirmation ##### -->
 524 <para>
 525
 526 </para>
 527
 528 <!-- ##### ARG GtkFileChooser:extra-widget ##### -->
 529 <para>
 530
 531 </para>
 532
 533 <!-- ##### ARG GtkFileChooser:file-system-backend ##### -->
 534 <para>
 535
 536 </para>
 537
 538 <!-- ##### ARG GtkFileChooser:filter ##### -->
 539 <para>
 540
 541 </para>
 542
 543 <!-- ##### ARG GtkFileChooser:local-only ##### -->
 544 <para>
 545
 546 </para>
 547
 548 <!-- ##### ARG GtkFileChooser:preview-widget ##### -->
 549 <para>
 550
 551 </para>
 552
 553 <!-- ##### ARG GtkFileChooser:preview-widget-active ##### -->
 554 <para>
 555
 556 </para>
 557
 558 <!-- ##### ARG GtkFileChooser:select-multiple ##### -->
 559 <para>
 560
 561 </para>
 562
 563 <!-- ##### ARG GtkFileChooser:show-hidden ##### -->
 564 <para>
 565
 566 </para>
 567
 568 <!-- ##### ARG GtkFileChooser:use-preview-label ##### -->
 569 <para>
 570
 571 </para>
 572
 573 <!-- ##### ENUM GtkFileChooserAction ##### -->
 574     <para>
 575       Describes whether a #GtkFileChooser is being used to open
 576       existing files or to save to a possibly new file.
 577     </para>
 578
 579 @GTK_FILE_CHOOSER_ACTION_OPEN: Indicates open mode.  The file chooser
 580     will only let the user pick an existing file.
 581 @GTK_FILE_CHOOSER_ACTION_SAVE: Indicates save mode.  The file chooser
 582     will let the user pick an existing file, or type in a new
 583     filename.
 584 @GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER: Indicates an Open mode for
 585     selecting folders.  The file chooser will let the user pick an
 586     existing folder.
 587 @GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER: Indicates a mode for creating a
 588     new folder.  The file chooser will let the user name an existing or
 589     new folder.
 590
 591 <!-- ##### ENUM GtkFileChooserConfirmation ##### -->
 592     <para>
 593       Used as a return value of handlers for the <link
 594       linkend="GtkFileChooser-confirm-overwrite">confirm-overwrite</link>
 595       signal of a <classname>GtkFileChooser</classname>.  This value
 596       determines whether the file chooser will present the stock
 597       confirmation dialog, accept the user's choice of a filename, or
 598       let the user choose another filename.
 599     </para>
 600
 601 @GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM: The file chooser will present
 602     its stock dialog to confirm about overwriting an existing file.
 603 @GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME: The file chooser will
 604     terminate and accept the user's choice of a file name.
 605 @GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN: The file chooser will
 606     continue running, so as to let the user select another file name.
 607
 608     <para>
 609       Since 2.8
 610     </para>
 611
 612 <!-- ##### MACRO GTK_FILE_CHOOSER_ERROR ##### -->
 613     <para>
 614       Used to get the #GError quark for #GtkFileChooser errors.
 615     </para>
 616
 617
 618
 619 <!-- ##### ENUM GtkFileChooserError ##### -->
 620     <para>
 621       These identify the various errors that can occur while calling
 622       #GtkFileChooser functions.
 623     </para>
 624
 625 @GTK_FILE_CHOOSER_ERROR_NONEXISTENT: Indicates that a file does not exist.
 626 @GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
 627
 628 <!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
 629 <para>
 630
 631 </para>
 632
 633 @Returns:
 634
 635
 636 <!-- ##### FUNCTION gtk_file_chooser_set_action ##### -->
 637 <para>
 638
 639 </para>
 640
 641 @chooser:
 642 @action:
 643
 644
 645 <!-- ##### FUNCTION gtk_file_chooser_get_action ##### -->
 646 <para>
 647
 648 </para>
 649
 650 @chooser:
 651 @Returns:
 652
 653
 654 <!-- ##### FUNCTION gtk_file_chooser_set_local_only ##### -->
 655 <para>
 656
 657 </para>
 658
 659 @chooser:
 660 @local_only:
 661 <!-- # Unused Parameters # -->
 662 @files_only:
 663
 664
 665 <!-- ##### FUNCTION gtk_file_chooser_get_local_only ##### -->
 666 <para>
 667
 668 </para>
 669
 670 @chooser:
 671 @Returns:
 672
 673
 674 <!-- ##### FUNCTION gtk_file_chooser_set_select_multiple ##### -->
 675 <para>
 676
 677 </para>
 678
 679 @chooser:
 680 @select_multiple:
 681
 682
 683 <!-- ##### FUNCTION gtk_file_chooser_get_select_multiple ##### -->
 684 <para>
 685
 686 </para>
 687
 688 @chooser:
 689 @Returns:
 690
 691
 692 <!-- ##### FUNCTION gtk_file_chooser_set_show_hidden ##### -->
 693 <para>
 694
 695 </para>
 696
 697 @chooser:
 698 @show_hidden:
 699
 700
 701 <!-- ##### FUNCTION gtk_file_chooser_get_show_hidden ##### -->
 702 <para>
 703
 704 </para>
 705
 706 @chooser:
 707 @Returns:
 708
 709
 710 <!-- ##### FUNCTION gtk_file_chooser_set_do_overwrite_confirmation ##### -->
 711 <para>
 712
 713 </para>
 714
 715 @chooser:
 716 @do_overwrite_confirmation:
 717
 718
 719 <!-- ##### FUNCTION gtk_file_chooser_get_do_overwrite_confirmation ##### -->
 720 <para>
 721
 722 </para>
 723
 724 @chooser:
 725 @Returns:
 726
 727
 728 <!-- ##### FUNCTION gtk_file_chooser_set_current_name ##### -->
 729 <para>
 730
 731 </para>
 732
 733 @chooser:
 734 @name:
 735
 736
 737 <!-- ##### FUNCTION gtk_file_chooser_get_filename ##### -->
 738 <para>
 739
 740 </para>
 741
 742 @chooser:
 743 @Returns:
 744
 745
 746 <!-- ##### FUNCTION gtk_file_chooser_set_filename ##### -->
 747 <para>
 748
 749 </para>
 750
 751 @chooser:
 752 @filename:
 753 @Returns:
 754
 755
 756 <!-- ##### FUNCTION gtk_file_chooser_select_filename ##### -->
 757 <para>
 758
 759 </para>
 760
 761 @chooser:
 762 @filename:
 763 @Returns:
 764
 765
 766 <!-- ##### FUNCTION gtk_file_chooser_unselect_filename ##### -->
 767 <para>
 768
 769 </para>
 770
 771 @chooser:
 772 @filename:
 773
 774
 775 <!-- ##### FUNCTION gtk_file_chooser_select_all ##### -->
 776 <para>
 777
 778 </para>
 779
 780 @chooser:
 781
 782
 783 <!-- ##### FUNCTION gtk_file_chooser_unselect_all ##### -->
 784 <para>
 785
 786 </para>
 787
 788 @chooser:
 789
 790
 791 <!-- ##### FUNCTION gtk_file_chooser_get_filenames ##### -->
 792 <para>
 793
 794 </para>
 795
 796 @chooser:
 797 @Returns:
 798
 799
 800 <!-- ##### FUNCTION gtk_file_chooser_set_current_folder ##### -->
 801 <para>
 802
 803 </para>
 804
 805 @chooser:
 806 @filename:
 807 @Returns:
 808
 809
 810 <!-- ##### FUNCTION gtk_file_chooser_get_current_folder ##### -->
 811 <para>
 812
 813 </para>
 814
 815 @chooser:
 816 @Returns:
 817
 818
 819 <!-- ##### FUNCTION gtk_file_chooser_get_uri ##### -->
 820 <para>
 821
 822 </para>
 823
 824 @chooser:
 825 @Returns:
 826
 827
 828 <!-- ##### FUNCTION gtk_file_chooser_set_uri ##### -->
 829 <para>
 830
 831 </para>
 832
 833 @chooser:
 834 @uri:
 835 @Returns:
 836
 837
 838 <!-- ##### FUNCTION gtk_file_chooser_select_uri ##### -->
 839 <para>
 840
 841 </para>
 842
 843 @chooser:
 844 @uri:
 845 @Returns:
 846
 847
 848 <!-- ##### FUNCTION gtk_file_chooser_unselect_uri ##### -->
 849 <para>
 850
 851 </para>
 852
 853 @chooser:
 854 @uri:
 855
 856
 857 <!-- ##### FUNCTION gtk_file_chooser_get_uris ##### -->
 858 <para>
 859
 860 </para>
 861
 862 @chooser:
 863 @Returns:
 864
 865
 866 <!-- ##### FUNCTION gtk_file_chooser_set_current_folder_uri ##### -->
 867 <para>
 868
 869 </para>
 870
 871 @chooser:
 872 @uri:
 873 @Returns:
 874
 875
 876 <!-- ##### FUNCTION gtk_file_chooser_get_current_folder_uri ##### -->
 877 <para>
 878
 879 </para>
 880
 881 @chooser:
 882 @Returns:
 883
 884
 885 <!-- ##### FUNCTION gtk_file_chooser_set_preview_widget ##### -->
 886 <para>
 887
 888 </para>
 889
 890 @chooser:
 891 @preview_widget:
 892
 893
 894 <!-- ##### FUNCTION gtk_file_chooser_get_preview_widget ##### -->
 895 <para>
 896
 897 </para>
 898
 899 @chooser:
 900 @Returns:
 901
 902
 903 <!-- ##### FUNCTION gtk_file_chooser_set_preview_widget_active ##### -->
 904 <para>
 905
 906 </para>
 907
 908 @chooser:
 909 @active:
 910
 911
 912 <!-- ##### FUNCTION gtk_file_chooser_get_preview_widget_active ##### -->
 913 <para>
 914
 915 </para>
 916
 917 @chooser:
 918 @Returns:
 919
 920
 921 <!-- ##### FUNCTION gtk_file_chooser_set_use_preview_label ##### -->
 922 <para>
 923
 924 </para>
 925
 926 @chooser:
 927 @use_label:
 928
 929
 930 <!-- ##### FUNCTION gtk_file_chooser_get_use_preview_label ##### -->
 931 <para>
 932
 933 </para>
 934
 935 @chooser:
 936 @Returns:
 937
 938
 939 <!-- ##### FUNCTION gtk_file_chooser_get_preview_filename ##### -->
 940 <para>
 941
 942 </para>
 943
 944 @chooser:
 945 @Returns:
 946 <!-- # Unused Parameters # -->
 947 @file_chooser:
 948
 949
 950 <!-- ##### FUNCTION gtk_file_chooser_get_preview_uri ##### -->
 951 <para>
 952
 953 </para>
 954
 955 @chooser:
 956 @Returns:
 957 <!-- # Unused Parameters # -->
 958 @file_chooser:
 959
 960
 961 <!-- ##### FUNCTION gtk_file_chooser_set_extra_widget ##### -->
 962 <para>
 963
 964 </para>
 965
 966 @chooser:
 967 @extra_widget:
 968
 969
 970 <!-- ##### FUNCTION gtk_file_chooser_get_extra_widget ##### -->
 971 <para>
 972
 973 </para>
 974
 975 @chooser:
 976 @Returns:
 977
 978
 979 <!-- ##### FUNCTION gtk_file_chooser_add_filter ##### -->
 980 <para>
 981
 982 </para>
 983
 984 @chooser:
 985 @filter:
 986
 987
 988 <!-- ##### FUNCTION gtk_file_chooser_remove_filter ##### -->
 989 <para>
 990
 991 </para>
 992
 993 @chooser:
 994 @filter:
 995
 996
 997 <!-- ##### FUNCTION gtk_file_chooser_list_filters ##### -->
 998 <para>
 999
1000 </para>
1001
1002 @chooser:
1003 @Returns:
1004
1005
1006 <!-- ##### FUNCTION gtk_file_chooser_set_filter ##### -->
1007 <para>
1008
1009 </para>
1010
1011 @chooser:
1012 @filter:
1013
1014
1015 <!-- ##### FUNCTION gtk_file_chooser_get_filter ##### -->
1016 <para>
1017
1018 </para>
1019
1020 @chooser:
1021 @Returns:
1022
1023
1024 <!-- ##### FUNCTION gtk_file_chooser_add_shortcut_folder ##### -->
1025 <para>
1026
1027 </para>
1028
1029 @chooser:
1030 @folder:
1031 @error:
1032 @Returns:
1033
1034
1035 <!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder ##### -->
1036 <para>
1037
1038 </para>
1039
1040 @chooser:
1041 @folder:
1042 @error:
1043 @Returns:
1044
1045
1046 <!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folders ##### -->
1047 <para>
1048
1049 </para>
1050
1051 @chooser:
1052 @Returns:
1053
1054
1055 <!-- ##### FUNCTION gtk_file_chooser_add_shortcut_folder_uri ##### -->
1056 <para>
1057
1058 </para>
1059
1060 @chooser:
1061 @uri:
1062 @error:
1063 @Returns:
1064 <!-- # Unused Parameters # -->
1065 @folder:
1066
1067
1068 <!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder_uri ##### -->
1069 <para>
1070
1071 </para>
1072
1073 @chooser:
1074 @uri:
1075 @error:
1076 @Returns:
1077 <!-- # Unused Parameters # -->
1078 @folder:
1079
1080
1081 <!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folder_uris ##### -->
1082 <para>
1083
1084 </para>
1085
1086 @chooser:
1087 @Returns:
1088
1089
1090
1091 <!--
1092 Local variables:
1093 mode: sgml
1094 sgml-parent-document: ("../gtk-docs.sgml" "book" "refentry")
1095 End:
1096 -->
1097
1098