Modal dialog interactions are a new Discord API feature that allow you to have pop-up windows which prompt the user to input information. Once the user has filled in this information, your program will receive an on_form_submit
event which will contain the data which was input. You must use a slash command interaction response to submit your modal form data to Discord, via the on_slashcommand
event. From here calling the dialog
method of the interaction_create_t
event object will trigger the dialog to appear.
Each dialog box may have up to five rows of input fields. The example below demonstrates a simple setup with just one text input:
#include <dpp/dpp.h>
#include <iostream>
int main(int argc, char const *argv[])
{
if (dpp::run_once<struct register_bot_commands>()) {
bot.global_command_create(
dpp::slashcommand(
"dialog",
"Make a modal dialog box", bot.me.id));
}
});
dpp::interaction_modal_response modal("my_modal", "Please enter stuff");
modal.add_component(
dpp::component().
set_label("Type rammel").
set_id("field_id").
set_type(dpp::cot_text).
set_placeholder("gumf").
set_min_length(1).
set_max_length(2000).
set_text_style(dpp::text_paragraph)
);
event.dialog(modal);
}
});
std::string v = std::get<std::string>(event.
components[0].components[0].value);
event.reply(m);
});
bot.start(false);
return 0;
}
The cluster class represents a group of shards and a command queue for sending and receiving commands...
Definition: cluster.h:467
std::string get_command_name() const
Get the command name for a command interaction.
Represents an application command, created by your bot either globally, or on a guild.
Definition: appcommand.h:809
std::function< void(const dpp::log_t &)> DPP_EXPORT cout_logger()
Get a default logger that outputs to std::cout. e.g.
@ m_ephemeral
this message is only visible to the user who invoked the Interaction
Definition: message.h:959
interaction command
command interaction
Definition: dispatcher.h:423
Represents messages sent and received on Discord.
Definition: message.h:1107
message & set_content(const std::string &c)
Set the message content.
message & set_flags(uint8_t f)
Set the flags.
Session ready.
Definition: dispatcher.h:718
User has issued a slash command.
Definition: dispatcher.h:434
If you compile and run this program and wait for the global command to register, typing /dialog
will present you with a dialog box like the one below: