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

   1 <!-- ##### SECTION Title ##### -->
   2 GtkFileChooserButton
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 A button to launch a file selection dialog
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 The #GtkFileChooserButton is a widget that lets the user select a
  10 file.  It implements the #GtkFileChooser interface.  Visually, it is a
  11 file name with a button to bring up a #GtkFileChooserDialog.
  12 The user can then use that dialog to change the file associated with
  13 that button.  This widget does not support setting the "select-multiple"
  14 property to %TRUE.
  15 </para>
  16
  17 <example>
  18 <title>Create a button to let the user select a file in /etc</title>
  19 <programlisting>
  20 {
  21   GtkWidget *button;
  22
  23   button = gtk_file_chooser_button_new (_("Select a file"),
  24                                         GTK_FILE_CHOOSER_ACTION_OPEN);
  25   gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
  26                                        "/etc");
  27 }
  28 </programlisting>
  29 </example>
  30
  31 <para>
  32 The #GtkFileChooserButton supports the #GtkFileChooserAction<!--
  33 -->s %GTK_FILE_CHOOSER_ACTION_OPEN and %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
  34 </para>
  35
  36 <important>
  37 <para>
  38 The #GtkFileChooserButton will ellipsize the label,
  39 and thus will thus request little horizontal space.  To give the button
  40 more space, you should call gtk_widget_size_request(),
  41 gtk_file_chooser_button_set_width_chars(), or pack the button in
  42 such a way that other interface elements give space to the widget.
  43 </para>
  44 </important>
  45
  46 <!-- ##### SECTION See_Also ##### -->
  47 <para>
  48 #GtkFileChooserDialog
  49 </para>
  50
  51 <!-- ##### SECTION Stability_Level ##### -->
  52
  53
  54 <!-- ##### STRUCT GtkFileChooserButton ##### -->
  55 <para>
  56 This should not be accessed directly.  Use the accessor functions below.
  57 </para>
  58
  59
  60 <!-- ##### ARG GtkFileChooserButton:dialog ##### -->
  61 <para>
  62
  63 </para>
  64
  65 <!-- ##### ARG GtkFileChooserButton:title ##### -->
  66 <para>
  67
  68 </para>
  69
  70 <!-- ##### ARG GtkFileChooserButton:width-chars ##### -->
  71 <para>
  72
  73 </para>
  74
  75 <!-- ##### FUNCTION gtk_file_chooser_button_new ##### -->
  76 <para>
  77
  78 </para>
  79
  80 @title:
  81 @action:
  82 @Returns:
  83
  84
  85 <!-- ##### FUNCTION gtk_file_chooser_button_new_with_backend ##### -->
  86 <para>
  87
  88 </para>
  89
  90 @title:
  91 @action:
  92 @backend:
  93 @Returns:
  94
  95
  96 <!-- ##### FUNCTION gtk_file_chooser_button_new_with_dialog ##### -->
  97 <para>
  98
  99 </para>
 100
 101 @dialog:
 102 @Returns:
 103
 104
 105 <!-- ##### FUNCTION gtk_file_chooser_button_get_title ##### -->
 106 <para>
 107
 108 </para>
 109
 110 @button:
 111 @Returns:
 112
 113
 114 <!-- ##### FUNCTION gtk_file_chooser_button_set_title ##### -->
 115 <para>
 116
 117 </para>
 118
 119 @button:
 120 @title:
 121
 122
 123 <!-- ##### FUNCTION gtk_file_chooser_button_get_width_chars ##### -->
 124 <para>
 125
 126 </para>
 127
 128 @button:
 129 @Returns:
 130
 131
 132 <!-- ##### FUNCTION gtk_file_chooser_button_set_width_chars ##### -->
 133 <para>
 134
 135 </para>
 136
 137 @button:
 138 @n_chars:
 139
 140