The set_focus_on_click() method sets the "focus-on-click" property to the value of focus_on_click. If focus_on_click is TRUE, the button grabs focus when it is clicked by the mouse.
See also: get_focus_on_click()