Skip to content

diaenterbox_EN

windows99-hue edited this page Jul 15, 2026 · 5 revisions

diaenterbox - Input Dialog Box

ezgif-12d02f672dd783f3
cmd = dokibox.diaenterbox(name="MC", sprites=[sayori("center", "normal")], overflow_mode="overflow")
Parameter Type Default Description
name str or dokibox.Avatar None Character name tag (white rounded label that protrudes above the dialog box)
w int None Width (default 60% of screen width)
h int 220 Height
bold bool False Bold black stroke for body text
overflow_mode string wrap Two options: wrap (auto line wrap) and overflow (directly overflows the screen)
font_family str None Font name (default "Microsoft YaHei"), pass None to use default
font_size int None Font size (point value, default 20), pass None to use default
fdst bool False If set to True, destroys the window when closed. Use this on the last line of a dialogue scene or story branch to ensure the window is completely closed.
transparent bool True Applies a transparency gradient from top to bottom, making the dialog body appear semi-transparent
glare bool True Draws a white semi-circular highlight at the bottom of the dialog box
pinned bool True Whether to keep the window on top
allow_empty bool False Whether to allow the user to input empty values
max_length int None Maximum character length for input text; pass None for no limit

User input: Press Enter to insert a line break, press Shift+Enter or click the left mouse button inside the dialog box to submit the data.

About Sprite Functionality

The sprite API for diaenterbox is the same as dialogbox. Please refer to dialogbox sprite functionality explanation.

About Consecutive Calls

Consecutive calls like the following are allowed:

dokibox.dialogbox("Wow! MC, you're here!", name=sayori, sprites=[sayori("center", "happy")])
cmd = dokibox.diaenterbox(name="MC", sprites=[sayori("center", "normal")], overflow_mode="overflow")

Clone this wiki locally