Function

Gdkselection_property_get

Declaration [src]

gint
gdk_selection_property_get (
  GdkWindow* requestor,
  guchar** data,
  GdkAtom* prop_type,
  gint* prop_format
)

Description [src]

Retrieves selection data that was stored by the selection data in response to a call to gdk_selection_convert(). This function will not be used by applications, who should use the GtkClipboard API instead.

This function is not directly available to language bindings.

Parameters

requestor

Type: GdkWindow

The window on which the data is stored.

The data is owned by the caller of the function.

data

Type: guchar**

Location to store a pointer to the retrieved data. If the retrieval failed, NULL we be stored here, otherwise, it will be non-NULL and the returned data should be freed with g_free() when you are finished using it. The length of the allocated memory is one more than the length of the returned data, and the final byte will always be zero, to ensure nul-termination of strings.

The data is owned by the caller of the function.

prop_type

Type: GdkAtom

Location to store the type of the property.

The data is owned by the caller of the function.

prop_format

Type: gint*

Location to store the format of the property.

The data is owned by the caller of the function.

Return value

Type: gint

The length of the retrieved data.