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 <!-- ##### SIGNAL GtkFileChooser::current-folder-changed ##### -->
 487 <para>
 488
 489 </para>
 490
 491 @filechooser: the object which received the signal.
 492
 493 <!-- ##### SIGNAL GtkFileChooser::file-activated ##### -->
 494 <para>
 495
 496 </para>
 497
 498 @filechooser: the object which received the signal.
 499
 500 <!-- ##### SIGNAL GtkFileChooser::selection-changed ##### -->
 501 <para>
 502
 503 </para>
 504
 505 @filechooser: the object which received the signal.
 506
 507 <!-- ##### SIGNAL GtkFileChooser::update-preview ##### -->
 508 <para>
 509
 510 </para>
 511
 512 @filechooser: the object which received the signal.
 513
 514 <!-- ##### ARG GtkFileChooser:action ##### -->
 515 <para>
 516
 517 </para>
 518
 519 <!-- ##### ARG GtkFileChooser:do-overwrite-confirmation ##### -->
 520 <para>
 521
 522 </para>
 523
 524 <!-- ##### ARG GtkFileChooser:extra-widget ##### -->
 525 <para>
 526
 527 </para>
 528
 529 <!-- ##### ARG GtkFileChooser:file-system-backend ##### -->
 530 <para>
 531
 532 </para>
 533
 534 <!-- ##### ARG GtkFileChooser:filter ##### -->
 535 <para>
 536
 537 </para>
 538
 539 <!-- ##### ARG GtkFileChooser:local-only ##### -->
 540 <para>
 541
 542 </para>
 543
 544 <!-- ##### ARG GtkFileChooser:preview-widget ##### -->
 545 <para>
 546
 547 </para>
 548
 549 <!-- ##### ARG GtkFileChooser:preview-widget-active ##### -->
 550 <para>
 551
 552 </para>
 553
 554 <!-- ##### ARG GtkFileChooser:select-multiple ##### -->
 555 <para>
 556
 557 </para>
 558
 559 <!-- ##### ARG GtkFileChooser:show-hidden ##### -->
 560 <para>
 561
 562 </para>
 563
 564 <!-- ##### ARG GtkFileChooser:use-preview-label ##### -->
 565 <para>
 566
 567 </para>
 568
 569 <!-- ##### ENUM GtkFileChooserAction ##### -->
 570     <para>
 571       Describes whether a #GtkFileChooser is being used to open
 572       existing files or to save to a possibly new file.
 573     </para>
 574
 575 @GTK_FILE_CHOOSER_ACTION_OPEN: Indicates open mode.  The file chooser
 576     will only let the user pick an existing file.
 577 @GTK_FILE_CHOOSER_ACTION_SAVE: Indicates save mode.  The file chooser
 578     will let the user pick an existing file, or type in a new
 579     filename.
 580 @GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER: Indicates an Open mode for
 581     selecting folders.  The file chooser will let the user pick an
 582     existing folder.
 583 @GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER: Indicates a mode for creating a
 584     new folder.  The file chooser will let the user name an existing or
 585     new folder.
 586
 587 <!-- ##### ENUM GtkFileChooserConfirmation ##### -->
 588     <para>
 589       Used as a return value of handlers for the <link
 590       linkend="GtkFileChooser-confirm-overwrite">confirm-overwrite</link>
 591       signal of a <classname>GtkFileChooser</classname>.  This value
 592       determines whether the file chooser will present the stock
 593       confirmation dialog, accept the user's choice of a filename, or
 594       let the user choose another filename.
 595     </para>
 596
 597 @GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM: The file chooser will present
 598     its stock dialog to confirm about overwriting an existing file.
 599 @GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME: The file chooser will
 600     terminate and accept the user's choice of a file name.
 601 @GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN: The file chooser will
 602     continue running, so as to let the user select another file name.
 603
 604 <!-- ##### MACRO GTK_FILE_CHOOSER_ERROR ##### -->
 605     <para>
 606       Used to get the #GError quark for #GtkFileChooser errors.
 607     </para>
 608
 609
 610
 611 <!-- ##### ENUM GtkFileChooserError ##### -->
 612     <para>
 613       These identify the various errors that can occur while calling
 614       #GtkFileChooser functions.
 615     </para>
 616
 617 @GTK_FILE_CHOOSER_ERROR_NONEXISTENT: Indicates that a file does not exist.
 618 @GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
 619
 620 <!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
 621 <para>
 622
 623 </para>
 624
 625 @Returns:
 626
 627
 628 <!-- ##### FUNCTION gtk_file_chooser_set_action ##### -->
 629 <para>
 630
 631 </para>
 632
 633 @chooser:
 634 @action:
 635
 636
 637 <!-- ##### FUNCTION gtk_file_chooser_get_action ##### -->
 638 <para>
 639
 640 </para>
 641
 642 @chooser:
 643 @Returns:
 644
 645
 646 <!-- ##### FUNCTION gtk_file_chooser_set_local_only ##### -->
 647 <para>
 648
 649 </para>
 650
 651 @chooser:
 652 @local_only:
 653 <!-- # Unused Parameters # -->
 654 @files_only:
 655
 656
 657 <!-- ##### FUNCTION gtk_file_chooser_get_local_only ##### -->
 658 <para>
 659
 660 </para>
 661
 662 @chooser:
 663 @Returns:
 664
 665
 666 <!-- ##### FUNCTION gtk_file_chooser_set_select_multiple ##### -->
 667 <para>
 668
 669 </para>
 670
 671 @chooser:
 672 @select_multiple:
 673
 674
 675 <!-- ##### FUNCTION gtk_file_chooser_get_select_multiple ##### -->
 676 <para>
 677
 678 </para>
 679
 680 @chooser:
 681 @Returns:
 682
 683
 684 <!-- ##### FUNCTION gtk_file_chooser_set_show_hidden ##### -->
 685 <para>
 686
 687 </para>
 688
 689 @chooser:
 690 @show_hidden:
 691
 692
 693 <!-- ##### FUNCTION gtk_file_chooser_get_show_hidden ##### -->
 694 <para>
 695
 696 </para>
 697
 698 @chooser:
 699 @Returns:
 700
 701
 702 <!-- ##### FUNCTION gtk_file_chooser_set_do_overwrite_confirmation ##### -->
 703 <para>
 704
 705 </para>
 706
 707 @chooser:
 708 @do_overwrite_confirmation:
 709
 710
 711 <!-- ##### FUNCTION gtk_file_chooser_get_do_overwrite_confirmation ##### -->
 712 <para>
 713
 714 </para>
 715
 716 @chooser:
 717 @Returns:
 718
 719
 720 <!-- ##### FUNCTION gtk_file_chooser_set_current_name ##### -->
 721 <para>
 722
 723 </para>
 724
 725 @chooser:
 726 @name:
 727
 728
 729 <!-- ##### FUNCTION gtk_file_chooser_get_filename ##### -->
 730 <para>
 731
 732 </para>
 733
 734 @chooser:
 735 @Returns:
 736
 737
 738 <!-- ##### FUNCTION gtk_file_chooser_set_filename ##### -->
 739 <para>
 740
 741 </para>
 742
 743 @chooser:
 744 @filename:
 745 @Returns:
 746
 747
 748 <!-- ##### FUNCTION gtk_file_chooser_select_filename ##### -->
 749 <para>
 750
 751 </para>
 752
 753 @chooser:
 754 @filename:
 755 @Returns:
 756
 757
 758 <!-- ##### FUNCTION gtk_file_chooser_unselect_filename ##### -->
 759 <para>
 760
 761 </para>
 762
 763 @chooser:
 764 @filename:
 765
 766
 767 <!-- ##### FUNCTION gtk_file_chooser_select_all ##### -->
 768 <para>
 769
 770 </para>
 771
 772 @chooser:
 773
 774
 775 <!-- ##### FUNCTION gtk_file_chooser_unselect_all ##### -->
 776 <para>
 777
 778 </para>
 779
 780 @chooser:
 781
 782
 783 <!-- ##### FUNCTION gtk_file_chooser_get_filenames ##### -->
 784 <para>
 785
 786 </para>
 787
 788 @chooser:
 789 @Returns:
 790
 791
 792 <!-- ##### FUNCTION gtk_file_chooser_set_current_folder ##### -->
 793 <para>
 794
 795 </para>
 796
 797 @chooser:
 798 @filename:
 799 @Returns:
 800
 801
 802 <!-- ##### FUNCTION gtk_file_chooser_get_current_folder ##### -->
 803 <para>
 804
 805 </para>
 806
 807 @chooser:
 808 @Returns:
 809
 810
 811 <!-- ##### FUNCTION gtk_file_chooser_get_uri ##### -->
 812 <para>
 813
 814 </para>
 815
 816 @chooser:
 817 @Returns:
 818
 819
 820 <!-- ##### FUNCTION gtk_file_chooser_set_uri ##### -->
 821 <para>
 822
 823 </para>
 824
 825 @chooser:
 826 @uri:
 827 @Returns:
 828
 829
 830 <!-- ##### FUNCTION gtk_file_chooser_select_uri ##### -->
 831 <para>
 832
 833 </para>
 834
 835 @chooser:
 836 @uri:
 837 @Returns:
 838
 839
 840 <!-- ##### FUNCTION gtk_file_chooser_unselect_uri ##### -->
 841 <para>
 842
 843 </para>
 844
 845 @chooser:
 846 @uri:
 847
 848
 849 <!-- ##### FUNCTION gtk_file_chooser_get_uris ##### -->
 850 <para>
 851
 852 </para>
 853
 854 @chooser:
 855 @Returns:
 856
 857
 858 <!-- ##### FUNCTION gtk_file_chooser_set_current_folder_uri ##### -->
 859 <para>
 860
 861 </para>
 862
 863 @chooser:
 864 @uri:
 865 @Returns:
 866
 867
 868 <!-- ##### FUNCTION gtk_file_chooser_get_current_folder_uri ##### -->
 869 <para>
 870
 871 </para>
 872
 873 @chooser:
 874 @Returns:
 875
 876
 877 <!-- ##### FUNCTION gtk_file_chooser_set_preview_widget ##### -->
 878 <para>
 879
 880 </para>
 881
 882 @chooser:
 883 @preview_widget:
 884
 885
 886 <!-- ##### FUNCTION gtk_file_chooser_get_preview_widget ##### -->
 887 <para>
 888
 889 </para>
 890
 891 @chooser:
 892 @Returns:
 893
 894
 895 <!-- ##### FUNCTION gtk_file_chooser_set_preview_widget_active ##### -->
 896 <para>
 897
 898 </para>
 899
 900 @chooser:
 901 @active:
 902
 903
 904 <!-- ##### FUNCTION gtk_file_chooser_get_preview_widget_active ##### -->
 905 <para>
 906
 907 </para>
 908
 909 @chooser:
 910 @Returns:
 911
 912
 913 <!-- ##### FUNCTION gtk_file_chooser_set_use_preview_label ##### -->
 914 <para>
 915
 916 </para>
 917
 918 @chooser:
 919 @use_label:
 920
 921
 922 <!-- ##### FUNCTION gtk_file_chooser_get_use_preview_label ##### -->
 923 <para>
 924
 925 </para>
 926
 927 @chooser:
 928 @Returns:
 929
 930
 931 <!-- ##### FUNCTION gtk_file_chooser_get_preview_filename ##### -->
 932 <para>
 933
 934 </para>
 935
 936 @chooser:
 937 @Returns:
 938 <!-- # Unused Parameters # -->
 939 @file_chooser:
 940
 941
 942 <!-- ##### FUNCTION gtk_file_chooser_get_preview_uri ##### -->
 943 <para>
 944
 945 </para>
 946
 947 @chooser:
 948 @Returns:
 949 <!-- # Unused Parameters # -->
 950 @file_chooser:
 951
 952
 953 <!-- ##### FUNCTION gtk_file_chooser_set_extra_widget ##### -->
 954 <para>
 955
 956 </para>
 957
 958 @chooser:
 959 @extra_widget:
 960
 961
 962 <!-- ##### FUNCTION gtk_file_chooser_get_extra_widget ##### -->
 963 <para>
 964
 965 </para>
 966
 967 @chooser:
 968 @Returns:
 969
 970
 971 <!-- ##### FUNCTION gtk_file_chooser_add_filter ##### -->
 972 <para>
 973
 974 </para>
 975
 976 @chooser:
 977 @filter:
 978
 979
 980 <!-- ##### FUNCTION gtk_file_chooser_remove_filter ##### -->
 981 <para>
 982
 983 </para>
 984
 985 @chooser:
 986 @filter:
 987
 988
 989 <!-- ##### FUNCTION gtk_file_chooser_list_filters ##### -->
 990 <para>
 991
 992 </para>
 993
 994 @chooser:
 995 @Returns:
 996
 997
 998 <!-- ##### FUNCTION gtk_file_chooser_set_filter ##### -->
 999 <para>
