4D Doc Center : Open form window

4D v12.4

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	cadeia	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	WinRef	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 o evento On Close Box será executado.

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

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

O parâmetro opcional tipo permite especificar um tipo para a janela. Deve passar uma das seguintes constantes predefinidas do tema Abrir janela formulário):

Constante	Tipo	Valor
Compositing Mode form window	Inteiro longo	4096
Has toolbar button Mac OS	Inteiro longo	8192
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

Notas:

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.
As constantes Compositing Mode form window e Has toolbar button Mac OS devem ser adicionados 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

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:

Constante	Tipo	Valor
Horizontally Centered	Inteiro longo	65536
On the Left	Inteiro longo	131072
On the Right	Inteiro longo	196608

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:

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 ferramentas, da barra de menus e também do tamanho atual da janela da aplicação (em Windows).

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.

Exemplo 1

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:

$winRef :=Open form window([Tabela1];"Entrada")

Exemplo 2

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:

$winRef :=Open form window("Ferramentas";Palette form window;On the Left;At the Top;*)