-- JoaoCarreira - 22 Dec 2009

Message Box

O componente MessageBox permite criar caixas de diálogo para interrogar o operador de uma aplicação sobre a decisão que deve tomar em determinadas circunstâncias aplicaionais.

Este componente permite criar essas caixas.

Error:

Question:

Info:

Warning:

Componente Message Box

Declaração

<xvw:messageBox ... >

Propriedades

Property	Type	Description
id	string	Id do componente
messageBoxType	Enumeration MessageBox.MessageBoxType	Tipo de icon a ser mostrado na caixa de diálogo. As várias opções são: WARNING - Caixa de aviso QUESTION - Caixa de Interrogação INFO - Caixa de informação ERROR - Caixa de erro
title	string / EL	The title of the message box
defaultConfirmButton	string	Id do botão de confirmação selecionado por omissão. Ou seja, e o utilizador pressionar a tecla ENTER a acção do botão é executada
defaultCancelButton	string	Id do botão de cancelar selecionado por omissão. Se o utilizador pressionar a tecla ESC, a acção do botão é executada
message	string / EL	The content of the message box
buttons	Enumeration MessageBox.MessageBoxButtons	Template de butões prédefinidos. Os valores válidos são os seguintes: YES - Caixa com apenas um botão com a label Sim ou YEs OK - Caixa com apenas um botão com a label OK OKCANCEL - Caixa com dois botões, um com a label Ok e outro com a label Cancelar YESNO - Caixa com dois botões, um com a label Sim e outro com a label Não YESNOCANCEL - Caixa com 3 botões, um com label sim, outro com não e outro com cancelar
actions	JSON Array com EL Methods	JSON Array com um numero posições iguais ao numero de botoes especificados no buttons. Exemplo, se no buttons for colocado OKCANCEL deve ser construido um array com duas posições um para a acção do OK e outra para a acção do cancel. eg: ['#{viewBean.myOkAction}','#{viewBean.myCancelAction}'].
minWidth	int	The minimum width of the MessageBox
maxWidth	int	The maximum width of the MessageBox

Descendentes

Este componente pode ter como filhos os componentes xvw:menu ou descendentes.

Exemplos de utilização

Declaração de uma MessageBox num viewer utilizando os botões pré-definidos.

<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}']"
  />
  (...) 

Mostrar a caixa de diálog a partir de uma acção da bean de um viewer:

 // Acção que é necessário a confirmação do utilizador
 public void arquivarQuestion() {
  Dialogs.showDialog( getViewRoot(), "formUser:myMessageBox" );
 }
 public void ok() {
  // O utilizador pressionou no ok
  // Do Work
 }
 public void cancel() {
  // O utilizador pressionou em cancelar
  // Do Work
 }

Se não existir qualquer tipo de acção associada ao botão, a acção pode ficar fazia. Quando assim acontece o botão apenas fecha a caixa de diálogo sem executar qualquer acção.

Declaração de uma MessageBox num viewer utilizando os botões personalizados.

O funcionamento é igual, mas apenas não se define o atributo buttons e actions no componente MessageBox, mas sim nos filhos do tipo xvw:menu

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