(r2) XWCProgressAndDialogs < WebXEO

WebXEO Web>XEOECCXEOWebComponents>XWCProgressAndDialogs (revision 2) (raw view)~~EditAttach~~
-- Main.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.
---+++++ Componente Message Box
---++++++ Declaração

&lt;xvw:messageBox ... &gt;
---++++++ Propriedades
| *Property* | *Type* | *Description* |
| id | string | Id do componente |
| messageBoxType | <p>Enumeration</p> <p>MessageBox.MessageBoxType</p> | <p>Tipo de icon a ser mostrado na caixa de diálogo. As várias opções são:</p> <p>WARNING - Caixa de aviso</p> <p>QUESTION - Caixa de Interrogação</p> <p>INFO - Caixa de informação</p> <p>ERROR - Caixa de erro</p> |
| 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 | <p>Enumeration</p> <p>MessageBox.MessageBoxButtons</p> | <p>Template de butões prédefinidos. Os valores válidos são os seguintes:</p> <p>YES - Caixa com apenas um botão com a label Sim ou YEs</p> <p>OK - Caixa com apenas um botão com a label OK</p> <p>OKCANCEL - Caixa com dois botões, um com a label Ok e outro com a label Cancelar</p> <p>YESNO - Caixa com dois botões, um com a label Sim e outro com a label Não</p> <p>YESNOCANCEL - Caixa com 3 botões, um com label sim, outro com não e outro com cancelar</p> |
| 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.
<verbatim><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}']"
  />
  (...) </verbatim>

Mostrar a caixa de diálog a partir de uma acção da bean de um viewer:
<verbatim> // 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
 }</verbatim>

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=
<pre><verbatim><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></verbatim>
</pre>
Topic revision: r2 - 2010-09-17 - PedroRio
No permission to view TWiki.WebTopBar
No permission to view TWiki.WebBottomBar