gtk-gtkfilefilter.html

最新gtk中文资料集

<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>display_name</code></em>;</span></p></td>
<td>the string that will be used to display the file
  in the file chooser
</td>
</tr>
<tr>
<td><p><span class="term">const&#160;<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>&#160;*<em class="structfield"><code>mime_type</code></em>;</span></p></td>
<td>the mime type of the file

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4041682"></a><h3>
<a name="GtkFileFilterFlags"></a>enum GtkFileFilterFlags</h3>
<a class="indexterm" name="id4041696"></a><pre class="programlisting">typedef enum {
  GTK_FILE_FILTER_FILENAME     = 1 &lt;&lt; 0,
  GTK_FILE_FILTER_URI          = 1 &lt;&lt; 1,
  GTK_FILE_FILTER_DISPLAY_NAME = 1 &lt;&lt; 2,
  GTK_FILE_FILTER_MIME_TYPE    = 1 &lt;&lt; 3
} GtkFileFilterFlags;
</pre>
<p>
These flags indicate what parts of a <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilterInfo"><span class="type">GtkFileFilterInfo</span></a> struct
are filled or need to be filled. 
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GTK-FILE-FILTER-FILENAME:CAPS"></a><code class="literal">GTK_FILE_FILTER_FILENAME</code></span></p></td>
<td>the filename of the file being tested
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-FILE-FILTER-URI:CAPS"></a><code class="literal">GTK_FILE_FILTER_URI</code></span></p></td>
<td>the URI for the file being tested
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-FILE-FILTER-DISPLAY-NAME:CAPS"></a><code class="literal">GTK_FILE_FILTER_DISPLAY_NAME</code></span></p></td>
<td>the string that will be used to 
  display the file in the file chooser
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GTK-FILE-FILTER-MIME-TYPE:CAPS"></a><code class="literal">GTK_FILE_FILTER_MIME_TYPE</code></span></p></td>
<td>the mime type of the file

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4041823"></a><h3>
<a name="GtkFileFilterFunc"></a>GtkFileFilterFunc ()</h3>
<a class="indexterm" name="id4041837"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            (*GtkFileFilterFunc)                (const <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilterInfo">GtkFileFilterInfo</a> *filter_info,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
The type of function that is used with custom filters,
see <a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-add-custom"><code class="function">gtk_file_filter_add_custom()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filter_info</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilterInfo"><span class="type">GtkFileFilterInfo</span></a> that is filled according
  to the <em class="parameter"><code>needed</code></em> flags passed to <a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-add-custom"><code class="function">gtk_file_filter_add_custom()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>user data passed to <a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-add-custom"><code class="function">gtk_file_filter_add_custom()</code></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 file should be displayed


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4041973"></a><h3>
<a name="gtk-file-filter-new"></a>gtk_file_filter_new ()</h3>
<a class="indexterm" name="id4041988"></a><pre class="programlisting"><a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter">GtkFileFilter</a>*      gtk_file_filter_new                 (void);</pre>
<p>
Creates a new <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> with no rules added to it.
Such a filter doesn't accept any files, so is not
particularly useful until you add rules with
<a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-add-mime-type"><code class="function">gtk_file_filter_add_mime_type()</code></a>, <a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-add-pattern"><code class="function">gtk_file_filter_add_pattern()</code></a>,
or <a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-add-custom"><code class="function">gtk_file_filter_add_custom()</code></a>. To create a filter
that accepts any file, use:
</p>
<p>
</p>
<div class="informalexample"><pre class="programlisting">
GtkFileFilter *filter = gtk_file_filter_new ();
gtk_file_filter_add_pattern (filter, "*");
</pre></div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a new <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a>

</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4042101"></a><h3>
<a name="gtk-file-filter-set-name"></a>gtk_file_filter_set_name ()</h3>
<a class="indexterm" name="id4042115"></a><pre class="programlisting">void                gtk_file_filter_set_name            (<a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter">GtkFileFilter</a> *filter,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Sets the human-readable name of the filter; this is the string
that will be displayed in the file selector user interface if
there is a selectable list of filters.</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>filter</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></p></td>
<td> the human-readable-name for the filter, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
  to remove any existing name.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4042216"></a><h3>
<a name="gtk-file-filter-get-name"></a>gtk_file_filter_get_name ()</h3>
<a class="indexterm" name="id4042231"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_file_filter_get_name            (<a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter">GtkFileFilter</a> *filter);</pre>
<p>
Gets the human-readable name for the filter. See <a class="link" href="gtk-gtkfilefilter.html#gtk-file-filter-set-name"><code class="function">gtk_file_filter_set_name()</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>filter</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The human-readable name of the filter,
  or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>. This value is owned by GTK+ and must not
  be modified or freed.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4042331"></a><h3>
<a name="gtk-file-filter-add-mime-type"></a>gtk_file_filter_add_mime_type ()</h3>
<a class="indexterm" name="id4042347"></a><pre class="programlisting">void                gtk_file_filter_add_mime_type       (<a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter">GtkFileFilter</a> *filter,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *mime_type);</pre>
<p>
Adds a rule allowing a given mime type to <em class="parameter"><code>filter</code></em>.</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>filter</code></em>&#160;:</span></p></td>