Open form window

4D v16.3

Open form window


Open form window ( {tabela ;} nomeForm {; tipo {; hPos {; vPos {; *}}}} ) -> Resultado

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela do formulário ou tabela padrão, se omitido
nomeForm	String	Nome do formulário
tipo	Inteiro longo	tipo de janela
hPos	Inteiro longo	Posição horizontal da janela
vPos	Inteiro longo	Posição vertical da janela
*	Operador	Salvar posição atual e tamanho da janela
Resultado	refJan	Número de referência de janela

Descrição

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.

Se o formulário nomForm for redimensionar, a janela aberta terá uma caixa de zoom como também uma caixa de redimensionamento.

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

Constante	Tipo	Valor
Form has full screen mode Mac	Inteiro longo	65536
Modal form dialog box	Inteiro longo	1
Movable form dialog box	Inteiro longo	5
Palette form window	Inteiro longo	1984
Plain form window	Inteiro longo	8
Pop up form window	Inteiro longo	32
Sheet form window	Inteiro longo	33
Toolbar form window	Inteiro longo	35

Notas:

A constante Form has full screen mode Mac deve ser adicionada a uma das outras constantes do tipo.
Para saber mais sobre tipos de janela, veja Window Types.

Como padrão, se o parâmetro tipo não for passado, uma janela do tipo Plain form window é aberta.

Close box
Janelas de tipos Movable form dialog box, Plain form window, e Palette form window tem uma close box. Nenhum método é associado com a close box da janela. Clicar na close box cancela e fecha a janela, exceto se o evento de formulário [#cst id="845790"/] tenha sido ativado para o formulário. Nesse caso, o código associado a este evento será executado.

Controle de Tamanho
Se as propriedades "Window Size" de formNome não estão estabelecidas para "fixo", a janela aberta pode ser redimensionada pelo usuário. Uma caixa de zoom pode estar disponível dependendo do tipo de janela. Se as propriedades Fixed Width ou Fixed Height estiverem marcadas nas propriedades de formulário, a jenal não será redimensionada.

Nota: Alguns atributos (grow box, close box...) da janela criada dependem de especificações de interface do sistema operacional para o tipo escolhido. É portanto possível obter resultados diferentes dependendo da plataforma utilizada.

O parâmetro opcional hPos permite que se defina a posição horizontal da janela. Pode passar uma posição definida a este parâmetro (distância em pixels do canto esquero da janela da aplicação ao canto esquerdo interno da janela) ou uma das constantes predefinidas abaixo no tema Abrir janela formulário

Constante	Tipo	Valor
Horizontally centered	Inteiro longo	65536
On the left	Inteiro longo	131072
On the right	Inteiro longo	196608

O parâmetro opcional vPos permite que defina a posição vertical da janela. Pode passar uma posição definida a este parâmetro (distância em pixels do topo da janela da aplicação para o topo interno da janela) ou uma das constantes predefinidas abaixo no tema Abrir janela formulário :

Constante	Tipo	Valor
At the bottom	Inteiro longo	393216
At the top	Inteiro longo	327680
Vertically centered	Inteiro longo	262144

Estes parâmetros levam em consideração a presença da barra de ferramentes assim como o tamanho atual da janela de aplicação (em Windows).

Se pasasr o parâmetro opcional *, a posição atual e tamanho da janela são memorizadas quando fechadas. Quando a janela é reaberta novamente, sua posição prévia e tamanho são respeitados. Neste caso, os parâmetros vPos e hPos são usados apenas na primeira vez que a janela é aberta.

Nota: Para reabrir uma jenal nas coordenadas iniciais vPos e hPos quando o parâmetro * for usado, Pressione a tecla Shift enquanto a jenale está abrindo

 $myWin:=Open form window("sheet form";Sheet form window)

  // Pelo momento, a janela é criada mas permanece escondida

 DIALOG([aTable];"dialForm")

  //O evento On Load é gerado quando a janela planilha é exibida, ela desce

  //do fundo da barra título

Ver também

FORM GET PROPERTIES
Open window
Window Types

4D v16.3

Open form window

Open form window

Descrição

Exemplo 1

Exemplo 2

Exemplo 3