send_focus_change


Description:

[ Version ( since = "2.20" ) ]
public bool send_focus_change (Event event)

Sends the focus change event to this

This function is not meant to be used by applications. The only time it should be used is when it is necessary for a Widget 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 TreeView.

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);

Parameters:

this

a Widget

event

a Event of type GDK_FOCUS_CHANGE

Returns:

the return value from the event signal emission: true if the event was handled, and false otherwise