MessageBox

Overview

MessageBox is a popup element that shows a title, a text and one or more buttons.

Source Code

MessageBoxSample.java

anybutton.addPressListener(new PressListener() {
    @Override
    public void controlPressed(ControlEvent e) {
        mb = new MessageBox("Did you know?", someMessage, new String[]{"Nice!"});
        mb.setRect(CENTER, CENTER, SCREENSIZE + 50, SCREENSIZE + 30);
        mb.setBackForeColors(Colors.P_300, Colors.ON_P_300);
        mb.popup();
    }
});

Because it is an extensive example, we chose to exemplify the essential: how to use a MessageBox. To see the complete example, click here.

Attributes

Type	Name	Description
PushButtonGroup	btns	The messagebox button group
boolean	yPosition	Messagebox vertical position
int[ ]	buttonKeys	A int array that maps the button id

Methods

Type	Name	Description
Constructor	MessageBox(String title, String msg)	Constructs a message box with the text and one "Ok" button
Constructor	MessageBox(String title, String text, String[] buttonCaptions):	Constructs a message box with the text and the specified button captions
Constructor	MessageBox(String title, String text, String[] buttonCaptions, boolean allSameWidth)	Constructs a message box with the text and the specified button captions; The boolean specify if the buttons will have the same width
Constructor	MessageBox(String title, String text, String[] buttonCaptions, boolean allSameWidth, int gap, int insideGap)	Constructs a message box with the text and the specified button captions; The boolean specify if the buttons will have the same width; The ints specify the external and internal gaps
Constructor	MessageBox(String title, String text, String[] buttonCaptions, int gap, int insideGap)	Constructs a message box with the text and the specified button captions; The ints specify the external and internal gaps
Constructor	MessageBox(Image image, String title, String text, String[] buttonCaptions, int gap, int insideGap)	Constructs a message box with the given text, button captions and image; The ints specify the external and internal gaps
Constructor	MessageBox(Image image, String title, String text, String[] buttonCaptions, boolean allSameWidth, int gap, int insideGap)	Constructs a message box with the given text, button captions and image; The boolean specify if the buttons will have the same width; The ints specify the external and internal gaps
Constructor	Builder( )	Instances the MessageBox Builder. You can use it to make your MessageBox easily.
Builder	setTitle(String title)	Sets the MessageBox title.
Builder	setBaseContainer(Container baseContainer)	This is the content that will be placed between the title and the buttons. You can put anything here. After you set this, the message will not appear since you're putting a Container above it.
Builder	setBaseContainerInsets(int left, int right, int top, int bottom)	Sets the insets of the Container (The container that will be your content).
Builder	setImage(Image image)	Sets the image that is displayed on the top of the MessageBox.
Builder	setMessageBoxInsets(int left, int right, int top, int bottom)	Sets the insets of the MessageBox.
Builder	setButtons(String[] buttonCaptions)	Sets the buttons that will appear on the MessageBox.
Builder	setButtonsMargin(int margin)	Sets the margins of the buttons.
Builder	setTitleContGap(int gap)	Sets the gap between the title and the Container (MessageBox's content).
Builder	setContButtonGap(int gap)	Sets the gap between the Container (MessageBox's content) and the buttons.
int	getPressedButtonIndex( )	Returns the pressed button index
void	setDelayToShowButton(int ms)	Sets the show button delay
void	setIcon(Image icon)	Set a icon in the title aligned at left
void	setText(String text)	Set a text after the popup of the messagebox
void	setUnpopDelay(int unpopDelay)	Set a delay to the unpop animation

References

• See also the quick video tutorial on how to create a MessageBox.
• See the JavaDocs fore more information.