Open form window

O comando Open form window abre uma nova janela utilizando as propriedades de tamanho e de redimensionamentos do formulário nomForm.

Note que o formulário nomForm não se mostra na janela. Se desejar mostrar o formulário, tem que chamar um comando que carregue um formulário (por exemplo ADD RECORD).

Como padrão (se não for passado o parâmetro tipo), uma janela padrão é aberta com uma caixa de fechar. Diferente do comando Open window, nenhum método está associado a caixa de fechar da janela. Ao clicar nesta caixa, cancela e fecha a janela, exceto se o evento de formulário On Close Box tiver sido ativado para o formulário. Neste caso, o código associado com este evento será executado.

Nota: para conhecer as principais propriedades de um formulário, utilize o comando FORM GET PROPERTIES.

O parâmetro opcional tipo permite especificar um tipo de janela. Este parâmetro deve conter uma das seguintes constantes predefinidas do tema Abrir janela formulário):

• Os atributos da janela criada (caixa de redimensionamento, caixa fechar...) dependem das especificações de interface do sistema operativo para o tipo escolhido. Portanto é possível obter diferentes resultados dependendo da plataforma utilizada.
• A constante  Form has full screen mode Mac deve ser adicionada a uma das outras constantes de tipo.
• Para maior informação sobre os tipos de janelas, consulte a seção Tipos de Janelas. Note que apenas os tipos listados no tema Abrir janela formulário podem ser utilizados com o comando Open form window

Quando passar a constante Toolbar form window, a janela é criada com a localização, o tamanho e as propriedades gráficas de uma barra de ferramentas, ou seja:

• A janela será mostrada sempre justo debaixo da barra de menus.
• O tamanho horizontal da janela será ajustada automaticamente para encher todo o espaço horizontal disponível no escritório (em OS X) ou dentro da janela principal de 4D (em Windows). O tamanho vertical da janela se baseia nas propriedades do formulário, como todos os outros tipos de janelas formulário.
• A janela não tem borde, não pode se mover e não pode mudar o tamanho de forma manual, e os parâmetros posH, posV e * se ignoram se estão presentes.
• Não é possível criar duas janelas da barra de ferramentas diferentes ao mesmo tempo. Se chamar Open form window com o tipo Toolbar form window enquanto já existe uma janela barra de ferramentas, é gerado um erro -10613 ("Não pode criar duas janelas formulário de tipo barra de ferramentas").

Barra de ferramentas e modo tela completa em OS X: se sua aplicação mostra ao mesmo tempo uma janela barra de ferramentas e uma janela estandarte que admitem o modo de tela completa (opção Has full screen mode Mac), as normas de interface requerem que se oculte a barra de ferramentas quando uma janela estandarte passe a modo tela completa. Para saber se uma janela mudou ao modo tela completa, simplesmente prove se seu tamanho vertical é exatamente o mesmo que a altura da tela (consulte o comando HIDE TOOL BAR).

O parâmetro opcional posH permite definir a posição horizontal da janela. Pode passar uma posição definida, expressada em pontos, a este parâmetro (consulte o comando Open window) ou uma das seguintes constantes predefinidas que ficam no tema Abrir janela formulário:

O parâmetro opcional posV permite definir a posição vertical da janela. Pode passar uma posição definida, expressa em pontos, a este parâmetro (consulte o comando Open window) ou uma das seguintes constantes predefinidas do tema Abrir janela formulário:

Se passa o parâmetro opcional *, a posição e o tamanho atual da janela são memorizados ao fechar. Quando a janela é aberta novamente, sua posição e tamanho anterior são conservados. Neste caso, os parâmetros posV e PosH apenas são utilizados quando se abre a janela pela primeira vez.

Nota: para reabrir uma janela com suas coordenadas por padrão quando o parâmetro vPos e hPos for passado, mantenha pressionada a tecla Maiuscula enquanto a janela se abre. 

A seguinte instrução abre uma janela padrão ou uma caixa fechar e se ajusta automaticamente ao tamanho do formulário de "Entrada". Como o formulário foi definido como redimensionáveis, a janela tem uma caixa de redimensionamento e uma caixa de zoom

A instrução abre una palheta flutuante na parte superior esquerda da tela baseada em um formulário de projeto chamado "Ferramentas". Esta palheta utiliza a última posição em cada nova abertura: