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_set_current_folder (GTK_FILE_CHOOSER (button),
  25                                        "/etc");
  26 }
  27 </programlisting>
  28 </example>
  29
  30 <para>
  31 The #GtkFileChooserButton supports the #GtkFileChooserAction<!--
  32 -->s %GTK_FILE_CHOOSER_ACTION_OPEN and %GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
  33 </para>
  34
  35 <important>
  36 <para>
  37 The #GtkFileChooserButton will ellipsize the label,
  38 and thus will thus request little horizontal space.  To give the button
  39 more space, you should call gtk_widget_size_request(),
  40 gtk_file_chooser_button_set_width_chars(), or pack the button in
  41 such a way that other interface elements give space to the widget.
  42 </para>
  43 </important>
  44
  45 <!-- ##### SECTION See_Also ##### -->
  46 <para>
  47 #GtkFileChooserDialog
  48 </para>
  49
  50 <!-- ##### STRUCT GtkFileChooserButton ##### -->
  51 <para>
  52 This should not be accessed directly.  Use the accessor functions below.
  53 </para>
  54
  55
  56 <!-- ##### ARG GtkFileChooserButton:dialog ##### -->
  57 <para>
  58
  59 </para>
  60
  61 <!-- ##### ARG GtkFileChooserButton:title ##### -->
  62 <para>
  63
  64 </para>
  65
  66 <!-- ##### ARG GtkFileChooserButton:width-chars ##### -->
  67 <para>
  68
  69 </para>
  70
  71 <!-- ##### FUNCTION gtk_file_chooser_button_new ##### -->
  72 <para>
  73
  74 </para>
  75
  76 @title:
  77 @Returns:
  78
  79
  80 <!-- ##### FUNCTION gtk_file_chooser_button_new_with_backend ##### -->
  81 <para>
  82
  83 </para>
  84
  85 @title:
  86 @backend:
  87 @Returns:
  88
  89
  90 <!-- ##### FUNCTION gtk_file_chooser_button_new_with_dialog ##### -->
  91 <para>
  92
  93 </para>
  94
  95 @dialog:
  96 @Returns:
  97
  98
  99 <!-- ##### FUNCTION gtk_file_chooser_button_get_title ##### -->
 100 <para>
 101
 102 </para>
 103
 104 @button:
 105 @Returns:
 106
 107
 108 <!-- ##### FUNCTION gtk_file_chooser_button_set_title ##### -->
 109 <para>
 110
 111 </para>
 112
 113 @button:
 114 @title:
 115
 116
 117 <!-- ##### FUNCTION gtk_file_chooser_button_get_width_chars ##### -->
 118 <para>
 119
 120 </para>
 121
 122 @button:
 123 @Returns:
 124
 125
 126 <!-- ##### FUNCTION gtk_file_chooser_button_set_width_chars ##### -->
 127 <para>
 128
 129 </para>
 130
 131 @button:
 132 @n_chars:
 133
 134