Class used to create a set of options to pass to the AlertWindow and NativeMessageBox methods for showing dialog boxes. More...
Public Member Functions | |
MessageBoxOptions ()=default | |
MessageBoxOptions (const MessageBoxOptions &)=default | |
MessageBoxOptions & | operator= (const MessageBoxOptions &)=default |
MessageBoxOptions | withIconType (MessageBoxIconType type) const |
Sets the type of icon that should be used for the dialog box. | |
MessageBoxOptions | withTitle (const String &boxTitle) const |
Sets the title of the dialog box. | |
MessageBoxOptions | withMessage (const String &boxMessage) const |
Sets the message that should be displayed in the dialog box. | |
MessageBoxOptions | withButton (const String &text) const |
If the string passed in is not empty, this will add a button to the dialog box with the specified text. | |
MessageBoxOptions | withAssociatedComponent (Component *component) const |
The component that the dialog box should be associated with. | |
MessageBoxOptions | withParentComponent (Component *component) const |
The component that will contain the message box (e.g. | |
MessageBoxIconType | getIconType () const noexcept |
Returns the icon type of the dialog box. | |
String | getTitle () const |
Returns the title of the dialog box. | |
String | getMessage () const |
Returns the message of the dialog box. | |
int | getNumButtons () const noexcept |
Returns the number of buttons that have been added to the dialog box. | |
String | getButtonText (int buttonIndex) const |
Returns the text that has been set for one of the buttons of the dialog box. | |
Component * | getAssociatedComponent () const noexcept |
Returns the component that the dialog box is associated with. | |
Component * | getParentComponent () const noexcept |
Returns the component that will be used as the parent of the dialog box. | |
Static Public Member Functions | |
static MessageBoxOptions | makeOptionsOk (MessageBoxIconType iconType, const String &title, const String &message, const String &buttonText=String(), Component *associatedComponent=nullptr) |
Creates options suitable for a message box with a single button. | |
static MessageBoxOptions | makeOptionsOkCancel (MessageBoxIconType iconType, const String &title, const String &message, const String &button1Text=String(), const String &button2Text=String(), Component *associatedComponent=nullptr) |
Creates options suitable for a message box with two buttons. | |
static MessageBoxOptions | makeOptionsYesNo (MessageBoxIconType iconType, const String &title, const String &message, const String &button1Text=String(), const String &button2Text=String(), Component *associatedComponent=nullptr) |
Creates options suitable for a message box with two buttons. | |
static MessageBoxOptions | makeOptionsYesNoCancel (MessageBoxIconType iconType, const String &title, const String &message, const String &button1Text=String(), const String &button2Text=String(), const String &button3Text=String(), Component *associatedComponent=nullptr) |
Creates options suitable for a message box with three buttons. | |
Class used to create a set of options to pass to the AlertWindow and NativeMessageBox methods for showing dialog boxes.
You can chain together a series of calls to this class's methods to create a set of whatever options you want to specify.
E.g.
|
default |
|
default |
|
default |
|
nodiscard |
Sets the type of icon that should be used for the dialog box.
References withMember().
|
nodiscard |
Sets the title of the dialog box.
References withMember().
|
nodiscard |
Sets the message that should be displayed in the dialog box.
References withMember().
|
nodiscard |
If the string passed in is not empty, this will add a button to the dialog box with the specified text.
Generally up to 3 buttons are supported for dialog boxes, so adding any more than this may have no effect.
|
nodiscard |
The component that the dialog box should be associated with.
References withMember().
|
nodiscard |
The component that will contain the message box (e.g.
the AudioProcessorEditor in a plugin).
This will only affect JUCE AlertWindows. It won't affect the drawing of native message boxes. This is mainly intended for use in AU plugins, where opening additional windows can be problematic.
References withMember().
|
noexcept |
Returns the icon type of the dialog box.
String MessageBoxOptions::getMessage | ( | ) | const |
Returns the message of the dialog box.
|
noexcept |
Returns the number of buttons that have been added to the dialog box.
String MessageBoxOptions::getButtonText | ( | int | buttonIndex | ) | const |
Returns the text that has been set for one of the buttons of the dialog box.
|
noexcept |
Returns the component that the dialog box is associated with.
|
noexcept |
Returns the component that will be used as the parent of the dialog box.
|
static |
Creates options suitable for a message box with a single button.
If no button text is supplied, "OK" will be used.
Referenced by StandalonePluginHolder::askUserToLoadState(), and StandalonePluginHolder::askUserToSaveState().
|
static |
Creates options suitable for a message box with two buttons.
If no button text is supplied, "OK" and "Cancel" will be used.
|
static |
Creates options suitable for a message box with two buttons.
If no button text is supplied, "Yes" and "No" will be used.
|
static |
Creates options suitable for a message box with three buttons.
If no button text is supplied, "Yes", "No", and "Cancel" will be used.