Function

Gdkselection_owner_set

Declaration [src]

gboolean
gdk_selection_owner_set (
  GdkWindow* owner,
  GdkAtom selection,
  guint32 time_,
  gboolean send_event
)

Description [src]

Sets the owner of the given selection.

Parameters

owner

Type: GdkWindow

A GdkWindow or NULL to indicate that the the owner for the given should be unset.

The argument can be NULL.

The data is owned by the caller of the function.

selection

Type: GdkAtom

An atom identifying a selection.

time_

Type: guint32

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

Type: gboolean

If TRUE, and the new owner is different from the current owner, the current owner will be sent a SelectionClear event.

Return value

Type: gboolean

TRUE if the selection owner was successfully changed to owner, otherwise FALSE.