gtkfileselection.html

最新gtk中文资料集

</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4533405"></a><h3>
<a name="gtk-file-selection-complete"></a>gtk_file_selection_complete ()</h3>
<a class="indexterm" name="id4533421"></a><pre class="programlisting">void                gtk_file_selection_complete         (<a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *pattern);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_file_selection_complete</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Will attempt to match <em class="parameter"><code>pattern</code></em> to a valid filenames or subdirectories in the current directory. If a match can be made, the matched filename will appear in the text entry field of the file selection dialog.
If a partial match can be made, the "Files" list will contain those
file names which have been partially matched, and the "Folders"
list those directories which have been partially matched.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filesel</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pattern</code></em>&#160;:</span></p></td>
<td>a string of characters which may or may not match any filenames in the current directory.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4533524"></a><h3>
<a name="gtk-file-selection-show-fileop-buttons"></a>gtk_file_selection_show_fileop_buttons ()</h3>
<a class="indexterm" name="id4533540"></a><pre class="programlisting">void                gtk_file_selection_show_fileop_buttons
                                                        (<a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_file_selection_show_fileop_buttons</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Shows the file operation buttons, if they have previously been hidden. The rest of the widgets in the dialog will be resized accordingly.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>filesel</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4533611"></a><h3>
<a name="gtk-file-selection-hide-fileop-buttons"></a>gtk_file_selection_hide_fileop_buttons ()</h3>
<a class="indexterm" name="id4533628"></a><pre class="programlisting">void                gtk_file_selection_hide_fileop_buttons
                                                        (<a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_file_selection_hide_fileop_buttons</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Hides the file operation buttons that normally appear at the top of the dialog. Useful if you wish to create a custom file selector, based on <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>filesel</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4533707"></a><h3>
<a name="gtk-file-selection-get-selections"></a>gtk_file_selection_get_selections ()</h3>
<a class="indexterm" name="id4533724"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>**             gtk_file_selection_get_selections   (<a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_file_selection_get_selections</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Retrieves the list of file selections the user has made in the dialog box.
This function is intended for use when the user can select multiple files
in the file list. 
</p>
<p>
The filenames are in the GLib file name encoding. To convert to
UTF-8, call <a
href="/usr/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html#g-filename-to-utf8"
><code class="function">g_filename_to_utf8()</code></a> on each string.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filesel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly-allocated <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>-terminated array of strings. Use
<a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"
><code class="function">g_strfreev()</code></a> to free it.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4533845"></a><h3>
<a name="gtk-file-selection-set-select-multiple"></a>gtk_file_selection_set_select_multiple ()</h3>
<a class="indexterm" name="id4533861"></a><pre class="programlisting">void                gtk_file_selection_set_select_multiple
                                                        (<a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> select_multiple);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_file_selection_set_select_multiple</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets whether the user is allowed to select multiple files in the file list.
Use <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-selections"><code class="function">gtk_file_selection_get_selections()</code></a> to get the list of selected files.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filesel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>select_multiple</code></em>&#160;:</span></p></td>
<td> whether or not the user is allowed to select multiple
files in the file list.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4533970"></a><h3>
<a name="gtk-file-selection-get-select-multiple"></a>gtk_file_selection_get_select_multiple ()</h3>
<a class="indexterm" name="id4533986"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_file_selection_get_select_multiple
                                                        (<a class="link" href="GtkFileSelection.html" title="GtkFileSelection">GtkFileSelection</a> *filesel);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_file_selection_get_select_multiple</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Determines whether or not the user is allowed to select multiple files in
the file list. See <a class="link" href="GtkFileSelection.html#gtk-file-selection-set-select-multiple"><code class="function">gtk_file_selection_set_select_multiple()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filesel</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the user is allowed to select multiple files in the
file list
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4534094"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id4534105"></a><h3>
<a name="GtkFileSelection--filename"></a>The <code class="literal">"filename"</code> property</h3>
<a class="indexterm" name="id4534121"></a><pre class="programlisting">  "filename"                 <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>The currently selected filename.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4534148"></a><h3>
<a name="GtkFileSelection--select-multiple"></a>The <code class="literal">"select-multiple"</code> property</h3>
<a class="indexterm" name="id4534165"></a><pre class="programlisting">  "select-multiple"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>Whether to allow multiple files to be selected.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4534192"></a><h3>
<a name="GtkFileSelection--show-fileops"></a>The <code class="literal">"show-fileops"</code> property</h3>
<a class="indexterm" name="id4534208"></a><pre class="programlisting">  "show-fileops"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>Whether buttons for creating/manipulating files should be displayed.</p>
<p>Default value: FALSE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4534237"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a></span></p></td>
<td><p>Add your own widgets into the <a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a>.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id4534275"></a><div class="refsect2" lang="en"><a name="id4534276"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id4534277"></a></div>
</div>
</div>
</body>
</html>