]> Pileus Git - ~andy/gtk/blobdiff - docs/reference/gtk/tmpl/gtkselection.sgml
2.9.0
[~andy/gtk] / docs / reference / gtk / tmpl / gtkselection.sgml
index bced03118969b66fc5e6aa566ec4a592e4be62e4..e09ff011cbd7b423ea3440cd1758e33684a77200 100644 (file)
@@ -2,7 +2,7 @@
 Selections
 
 <!-- ##### SECTION Short_Description ##### -->
-Functions for handling inter-process communication via selections.
+Functions for handling inter-process communication via selections
 
 <!-- ##### SECTION Long_Description ##### -->
 
@@ -41,6 +41,9 @@ associated information.
 
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### STRUCT GtkTargetEntry ##### -->
 <para>
 A #GtkTargetEntry structure represents a single type of
@@ -82,106 +85,163 @@ selection handling code.
 
 <!-- ##### FUNCTION gtk_target_list_new ##### -->
 <para>
-Creates 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>
-Increases the reference count of a #GtkTargetList by one.
 </para>
 
-@list: a #GtkTargetList
+@list: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_target_list_unref ##### -->
 <para>
-Decreases the reference count of a #GtkTargetList by one.
-If the resulting reference count is zero, frees the list.
 </para>
 
-@list: a #GtkTargetList
+@list: 
 
 
 <!-- ##### FUNCTION gtk_target_list_add ##### -->
 <para>
-Adds 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>
-Adds 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>
-Removes 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>
-Looks 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>
-Claims 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>
-Adds 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>
-Adds 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 ##### -->
@@ -195,32 +255,24 @@ for a given widget and selection.
 
 <!-- ##### FUNCTION gtk_selection_convert ##### -->
 <para>
-Requests 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>
-Stores new data into a #GtkSelectionData object. Should
-<emphasis>only</emphasis> be called from a selection handler callback.
-Zero-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 ##### -->
@@ -243,6 +295,44 @@ Zero-terminates the stored data.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_selection_data_set_pixbuf ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@pixbuf: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_selection_data_get_pixbuf ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_selection_data_set_uris ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@uris: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_selection_data_get_uris ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_selection_data_get_targets ##### -->
 <para>
 
@@ -254,6 +344,16 @@ Zero-terminates the stored data.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_selection_data_targets_include_image ##### -->
+<para>
+
+</para>
+
+@selection_data: 
+@writable: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_selection_data_targets_include_text ##### -->
 <para>
 
@@ -263,32 +363,95 @@ Zero-terminates the stored 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_remove_all ##### -->
 <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
+@widget: 
+
+
+<!-- ##### FUNCTION gtk_selection_clear ##### -->
+<para>
+</para>
+
+@widget: 
+@event: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_selection_data_copy ##### -->
 <para>
-Makes a copy of a #GtkSelectionData structure and its data.
 </para>
 
-@data: a pointer to a #GtkSelectionData structure.
-@Returns: a pointer to a copy of @data.
+@data: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_selection_data_free ##### -->
 <para>
-Frees a #GtkSelectionData structure returned from
-gtk_selection_data_copy().
 </para>
 
-@data: a pointer to a #GtkSelectionData structure.
+@data: