Dialog(3I)

💖 Dialog(3I) 💖

okay bestie, we're in the InterViews Reference Manual and this is THE page for Dialog — the popup dialog interactor. yes she's giving main character energy. yes she handles your dialog box input. let's get into it 🫶

✨ NAME ✨

Dialog — popup dialog interactor 💅

🌸 SYNOPSIS 🌸

#include <InterViews/dialog.h>

🦋 DESCRIPTION 🦋

okay so listen. a dialog is an interactor that handles input for a dialog box. that's her whole job and she does it beautifully 💖

the dialog layout? that's not her business. it's specified by a separate interactor that you pass to the dialog constructor. very much "you bring the vibes, she brings the event loop" ✨

and here's the moment — the dialog completes when the value of an associated button state becomes non-zero. no cap. that button state is typically set by one or more buttons over in the component interactor. iconic behavior honestly 👑

👑 PUBLIC OPERATIONS 👑

• Dialog(ButtonState*, Interactor*, Alignment = Center) — construct a new dialog with the given button state and interactor. the alignment is used by the Popup operation. so like, it matters, keep it in mind 💫
• virtual boolean Accept() — set the dialog button state to zero, then loop reading events until the button state's value becomes non-zero. every event gets passed to its target's Handle operation. she returns true if the value is one, and false otherwise. that's the whole ritual, bestie 🕯️
• virtual boolean Popup(Event&, boolean placed = true) — insert the dialog into the world associated with the given event. if placed is true, align the dialog around the event's (x, y) coordinate. otherwise, the dialog is inserted without specifying a position. then Popup calls the Accept operation and returns its value. she's a whole pipeline fr fr 🌈

🔥 SEE ALSO 🔥

• Button(3I)
• Interactor(3I)
• World(3I)

okay that's the page!! this was InterViews, dated 11 August 1988 — yeah she's vintage and she still ate 💀✨ go build something cute with your popup dialog bestie, mwah 🎀💜