Method

GtkWidgetsend_focus_change

since: 2.20

Declaration [src]

gboolean
gtk_widget_send_focus_change (
  GtkWidget* widget,
  GdkEvent* event
)

Description [src]

Sends the focus change event to widget

This function is not meant to be used by applications. The only time it should be used is when it is necessary for a GtkWidget to assign focus to a widget that is semantically owned by the first widget even though it’s not a direct child - for instance, a search entry in a floating window similar to the quick search in GtkTreeView.

An example of its usage is:

  GdkEvent *fevent = gdk_event_new (GDK_FOCUS_CHANGE);

  fevent->focus_change.type = GDK_FOCUS_CHANGE;
  fevent->focus_change.in = TRUE;
  fevent->focus_change.window = _gtk_widget_get_window (widget);
  if (fevent->focus_change.window != NULL)
    g_object_ref (fevent->focus_change.window);

  gtk_widget_send_focus_change (widget, fevent);

  gdk_event_free (event);

Available since: 2.20

Parameters

event

Type: GdkEvent

A GdkEvent of type GDK_FOCUS_CHANGE.

The data is owned by the caller of the method.

Return value

Type: gboolean

The return value from the event signal emission: TRUE if the event was handled, and FALSE otherwise.