Message Box

The MessageBox component allows the creation of dialog boxes to ask the user how to proceed on a given situation, presenting the choices as buttons.

This component allows the creation of the following types of message boxes:
Error:

Question:

Info:

Warning:

You can declare several combinations of buttons (OK, YES/NO, YES/NO/CANCEL) or use custom buttons.

Message Box Component

Declaration

<xvw:messageBox></xvw:messageBox>

Properties

Childs

This component can have xvw:menu components as child elements (representing custom buttons).

Examples

MessageBox Declaration in a viewer using predefined buttons.

<xvw:viewer (...)>
 <xeo:form id='formUser'>
  (...)
        <xvw:messageBox 
   id='myMessageBox' 
   messageBoxType='QUESTION'
   title='Message Box Title' 
   message='My Message Box text'
   buttons='OKCANCEL' 
   actions="['#{viewBean.ok}','#{viewBean.cancel}']"
  />
  (...) 

Show the DialogBox from an action of a viewer Bean:

 // Action which is necessary to be confirmed b the user
 public void arquiveQuestion() {
  Dialogs.showDialog( getViewRoot(), "formUser:myMessageBox" );
 }
 public void ok() {
  // The user pressed ok
  // Do Work
 }
 public void cancel() {
  // The user pressed cancel
  // Do Work
 }

If there is no action associated to a button, it closes the dialog box, without executing any action.

Declaring a MessageBox in a viewer using customized buttons.

The behavior is the same, but the attributes buttons and actions do not have to be defined in the MessageBox component,instead you use child xvw:menu components

<xvw:messageBox 
  id='myMessageBox' 
  messageBoxType='WARNING'
  title='Message Box Title' 
  defaultConfirmButton='btn2'
  defaultCancelButton='btn3'
  message='My Message Box text' 
>
 <xvw:menu text='Button 1' id='btn1' serverAction='#{viewBean.btn1Action}' />
 <xvw:menu text='Button 2' id='btn2' serverAction='#{viewBean.btn2Action}' />
 <xvw:menu text='Button 3' id='btn3' serverAction='#{viewBean.btn3Action}' />
</xvw:messageBox>