Open form window

4D v16.3

Open form window


Open form window ( {tabla ;} nomForm {; tipo {; posH {; posV {; *}}}} ) -> Resultado

Parámetro	Tipo	Descripción
tabla	Tabla	Tabla del formulario o tabla por defecto, si se omite
nomForm	Cadena	Nombre del formulario
tipo	Entero largo	Tipo de la ventana
posH	Entero largo	Posición horizontal de la ventana
posV	Entero largo	Posición vertical de la ventana
*	Operador	Conservar la posición actual y el tamaño de la ventana
Resultado	WinRef	Número de referencia de la ventana

Descripción

El comando Open form window abre una nueva ventana utilizando las propiedades de tamaño y de redimensionamientos del formulario nomForm.

Note que el formulario nomForm no se muestra en la ventana. Si quiere mostrar el formulario, tiene que llamar un comando que cargue un formulario (por ejemplo ADD RECORD).

A diferencia del comando Open window, ningún método está asociado a la casilla de cierre de la ventana. Al hacer clic en esta casilla se cancela y cierra la ventana, excepto si el evento de formulario On Close Box ha sido activado para el formulario. En este caso, el código asociado con este evento se ejecutará.

Si el formulario nomForm es redimensionable, la ventana abierta tendrá una casilla de zoom como también una casilla de redimensionamiento.

Nota: para conocer las principales propiedades de un formulario, utilice el comando FORM GET PROPERTIES.

El parámetro opcional tipo permite especificar un tipo de ventana. Este parámetro debe contener una de las siguientes constantes predefinidas del tema Abrir ventana formulario ):

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

Notas:

La constante Form has full screen mode Mac debe añadirse a una de las otras constantes de tipo.
Para mayor información sobre los tipos de ventanas, consulte la sección Tipos de ventanas.

De forma predeterminada, si no se pasa el parámetro tipo, se abre una ventana de tipo Plain form window.

Caja de cerrar
Las ventanas de tipo Movable form dialog box, Plain form window y Palette form window tienen una caja de cierre. No se asocia ningún método a la caja de cierre de la ventana. Al hacer clic en este caja de cierre cancela y cierra la ventana, excepto si se ha activado el evento de formulario [#cst id="845790"/] para el formulario. En este caso, se ejecutará el código asociado a este evento.

Control de tamaño
Si las propiedades de "tamaño de ventana" del formulario nomForm no están definidas como "fixed", la ventana abierta puede ser redimensionada por el usuario. Una caja de zoom puede estar disponible, dependiendo del tipo de ventana. Si la propiedad Ancho fijo y/o Altura fija está marcada en las propiedades del formulario, la ventana no será redimensionable.

Nota: algunos atributos (caja de control de tamaño, caja cerrar ...) de la ventana creada dependen de las especificaciones de interfaz del sistema operativo para el tipo elegido. Por lo tanto, es posible obtener diferentes resultados dependiendo de la plataforma utilizada.

El parámetro opcional posH permite definir la posición horizontal de la ventana. Puede pasar una posición definida a este parámetro (distancia en píxeles de la esquina izquierda de la ventana aplicación a la esquina interna izquierda de la ventana) o una de las siguientes constantes predefinidas ubicadas en el tema Abrir ventana formulario:

Constante	Tipo	Valor
Horizontally centered	Entero largo	65536
On the left	Entero largo	131072
On the right	Entero largo	196608

El parámetro opcional posV permite definir la posición vertical de la ventana. Puede pasar una posición definida a este parámetro (distancia en píxeles de la parte superior de la ventana aplicación a la parte superior interna de la ventana) o una de las siguientes constantes predefinidas del tema Abrir ventana formulario:

Constante	Tipo	Valor
At the bottom	Entero largo	393216
At the top	Entero largo	327680
Vertically centered	Entero largo	262144

Estos parámetros tienen en cuenta la presencia de la barra de herramientas, de la barra de menús y del tamaño actual de la ventana de la aplicación (en Windows).

Si pasa el parámetro opcional *, la posición y el tamaño actual de la ventana se memorizan al cerrar. Cuando la ventana se abre nuevamente, se respetan su posición y tamaño anterior. En este caso, los parámetros posV y PosH sólo se utilizan cuando se abre la ventana por primera vez.

Nota: para reabrir una ventana con sus coordenadas por defecto cuando el parámetro vPos y hPos se pasa, mantenga presionada la tecla Mayús mientras se abre la ventana.

Ejemplo 1

La siguiente instrucción abre una ventana estándar o una casilla cerrar y se ajusta automáticamente al tamaño del formulario de "Entrada". Como el formulario ha sido definido como redimensionables, la ventana tiene una casilla de redimensionamiento y una casilla de zoom:

$winRef :=Open form window([Table1];"Enter")

Ejemplo 2

La siguiente instrucción abre una paleta flotante en la parte superior izquierda de la pantalla basada en un formulario de proyecto llamado "Herramientas". Esta paleta utiliza la última posición en cada nueva apertura:

$winRef :=Open form window("Herramientas";Palette form window;On the left;At the top;*)

Ejemplo 3

Este código se debe llamar en macOS mientras se muestra una ventana documento, por ejemplo desde un botón de formulario, para mostrar una ventana hoja:

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

  // Por el momento, la ventana se crea pero permanece oculta

 DIALOG([aTable];"dialForm")

  //El evento On Load se genera luego se muestra la ventana hoja; "Cae"

  //desde la parte inferior de la barra de título

Ver también

FORM GET PROPERTIES
Open window
Tipos de ventanas