Skip to content

Message Box

Message Box is a client control that requires interaction from the user in order for the work process to continue.

Variations

There are four types of Message Boxes: alert, confirm, inquire and generic.

When to use

Use Message Boxes when the user needs to make an active decision, or to bring something to the user's attention.

Alert: Information to the user without possibility to rollback ( Cancel )
Confirm: Information to the user with possibility to rollback ( Cancel )
Inquire: Question to the user with options YES, NO or rollback ( Cancel )
Generic: Custom options set by the developer (example)

Limitations

The alert, confirm and inquire message boxes only have customizable text - the buttons and icons cannot be set.

The generic message box limits the icon selection to warning, information and question.

How to use

There are four command instructions or methods in commands for this: * alert * confirm * inquire * messagebox

Each method takes a message.

The method messagebox allows the user to set custom buttons, select icon and set a title. Icons available are warning information and question.

Messagebox also gives a possibility to set preselected buttons. This setting is optional and if no button is marked as preselected,then messagebox marks the first button from the left by default.

alert


command MessageBoxExample {  
   execute {  
      alert("Take note!");  
   }  
}  

Message box example

Figure 1 - Alert Message Box.

confirm


command MessageBoxExample {  
   execute {  
      confirm("Confirm action") {  
          when OK {  
              doOkAction();  
          }  
          when CANCEL {  
              exit;  
          }  
      }  
   }  
}  

Message box example

Figure 2 - Confirm Message Box.

inquire


command MessageBoxExample {  
   execute {  
      inquire("Do you want to do this?") {  
          when YES {  
              doYesAction();  
          }  
          when NO {  
              doNoAction();  
          }  
          when CANCEL {  
              exit;  
          }  
      }  
   }  
}  

Message box example

Figure 3 - Inquire Message box.

generic


command MessageBoxExample {  
   execute {  
      messagebox("Optional Title", question, "This is a generic messagebox") {  
          when "Button1" {  
              doAction1();  
              selected = [true]; // this is the optional pre-selected button setting  
          }  
          when "Button2" {  
              doAction2();  
          }  
      }  
   }  
}  

Message box example

Figure 4 - Generic Message Box.