D++ (DPP)
C++ Discord API Bot Library
dpp::interaction_modal_response Struct Reference

Represents a modal dialog box response to an interaction. More...

+ Inheritance diagram for dpp::interaction_modal_response:
+ Collaboration diagram for dpp::interaction_modal_response:

Public Member Functions

 interaction_modal_response ()
 Construct a new interaction modal response object. More...
 
 interaction_modal_response (const std::string &_custom_id, const std::string &_title, const std::vector< component > _components={})
 Construct a new interaction modal response object. More...
 
interaction_modal_responseset_custom_id (const std::string &_custom_id)
 Set the custom id. More...
 
interaction_modal_responseset_title (const std::string &_title)
 Set the title. More...
 
interaction_modal_responseadd_component (const component &c)
 Add a component to an interaction modal response. More...
 
interaction_modal_responseadd_row ()
 Add a new row to the interaction modal response. More...
 
virtual ~interaction_modal_response ()=default
 Destroy the interaction modal response object. More...
 
interaction_responseadd_autocomplete_choice (const command_option_choice &achoice)
 Add a command option choice. More...
 
interaction_responsefill_from_json (nlohmann::json *j)
 Convert object from nlohmann::json. More...
 
auto to_json (bool with_id=false) const
 Convert object to nlohmann::json. More...
 
std::string build_json (bool with_id=false) const
 Convert object to json string. More...
 
interaction_modal_responsefill_from_json (nlohmann::json *j)
 Convert object from nlohmann::json. More...
 
auto to_json (bool with_id=false) const
 Convert object to nlohmann::json. More...
 
std::string build_json (bool with_id=false) const
 Convert object to json string. More...
 

Public Attributes

std::string custom_id
 Custom ID for the modal form. More...
 
std::string title
 Title of the modal form box (max 25 characters) More...
 
std::vector< std::vector< component > > components
 List of components. All components must be placed within an action row, each outer vector is the action row. More...
 
interaction_response_type type {}
 Response type from dpp::interaction_response_type. Should be one of ir_pong, ir_channel_message_with_source, or ir_deferred_channel_message_with_source. More...
 
message msg {}
 Message tied to this response. More...
 
std::vector< command_option_choiceautocomplete_choices {}
 Array of up to 25 autocomplete choices. More...
 

Protected Member Functions

virtual interaction_modal_responsefill_from_json_impl (nlohmann::json *j)
 Fill object properties from JSON. More...
 
virtual json to_json_impl (bool with_id=false) const
 Build a json for this object. More...
 

Protected Attributes

size_t current_row
 

Friends

struct json_interface< interaction_modal_response >
 

Detailed Description

Represents a modal dialog box response to an interaction.

A dialog box is a modal popup which appears to the user instead of a message. One or more components are displayed on a form (the same component structure as within a dpp::message). When the user submits the form an on_form_submit event is dispatched to any listeners.

Constructor & Destructor Documentation

◆ interaction_modal_response() [1/2]

dpp::interaction_modal_response::interaction_modal_response ( )

Construct a new interaction modal response object.

◆ interaction_modal_response() [2/2]

dpp::interaction_modal_response::interaction_modal_response ( const std::string &  _custom_id,
const std::string &  _title,
const std::vector< component _components = {} 
)

Construct a new interaction modal response object.

Parameters
_custom_idCustom ID of the modal form
_titleTitle of the modal form. It will be truncated to the maximum length of 45 UTF-8 characters.
_componentsComponents to add to the modal form

◆ ~interaction_modal_response()

virtual dpp::interaction_modal_response::~interaction_modal_response ( )
virtualdefault

Destroy the interaction modal response object.

Member Function Documentation

◆ add_autocomplete_choice()

interaction_response& dpp::interaction_response::add_autocomplete_choice ( const command_option_choice achoice)
inherited

Add a command option choice.

Parameters
achoicecommand option choice to add
Returns
interaction_response& Reference to self

◆ add_component()

interaction_modal_response& dpp::interaction_modal_response::add_component ( const component c)

Add a component to an interaction modal response.

Parameters
ccomponent to add
Returns
interaction_modal_response& Reference to self

◆ add_row()

interaction_modal_response& dpp::interaction_modal_response::add_row ( )

Add a new row to the interaction modal response.

Note
A modal response can have a maximum of five rows.
Exceptions
dpp::logic_exceptionif more than five rows are attempted to be added
Returns
interaction_modal_response& Reference to self

◆ build_json() [1/2]

