gtk-selections.html

最新gtk中文资料集

>GdkAtom</a> **targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *n_atoms);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-image">gtk_selection_data_targets_include_image</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-text">gtk_selection_data_targets_include_text</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-uri">gtk_selection_data_targets_include_uri</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a> *selection_data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-data-targets-include-rich-text">gtk_selection_data_targets_include_rich_text</a>
                                                        (<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a> *selection_data,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-image">gtk_targets_include_image</a>           (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> writable);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-text">gtk_targets_include_text</a>            (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-uri">gtk_targets_include_uri</a>             (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-targets-include-rich-text">gtk_targets_include_rich_text</a>       (<a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> n_targets,
                                                         <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer">GtkTextBuffer</a> *buffer);
void                <a class="link" href="gtk-Selections.html#gtk-selection-remove-all">gtk_selection_remove_all</a>            (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            <a class="link" href="gtk-Selections.html#gtk-selection-clear">gtk_selection_clear</a>                 (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventSelection"
>GdkEventSelection</a> *event);
<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a>*   <a class="link" href="gtk-Selections.html#gtk-selection-data-copy">gtk_selection_data_copy</a>             (<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a> *data);
void                <a class="link" href="gtk-Selections.html#gtk-selection-data-free">gtk_selection_data_free</a>             (<a class="link" href="GtkWidget.html#GtkSelectionData">GtkSelectionData</a> *data);


</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3316420"></a><h2>Description</h2>
<p>
The selection mechanism provides the basis for different types
of communication between processes. In particular, drag and drop and
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> work via selections. You will very seldom or
never need to use most of the functions in this section directly;
<a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> provides a nicer interface to the same functionality.
</p>
<p>
Some of the datatypes defined this section are used in
the <a class="link" href="gtk-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> and drag-and-drop API's as well. The
<a class="link" href="gtk-Selections.html#GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> structure and <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> objects represent
lists of data types that are supported when sending or
receiving data. The <a class="link" href="GtkWidget.html#GtkSelectionData"><span class="type">GtkSelectionData</span></a> object is used to
store a chunk of data along with the data type and other
associated information.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3316498"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3316508"></a><h3>
<a name="GtkTargetEntry"></a>GtkTargetEntry</h3>
<a class="indexterm" name="id3316520"></a><pre class="programlisting">typedef struct {
  gchar *target;
  guint  flags;
  guint  info;
} GtkTargetEntry;
</pre>
<p>
A <a class="link" href="gtk-Selections.html#GtkTargetEntry"><span class="type">GtkTargetEntry</span></a> structure represents a single type of
data than can be supplied for by a widget for a selection
or for supplied or received during drag-and-drop. It 
contains a string representing the drag type, a flags
field (used only for drag and drop - see <a class="link" href="gtk-Drag-and-Drop.html#GtkTargetFlags"><span class="type">GtkTargetFlags</span></a>),
and an application assigned integer ID. The integer
ID will later be passed as a signal parameter for signals
like "selection_get". It allows the application to identify
the target type without extensive string compares.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316561"></a><h3>
<a name="GtkTargetList"></a>GtkTargetList</h3>
<a class="indexterm" name="id3316573"></a><pre class="programlisting">typedef struct {
  GList *list;
  guint ref_count;
} GtkTargetList;
</pre>
<p>
A <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> structure is a reference counted list
of <a class="link" href="gtk-Selections.html#GtkTargetPair"><span class="type">GtkTargetPair</span></a>. It is used to represent the same
information as a table of <a class="link" href="gtk-Selections.html#GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>, but in
an efficient form. This structure should be treated as
opaque.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316613"></a><h3>
<a name="GtkTargetPair"></a>GtkTargetPair</h3>
<a class="indexterm" name="id3316623"></a><pre class="programlisting">typedef struct {
  GdkAtom   target;
  guint     flags;
  guint     info;
} GtkTargetPair;
</pre>
<p>
Internally used structure in the drag-and-drop and 
selection handling code.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316640"></a><h3>
<a name="gtk-target-list-new"></a>gtk_target_list_new ()</h3>
<a class="indexterm" name="id3316650"></a><pre class="programlisting"><a class="link" href="gtk-Selections.html#GtkTargetList">GtkTargetList</a>*      gtk_target_list_new                 (const <a class="link" href="gtk-Selections.html#GtkTargetEntry">GtkTargetEntry</a> *targets,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> ntargets);</pre>
<p>
Creates a new <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> from an array of <a class="link" href="gtk-Selections.html#GtkTargetEntry"><span class="type">GtkTargetEntry</span></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>targets</code></em>&#160;:</span></p></td>
<td> Pointer to an array of <a class="link" href="gtk-Selections.html#GtkTargetEntry"><span class="type">GtkTargetEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ntargets</code></em>&#160;:</span></p></td>
<td>  number of entries in <em class="parameter"><code>targets</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the new <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316753"></a><h3>
<a name="gtk-target-list-ref"></a>gtk_target_list_ref ()</h3>
<a class="indexterm" name="id3316763"></a><pre class="programlisting"><a class="link" href="gtk-Selections.html#GtkTargetList">GtkTargetList</a>*      gtk_target_list_ref                 (<a class="link" href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *list);</pre>
<p>
Increases the reference count of a <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> by one.</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>list</code></em>&#160;:</span></p></td>
<td>  a <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the passed in <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316836"></a><h3>
<a name="gtk-target-list-unref"></a>gtk_target_list_unref ()</h3>
<a class="indexterm" name="id3316847"></a><pre class="programlisting">void                gtk_target_list_unref               (<a class="link" href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *list);</pre>
<p>
Decreases the reference count of a <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> by one.
If the resulting reference count is zero, frees the list.</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>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316905"></a><h3>
<a name="gtk-target-list-add"></a>gtk_target_list_add ()</h3>
<a class="indexterm" name="id3316916"></a><pre class="programlisting">void                gtk_target_list_add                 (<a class="link" href="gtk-Selections.html#GtkTargetList">GtkTargetList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html#GdkAtom"
>GdkAtom</a> target,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> flags,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> info);</pre>
<p>
Appends another target to a <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></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>list</code></em>&#160;:</span></p></td>
<td>  a <a class="link" href="gtk-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>target</code></em>&#160;:</span></p></td>
<td> the interned atom representing the target
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em>&#160;:</span></p></td>
<td> the flags for this target
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>info</code></em>&#160;:</span></p></td>
<td> an ID that will be passed back to the application
</td>