1000
1001 </para>
1002
1003 @chooser:
1004 @filter:
1005
1006
1007 <!-- ##### FUNCTION gtk_file_chooser_get_filter ##### -->
1008 <para>
1009
1010 </para>
1011
1012 @chooser:
1013 @Returns:
1014
1015
1016 <!-- ##### FUNCTION gtk_file_chooser_add_shortcut_folder ##### -->
1017 <para>
1018
1019 </para>
1020
1021 @chooser:
1022 @folder:
1023 @error:
1024 @Returns:
1025
1026
1027 <!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder ##### -->
1028 <para>
1029
1030 </para>
1031
1032 @chooser:
1033 @folder:
1034 @error:
1035 @Returns:
1036
1037
1038 <!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folders ##### -->
1039 <para>
1040
1041 </para>
1042
1043 @chooser:
1044 @Returns:
1045
1046
1047 <!-- ##### FUNCTION gtk_file_chooser_add_shortcut_folder_uri ##### -->
1048 <para>
1049
1050 </para>
1051
1052 @chooser:
1053 @uri:
1054 @error:
1055 @Returns:
1056 <!-- # Unused Parameters # -->
1057 @folder:
1058
1059
1060 <!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder_uri ##### -->
1061 <para>
1062
1063 </para>
1064
1065 @chooser:
1066 @uri:
1067 @error:
1068 @Returns:
1069 <!-- # Unused Parameters # -->
1070 @folder:
1071
1072
1073 <!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folder_uris ##### -->
1074 <para>
1075
1076 </para>
1077
1078 @chooser:
1079 @Returns:
1080
1081
1082
1083 <!--
1084 Local variables:
1085 mode: sgml
1086 sgml-parent-document: ("../gtk-docs.sgml" "book" "refentry")
1087 End:
1088 -->
1089
1090