std::string dpp::json_interface< interaction_response >::build_json ( bool  with_id = false) const
inlineinherited

Convert object to json string.

Parameters
with_idWhether to include the ID or not
Note
Some fields are conditionally filled, do not rely on all fields being present
Returns
std::string Json built from the structure

◆ build_json() [2/2]

std::string dpp::json_interface< interaction_modal_response >::build_json ( bool  with_id = false) const
inlineinherited

Convert object to json string.

Parameters
with_idWhether to include the ID or not
Note
Some fields are conditionally filled, do not rely on all fields being present
Returns
std::string Json built from the structure

◆ fill_from_json() [1/2]

interaction_modal_response & dpp::json_interface< interaction_modal_response >::fill_from_json ( nlohmann::json *  j)
inlineinherited

Convert object from nlohmann::json.

Parameters
jnlohmann::json object
Returns
T& Reference to self for fluent calling

◆ fill_from_json() [2/2]

interaction_response & dpp::json_interface< interaction_response >::fill_from_json ( nlohmann::json *  j)
inlineinherited

Convert object from nlohmann::json.

Parameters
jnlohmann::json object
Returns
T& Reference to self for fluent calling

◆ fill_from_json_impl()

virtual interaction_modal_response& dpp::interaction_modal_response::fill_from_json_impl ( nlohmann::json *  j)
protectedvirtual

Fill object properties from JSON.

Parameters
jJSON to fill from
Returns
interaction_response& Reference to self

Reimplemented from dpp::interaction_response.

◆ set_custom_id()

interaction_modal_response& dpp::interaction_modal_response::set_custom_id ( const std::string &  _custom_id)

Set the custom id.

Parameters
_custom_idcustom id to set
Returns
interaction_modal_response& Reference to self

◆ set_title()

interaction_modal_response& dpp::interaction_modal_response::set_title ( const std::string &  _title)

Set the title.

Parameters
_titletitle to set
Returns
interaction_modal_response& Reference to self

◆ to_json() [1/2]

auto dpp::json_interface< interaction_response >::to_json ( bool  with_id = false) const
inlineinherited

Convert object to nlohmann::json.

Parameters
with_idWhether to include the ID or not
Note
Some fields are conditionally filled, do not rely on all fields being present
Returns
json Json built from the structure

◆ to_json() [2/2]

auto dpp::json_interface< interaction_modal_response >::to_json ( bool  with_id = false) const
inlineinherited

Convert object to nlohmann::json.

Parameters
with_idWhether to include the ID or not
Note
Some fields are conditionally filled, do not rely on all fields being present
Returns
json Json built from the structure

◆ to_json_impl()

virtual json dpp::interaction_modal_response::to_json_impl ( bool  with_id = false) const
protectedvirtual

Build a json for this object.

Parameters
with_idinclude id in json output
Returns
json JSON object

Reimplemented from dpp::interaction_response.

Friends And Related Function Documentation

◆ json_interface< interaction_modal_response >

friend struct json_interface< interaction_modal_response >
friend

Member Data Documentation

◆ autocomplete_choices

std::vector<command_option_choice> dpp::interaction_response::autocomplete_choices {}
inherited

Array of up to 25 autocomplete choices.

◆ components

std::vector<std::vector<component> > dpp::interaction_modal_response::components

List of components. All components must be placed within an action row, each outer vector is the action row.

◆ current_row

size_t dpp::interaction_modal_response::current_row
protected

◆ custom_id

std::string dpp::interaction_modal_response::custom_id

Custom ID for the modal form.

◆ msg

message dpp::interaction_response::msg {}
inherited

Message tied to this response.

◆ title

std::string dpp::interaction_modal_response::title

Title of the modal form box (max 25 characters)

◆ type

interaction_response_type dpp::interaction_response::type {}
inherited

Response type from dpp::interaction_response_type. Should be one of ir_pong, ir_channel_message_with_source, or ir_deferred_channel_message_with_source.

D++ Library version 9.0.13D++ Library version 9.0.12D++ Library version 9.0.11D++ Library version 9.0.10D++ Library version 9.0.9D++ Library version 9.0.8D++ Library version 9.0.7D++ Library version 9.0.6D++ Library version 9.0.5D++ Library version 9.0.4D++ Library version 9.0.3D++ Library version 9.0.2D++ Library version 9.0.1D++ Library version 9.0.0D++ Library version 1.0.2D++ Library version 1.0.1D++ Library version 1.0.0