<?xml version="1.0"?>
<page id="GimpUi.ProcedureDialog.get_file_chooser"
      type="topic"
      style="method"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="GimpUi.ProcedureDialog" group="method" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>Gtk.Widget</api:type>
      </api:returns>
      <api:name>gimp_procedure_dialog_get_file_chooser</api:name>
      <api:arg>
        <api:type>GimpUi.ProcedureDialog</api:type>
        <api:name>self</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>property</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gtk.FileChooserAction</api:type>
        <api:name>action</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>GimpUi.ProcedureDialog.get_file_chooser</title>
  <synopsis><code mime="text/x-python">
@accepts(GimpUi.ProcedureDialog, unicode, Gtk.FileChooserAction)
@returns(Gtk.Widget)
def get_file_chooser(self, property, action):
    # Python wrapper for gimp_procedure_dialog_get_file_chooser()
  </code></synopsis>
  <p>Creates a new %GtkFileChooserButton for <code>property</code> which must
necessarily be a config path or %GFile property.
This can be used instead of <link xref="GimpUi.ProcedureDialog.get_widget"/> in
particular if you want to create a button in non-open modes (i.e. to
save files, and select or create folders).</p>  <p>If a widget has already been created for this procedure, it will be
returned instead (whatever its actual widget type).</p>

<terms>
<item>
<title><code>self</code></title>
  <p>the associated <link xref="GimpUi.ProcedureDialog"/>.</p>
</item>
<item>
<title><code>property</code></title>
  <p>name of the %GimpParamConfigPath or %GParamObject of value
           type %GFile property to build a <link href="../Gtk-3.0/Gtk.FileChooserButton.html">Gtk.FileChooserButton</link> for.
           It must be a property of the <link href="../Gimp-3.0/Gimp.Procedure.html">Gimp.Procedure</link> <code>self</code> has
           been created for.</p>
</item>
<item>
<title><code>action</code></title>
  <p>The open mode for the widget.</p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
