Selections
<!-- ##### SECTION Short_Description ##### -->
-Functions for handling inter-process communication via selections.
+Functions for handling inter-process communication via selections
<!-- ##### SECTION Long_Description ##### -->
<para>
The selection mechanism provides the basis for different types
-of IPC between processes. In particular, drag and drop and
+of communication between processes. In particular, drag and drop and
#GtkClipboard work via selections. You will very seldom or
never need to use most of the functions in this section directly;
#GtkClipboard provides a nicer interface to the same functionality.
</para>
+<!-- ##### SECTION Stability_Level ##### -->
+
+
<!-- ##### STRUCT GtkTargetEntry ##### -->
<para>
A #GtkTargetEntry structure represents a single type of
<!-- ##### FUNCTION gtk_target_list_new ##### -->
<para>
-Create a new #GtkTargetList from an array of #GtkTargetEntry.
</para>
-@targets: Pointer to an array of #GtkTargetEntry
-@ntargets: number of entries in @targets.
-@Returns: the new #GtkTargetList.
+@targets:
+@ntargets:
+@Returns:
<!-- ##### FUNCTION gtk_target_list_ref ##### -->
<para>
-Increase the reference count of a #GtkTargetList by one.
</para>
-@list: a #GtkTargetList
+@list:
+@Returns:
<!-- ##### FUNCTION gtk_target_list_unref ##### -->
<para>
-Decrease the reference count of a #GtkTargetList by one.
-If the resulting reference count is zero, free the list.
</para>
-@list: a #GtkTargetList
+@list:
<!-- ##### FUNCTION gtk_target_list_add ##### -->
<para>
-Add another target to a #GtkTargetList
</para>
-@list: a #GtkTargetList
-@target: the interned atom representing the target
-@flags: the flags for this target
-@info: an ID that will be passed back to the application
+@list:
+@target:
+@flags:
+@info:
<!-- ##### FUNCTION gtk_target_list_add_table ##### -->
<para>
-Add a table of #GtkTargetEntry into a target list
</para>
-@list: a #GtkTargetList
-@targets: the table of #GtkTargetEntry
-@ntargets: number of targets in the table
+@list:
+@targets:
+@ntargets:
+
+
+<!-- ##### FUNCTION gtk_target_list_add_text_targets ##### -->
+<para>
+
+</para>
+
+@list:
+@info:
+
+
+<!-- ##### FUNCTION gtk_target_list_add_image_targets ##### -->
+<para>
+
+</para>
+
+@list:
+@info:
+@writable:
+
+
+<!-- ##### FUNCTION gtk_target_list_add_uri_targets ##### -->
+<para>
+
+</para>
+
+@list:
+@info:
+
+
+<!-- ##### FUNCTION gtk_target_list_add_rich_text_targets ##### -->
+<para>
+
+</para>
+
+@list:
+@info:
+@deserializable:
+@buffer:
<!-- ##### FUNCTION gtk_target_list_remove ##### -->
<para>
-Remove a target from a target list
</para>
-@list: a #GtkTargetList
-@target: the interned atom representing the target
+@list:
+@target:
<!-- ##### FUNCTION gtk_target_list_find ##### -->
<para>
-Look up a given target in a #GtkTargetList
</para>
-@list: a #GtkTargetList
-@target: an interned atom representing the target to search for
-@info: a pointer to the location to store application info for target
-@Returns: %TRUE if the target was found, otherwise %FALSE
+@list:
+@target:
+@info:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_target_table_free ##### -->
+<para>
+
+</para>
+
+@targets:
+@n_targets:
+
+
+<!-- ##### FUNCTION gtk_target_table_new_from_list ##### -->
+<para>
+
+</para>
+
+@list:
+@n_targets:
+@Returns:
<!-- ##### FUNCTION gtk_selection_owner_set ##### -->
<para>
-Claim ownership of a given selection for a particular widget,
-or, if @widget is %NULL, release ownership of the selection.
</para>
-@widget: a #GtkWidget, or %NULL.
-@selection: an interned atom representing the selection to claim
-@time: the time stamp for claiming the selection
-@Returns: %TRUE if the operation succeeded
+@widget:
+@selection:
+@time_:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_selection_owner_set_for_display ##### -->
+<para>
+
+</para>
+
+@display:
+@widget:
+@selection:
+@time_:
+@Returns:
<!-- ##### FUNCTION gtk_selection_add_target ##### -->
<para>
-Add specified target to the list of supported targets for a
-given widget and selection.
</para>
-@widget: a #GtkTarget
-@selection: the selection
-@target: target to add.
-@info: A unsigned integer which will be passed back to the application.
+@widget:
+@selection:
+@target:
+@info:
<!-- ##### FUNCTION gtk_selection_add_targets ##### -->
<para>
-Add a table of targets to the list of supported targets
-for a given widget and selection.
</para>
-@widget: a #GtkWidget
-@selection: the selection
-@targets: a table of targets to add
-@ntargets: number of entries in @targets
+@widget:
+@selection:
+@targets:
+@ntargets:
<!-- ##### FUNCTION gtk_selection_clear_targets ##### -->
<!-- ##### FUNCTION gtk_selection_convert ##### -->
<para>
-Request the contents of a selection. When received,
-a "selection_received" signal will be generated.
</para>
-@widget: The widget which acts as requestor
-@selection: Which selection to get
-@target: Form of information desired (e.g., STRING)
-@time: Time of request (usually of triggering event)
- In emergency, you could use GDK_CURRENT_TIME
-@Returns: TRUE if requested succeeded. FALSE if we could not process
- request. (e.g., there was already a request in process for
- this widget).
+@widget:
+@selection:
+@target:
+@time_:
+@Returns: x
<!-- ##### FUNCTION gtk_selection_data_set ##### -->
<para>
-Store new data into a GtkSelectionData object. Should
-_only_ by called from a selection handler callback.
-Null terminates the stored data.
</para>
@selection_data:
-@type: the type of selection data
-@format: format (number of bits in a unit)
-@data: pointer to the data (will be copied)
-@length: length of the data
+@type:
+@format:
+@data:
+@length:
<!-- ##### FUNCTION gtk_selection_data_set_text ##### -->
@selection_data:
@str:
+@len:
@Returns:
@Returns:
-<!-- ##### FUNCTION gtk_selection_remove_all ##### -->
+<!-- ##### FUNCTION gtk_selection_data_set_pixbuf ##### -->
<para>
-Removes all handlers and unsets ownership of all
-selections for a widget. Called when widget is being
-destroyed. This function will not generally be
-called by applications.
+
</para>
-@widget: a #GtkWidget
+@selection_data:
+@pixbuf:
+@Returns:
-<!-- ##### FUNCTION gtk_selection_data_copy ##### -->
+<!-- ##### FUNCTION gtk_selection_data_get_pixbuf ##### -->
<para>
-Make a copy of a #GtkSelection data structure and its
-data.
+
</para>
-@data: a pointer to a #GtkSelectionData structure.
-@Returns: a pointer to a copy of @data.
+@selection_data:
+@Returns:
-<!-- ##### FUNCTION gtk_selection_data_free ##### -->
+<!-- ##### FUNCTION gtk_selection_data_set_uris ##### -->
<para>
-Free a #GtkSelectionData structure returned from
-gtk_selection_data_copy().
+
</para>
-@data: a pointer to a #GtkSelectionData structure.
+@selection_data:
+@uris:
+@Returns:
-<!-- ##### FUNCTION gtk_selection_clear ##### -->
+<!-- ##### FUNCTION gtk_selection_data_get_uris ##### -->
<para>
-Internal function.
+
</para>
-@widget:
-@event:
+@selection_data:
@Returns:
-<!-- ##### FUNCTION gtk_selection_incr_event ##### -->
+<!-- ##### FUNCTION gtk_selection_data_get_targets ##### -->
<para>
-Internal function.
+
</para>
-@window:
-@event:
+@selection_data:
+@targets:
+@n_atoms:
@Returns:
-<!-- ##### FUNCTION gtk_selection_notify ##### -->
+<!-- ##### FUNCTION gtk_selection_data_targets_include_image ##### -->
<para>
-Internal function.
+
</para>
-@widget:
-@event:
+@selection_data:
+@writable:
@Returns:
-<!-- ##### FUNCTION gtk_selection_property_notify ##### -->
+<!-- ##### FUNCTION gtk_selection_data_targets_include_text ##### -->
<para>
-Internal function.
+
</para>
-@widget:
-@event:
+@selection_data:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_selection_data_targets_include_uri ##### -->
+<para>
+
+</para>
+
+@selection_data:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_selection_data_targets_include_rich_text ##### -->
+<para>
+
+</para>
+
+@selection_data:
+@buffer:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_targets_include_image ##### -->
+<para>
+
+</para>
+
+@targets:
+@n_targets:
+@writable:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_targets_include_text ##### -->
+<para>
+
+</para>
+
+@targets:
+@n_targets:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_targets_include_uri ##### -->
+<para>
+
+</para>
+
+@targets:
+@n_targets:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_targets_include_rich_text ##### -->
+<para>
+
+</para>
+
+@targets:
+@n_targets:
+@buffer:
@Returns:
-<!-- ##### FUNCTION gtk_selection_request ##### -->
+<!-- ##### FUNCTION gtk_selection_remove_all ##### -->
+<para>
+</para>
+
+@widget:
+
+
+<!-- ##### FUNCTION gtk_selection_clear ##### -->
<para>
-Internal function.
</para>
@widget:
@Returns:
+<!-- ##### FUNCTION gtk_selection_data_copy ##### -->
+<para>
+</para>
+
+@data:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_selection_data_free ##### -->
+<para>
+</para>
+
+@data:
+
+