Open form window

4D v15.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	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:

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:

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
Vertically centered	Inteiro longo	262144
At the top	Inteiro longo	327680
At the bottom	Inteiro longo	393216

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.

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.

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([Table1];"Enter")

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;*)

Ver também

FORM GET PROPERTIES
Open window
Tipos de Janelas