gtk-widget-grab-default (widget)

widget -- a gtk-widget object

Causes the widget to become the default widget. The widget must be able to be a default widget. Typically you would ensure this yourself by calling the gtk-widget-can-default function with a true value.

The default widget is activated when the user presses the Enter key in a window. Default widgets must be activatable, that is, the gtk-widget-activate function should affect them. Note that gtk-entry widgets require the activates-default property set to true before they activate the default widget when the Enter key is pressed and the gtk-entry widget is focused.