offer_focus(3)

✨ NAME ✨

offer_focus — offers the input focus to a particular object. This page is offer_focus(3) from the Allegro manual, and it's part of the Allegro game programming library. 💖

🦋 SYNOPSIS 🦋

#include <allegro.h>

int offer_focus(DIALOG *dialog, int obj, int *focus_obj, int force);

💅 DESCRIPTION 💅

Okay so offer_focus does exactly what it says on the tin: it 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. It's giving "hey bestie, do you want the focus? yes/no?" ✨

But if you pass any non-zero value as the force argument, the function skips the asking and authoritatively sets the focus to the object. No debate, no vibe check, just focus. 👑

Lowkey important: force being non-zero means "I said what I said." If you don't want that energy, don't pass a non-zero value. 💅

👑 SEE ALSO 👑

• find_dialog_focus(3) 🌸

Allegro, version 4.4.3, offer_focus(3) — signing off, bestie. Periodt. 💖✨