offer_focus - Man Page
Offers the input focus to a particular object. Allegro game programming library.
Synopsis
#include <allegro.h>
int offer_focus(DIALOG *dialog, int obj, int *focus_obj, int force);
Description
Offers the input focus to a particular object. Normally the function sends the MSG_WANTFOCUS message to query whether the object is willing to accept the focus. However, passing any non-zero value as force argument instructs the function to authoritatively set the focus to the object.
See Also
Referenced By
version 4.4.3 Allegro manual