Telas Pop-ups permitem interagir com a Tela de fundo. Já as Telas Modais não permitem interação com outras Telas da aplicação.

A abertura de Telas pop-ups e modais na Biblioteca HighPerformance Template é realizada através de Templates de pop-ups. Os Templates são alocados no item Objetos de Servidor - Objetos de Dados - hpObjects - ScreenTemplates. Nestes objetos é possível configurar diversas propriedades, como sua largura e altura e se a janela é do tipo Modal ou Pop-up, entre outras configurações.

Para mais detalhes sobre como configurar um Template de pop-up, consulte o tópico hpPopupTemplate.

A configuração de objetos para abertura de Telas pop-ups e modais deve ser executada da seguinte forma:

1.Crie e configure um Template de pop-up para cada tipo de janela a ser usada.

2.Instancie o objeto que executa a Associação de abertura da janela, como por exemplo o objeto hpPopupOpen, em Tela

3.Configure a propriedade Behaviour para o valor correspondente à função de abertura de Tela, quando aplicável.

4.Configure as demais propriedades específicas para esta função:

•popArg: Argumento a ser passado à janela

•popName: Nome da Tela, como por exemplo "PopupDemo?100?0" (sem aspas)

•popTemplate: Associação para o respectivo objeto hpPopupTemplate

•popTitle: Título da janela

Para abrir uma janela pop-up ou modal por script, pode-se usar o Tag OpenPopup em Viewer - hpControls - Navigation, que recebe como valor um array com 6 (seis) elementos:

•Elemento 0: MonitorID, uma String com o ID do Monitor, como por exemplo "01" ou "02", a ser concatenado ao final do nome do Quadro onde é aberta a janela. Uma String vazia não adiciona nenhum sufixo ao nome do Quadro

•Elemento 1: popArg, uma String com o argumento a ser passado à Tela. Uma String vazia não passa nenhum argumento

•Elemento 2: popFrame, uma String com o nome do Quadro onde a Tela é aberta. Uma String vazia habilita a denominação automática numérica do Quadro

•Elemento 3: popName, uma String com o caminho da Tela a ser aberta

•Elemento 4: popTitle, uma String com o título a ser exibido na janela

•Elemento 5: popTemplate, um objeto do tipo hpPopupTemplate que referencia o Template da Tela, localizado em hpObjects - ScreenTemplates

Um exemplo de comando para abrir a janela pop-up "Telas.Pop1" em um Quadro denominado “meuQuadro02” em que o sufixo "02" é o ID do Monitor seria o seguinte:

MonitorID = "02"
popArg = ""
popFrame = "meuQuadro"
popName = "Telas.Pop1"
popTitle = ""
set popTemplate = Application.GetObject("hpObjects.ScreenTemplates.PopTemplate1")
set openPopup = Application.Item("hpControls").Item("Navigation").Item("OpenPopup")
openPopup.Value = Array(MonitorID, popArg, popFrame, popName, popTitle, popTemplate)

O comando por script possui algumas limitações naturais em relação ao mesmo comando através do objeto de Tela hpPopupOpen. Estas limitações são referentes a eventos de mouse que não existem na chamada por script. Neste caso, a recomendação é realizar toda a configuração da janela pop-up no respectivo objeto hpPopupTemplate.