d_edit_proc(3alleg4)

💖 d_edit_proc — Allegro manual, bestie edition 💖

okay so this page lives in the Allegro manual (yes, that Allegro, the game programming library, she's iconic) and she's here to explain d_edit_proc.

✨ NAME ✨

d_edit_proc — it's a dialog procedure that implements an editable text object. Allegro game programming library. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

int d_edit_proc(int msg, DIALOG *d, int c);

like, that's the whole signature, no notes. 🫶

🦋 DESCRIPTION 🦋

so bestie, picture this: it's an editable text object. the dp field is the one pointing at the string, okay? when this thing has the input focus — which you get by clicking on it with the mouse 🖱️ — you can literally just type text into it. main character behaviour tbh.

and the fields? here's the tea:

• the d1 field says the maximum number of characters it will accept. she has boundaries, respect them. 💅
• the d2 field is the text cursor position within the string. that's where the little blinking moment happens.

⚠️ note, and this one matters, no cap: dp must point to a buffer that's at least (d1 + 1) * 4 bytes long. why? because depending on the encoding format in use, a single character can take up up to 4 bytes 😭 and you still gotta reserve room for the terminating null character. do not skip the null, she is required, periodt.

👑 SEE ALSO 👑

• excustom(3alleg4)
• exgui(3alleg4)

go read them, iykyk. 📚✨

k byeeee, this was the Allegro manual, version 4.4.3 💖 stay editable, stay slay 💅🎀🦋