Propriedade

Tipo

Valor Padrão

Descrição

drawContainer

Boolean

true

Define se o popupForm deve desenhar uma borda que delimita seu conteúdo.

cancelable

Boolean

true

Define se o popupForm pode ser cancelado pelo usuário.

Quando true, o popupForm fecha automaticamente quando o usuário fizer uma ação de cancelamento de popup (tecla ESC, clique no botão X da janela em desktop, tecla voltar em celulares/tablets, click fora do Popup em dispositivos móveis, etc..).

Quando false, o popupForm não fecha automaticamente quando o usuário fizer uma ação padrão de cancelamento do popup. Assim, a única maneira de fechar o popupForm é invocar o método "close" ou "gui.closePopup" via programação.

O evento "onCancelRequest" é disparado apenas quando "cancelable" for false.

placement

String enumerado:

• "center"
• "bottom"
• "top"
• "left"
• "right"
• "topLeft"
• "topRight"
• "bottomLeft"
• "bottomRight"
• "mouse"
• "mouseCenter"

"center"

Define onde o popupForm deve ser exibido.

"center" - no centro da tela 

"bottom" - na parte de baixo da tela

"top" - na parte de cima da tela

"left" - à esquerda na tela

"right" - à direita na tela

"topLeft" -  no canto superior esquerdo da tela

"topRight - no canto superior direito da tela

"bottomLeft" - no canto inferior esquerdo da tela

"bottomRight" - no canto inferior direito da tela

"mouse" - onde o mouse está atualmente

"mouseCenter" - centralizado onde o mouse está atualmente.

resizable

Boolean

false

Define se o usuário pode redimensionar o popup form manualmente.

Funciona somente se a propriedade "drawContainer" for true.

Observações:

• Por enquanto, esta propriedade não possui efeito no Firecast Mobile.
  
  

movable

Boolean

true

Determines whether the user can move the popup form by clicking and dragging it.

This property is considered only if the "drawContainer" property is set to "false".

Método

Descrição

popupForm:show();

Exibe o popup na interface do usuário

Retorna true se o popupForm não estava visível e passou a ficar visível na interface.

popupForm:close();

Fecha o popup da interface do usuário.

Retorna true o popupForm estava visível na interface e passou a não ficar visível.

Nome do evento

Descrição

onCancelRequest

Se o atributo "cancelable" for false, este evento é invocado quando o usuário fizer uma ação sinalizando que deseja fechar o popup.

Você pode realizar ações "bacanas" aqui, como, por exemplo: 

• Invocar o método "close" apenas se o usuário não tiver preenchido nenhum campo da interface
• Perguntar ao usuário se ele realmente deseja cancelar (usando dialogs.confirmYesNo) e só depois então fechar o popup invocando o método "close".