}
/**
* gdk_selection_owner_set_for_display:
- * @display : the #GdkDisplay.
- * @owner : a GdkWindow or NULL to indicate that the the owner for
- * the given should be unset.
- * @selection : an atom identifying a selection.
- * @time_ : timestamp to use when setting the selection.
- * If this is older than the timestamp given last time the owner was
- * set for the given selection, the request will be ignored.
- * @send_event : if TRUE, and the new owner is different from the current
- * owner, the current owner will be sent a SelectionClear event.
+ * @display: the #GdkDisplay.
+ * @owner: a #GdkWindow or %NULL to indicate that the the owner for
+ * the given should be unset.
+ * @selection: an atom identifying a selection.
+ * @time_: timestamp to use when setting the selection.
+ * If this is older than the timestamp given last time the owner was
+ * set for the given selection, the request will be ignored.
+ * @send_event: if %TRUE, and the new owner is different from the current
+ * owner, the current owner will be sent a SelectionClear event.
*
* Sets the #GdkWindow @owner as the current owner of the selection @selection.
*
- * Returns : TRUE if the selection owner was succesfully changed to owner,
- * otherwise FALSE.
+ * Returns: %TRUE if the selection owner was successfully changed to owner,
+ * otherwise %FALSE.
+ *
+ * Since: 2.2
*/
gboolean
gdk_selection_owner_set_for_display (GdkDisplay *display,
}
/**
- * gdk_selection_owner_get_for_display :
- * @display : a #GdkDisplay.
- * @selection : an atom indentifying a selection.
+ * gdk_selection_owner_get_for_display:
+ * @display: a #GdkDisplay.
+ * @selection: an atom indentifying a selection.
*
* Determine the owner of the given selection.
*
* process if a foreign window was previously created for that
* window, but a new foreign window will never be created by this call.
*
- * Returns :if there is a selection owner for this window,
- * and it is a window known to the current process, the GdkWindow that owns
- * the selection, otherwise NULL.
+ * Returns: if there is a selection owner for this window, and it is a
+ * window known to the current process, the #GdkWindow that owns the
+ * selection, otherwise %NULL.
+ *
+ * Since: 2.2
*/
-
GdkWindow *
gdk_selection_owner_get_for_display (GdkDisplay *display,
GdkAtom selection)
/**
* gdk_selection_send_notify_for_display:
- * @display : the #GdkDisplay where @requestor is realized
- * @requestor : window to which to deliver response.
- * @selection : selection that was requested.
- * @target : target that was selected.
- * @property : property in which the selection owner stored the data,
- * or GDK_NONE to indicate that the request was rejected.
- * @time_ : timestamp.
+ * @display: the #GdkDisplay where @requestor is realized
+ * @requestor: window to which to deliver response.
+ * @selection: selection that was requested.
+ * @target: target that was selected.
+ * @property: property in which the selection owner stored the data,
+ * or %GDK_NONE to indicate that the request was rejected.
+ * @time_: timestamp.
*
* Send a response to SelectionRequest event.
+ *
+ * Since: 2.2
**/
void
gdk_selection_send_notify_for_display (GdkDisplay *display,
* gdk_text_property_to_text_list_for_display:
* @display: The #GdkDisplay where the encoding is defined.
* @encoding: an atom representing the encoding. The most
- * common values for this are STRING, or COMPOUND_TEXT.
- * This is value used as the type for the property.
+ * common values for this are STRING, or COMPOUND_TEXT.
+ * This is value used as the type for the property.
* @format: the format of the property.
* @text: The text data.
* @length: The number of items to transform.
* @list: location to store a terminated array of strings in
- * the encoding of the current locale. This array should be
- * freed using gdk_free_text_list().
+ * the encoding of the current locale. This array should be
+ * freed using gdk_free_text_list().
*
* Convert a text string from the encoding as it is stored
* in a property into an array of strings in the encoding of
- * the current local. (The elements of the array represent the
- * null-separated elements of the original text string.)
+ * the current locale. (The elements of the array represent the
+ * nul-separated elements of the original text string.)
*
- * Returns : the number of strings stored in list, or 0,
+ * Returns: the number of strings stored in list, or 0,
* if the conversion failed.
+ *
+ * Since: 2.2
*/
gint
gdk_text_property_to_text_list_for_display (GdkDisplay *display,
* @list: location to store the list of strings or %NULL. The
* list should be freed with g_strfreev().
*
- * Converts a text property in the giving encoding to
+ * Converts a text property in the given encoding to
* a list of UTF-8 strings.
*
* Return value: the number of strings in the resulting
* list.
+ *
+ * Since: 2.2
**/
gint
gdk_text_property_to_utf8_list_for_display (GdkDisplay *display,
/**
* gdk_string_to_compound_text_for_display:
- * @display : the #GdkDisplay where the encoding is defined.
- * @str : a null-terminated string.
+ * @display: the #GdkDisplay where the encoding is defined.
+ * @str: a nul-terminated string.
* @encoding: location to store the encoding atom
* (to be used as the type for the property).
* @format: location to store the format of the property
* Convert a string from the encoding of the current
* locale into a form suitable for storing in a window property.
*
- * Returns : 0 upon sucess, non-zero upon failure.
+ * Returns: 0 upon sucess, non-zero upon failure.
+ *
+ * Since: 2.2
**/
gint
gdk_string_to_compound_text_for_display (GdkDisplay *display,
*
* Return value: %TRUE if the conversion succeeded, otherwise
* %FALSE.
+ *
+ * Since: 2.2
**/
gboolean
gdk_utf8_to_compound_text_for_display (GdkDisplay *display,
projects / ~andy / gtk / blobdiff