MessageBoxOptions Class Reference

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.
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.

Detailed Description

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.

AlertWindow::showAsync (MessageBoxOptions()
                          .withIconType (MessageBoxIconType::InfoIcon)
                          .withTitle ("A Title")
                          .withMessage ("A message.")
                          .withButton ("OK")
                          .withButton ("Cancel")
                          .withAssociatedComponent (myComp),
                        myCallback);

Constructor & Destructor Documentation

MessageBoxOptions() [1/2]

MessageBoxOptions::MessageBoxOptions ( )

default

MessageBoxOptions() [2/2]

MessageBoxOptions::MessageBoxOptions ( const MessageBoxOptions &  )

default

Member Function Documentation

operator=()

MessageBoxOptions & MessageBoxOptions::operator= ( const MessageBoxOptions &  )

default

withIconType()

MessageBoxOptions MessageBoxOptions::withIconType

(

MessageBoxIconType

type

)

const

Sets the type of icon that should be used for the dialog box.

withTitle()

MessageBoxOptions MessageBoxOptions::withTitle

(

const String &

boxTitle

)

const

Sets the title of the dialog box.

withMessage()

MessageBoxOptions MessageBoxOptions::withMessage

(

const String &

boxMessage

)

const

Sets the message that should be displayed in the dialog box.

withButton()

MessageBoxOptions 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.

Generally up to 3 buttons are supported for dialog boxes, so adding any more than this may have no effect.

withAssociatedComponent()

MessageBoxOptions MessageBoxOptions::withAssociatedComponent

(

Component *

component

)

const

The component that the dialog box should be associated with.

getIconType()

MessageBoxIconType MessageBoxOptions::getIconType ( ) const

noexcept

Returns the icon type of the dialog box.

See also

withIconType

getTitle()

String MessageBoxOptions::getTitle

(

)

const

Returns the title of the dialog box.

See also

withTitle

getMessage()

String MessageBoxOptions::getMessage

(

)

const

Returns the message of the dialog box.

See also

withMessage

getNumButtons()

int MessageBoxOptions::getNumButtons ( ) const

noexcept

Returns the number of buttons that have been added to the dialog box.

See also

withButtonText

getButtonText()

String MessageBoxOptions::getButtonText

(

int

buttonIndex

)

const

Returns the text that has been set for one of the buttons of the dialog box.

See also

withButtonText, getNumButtons

getAssociatedComponent()

Component * MessageBoxOptions::getAssociatedComponent ( ) const

noexcept

Returns the component that the dialog box is associated with.

See also

withAssociatedComponent

---

The documentation for this class was generated from the following file:

• juce_MessageBoxOptions.h