4D Doc Center : Open form window

4D v13.4

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

Por defecto (si no se pasa el parámetro tipo), se abre una ventana estándar con una casilla de cerrar. 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 para la ventana. Debe pasar una de las siguientes constantes predefinidas del tema Abrir ventana formulario ):

Constante	Tipo	Valor
Has full screen mode Mac	Entero largo	65536
Has toolbar button Mac OS	Entero largo	8192
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

Notas:

Los atributos de la ventana creada (casilla de redimensionamiento, casilla cerrar...) 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.
Las constantes Has toolbar button Mac OS y Has full screen mode Mac deben 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. Note que sólo los tipos listados en el tema Abrir ventana formulario pueden utilizarse con el comando Open form window.

El parámetro opcional posH permite definir la posición horizontal de la ventana. Puede pasar una posición definida, expresada en puntos, a este parámetro (consulte el comando Open window) 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, expresada en puntos, a este parámetro (consulte el comando Open window) o una de las siguientes constantes predefinidas del tema Abrir ventana formulario:

Constante	Tipo	Valor
Vertically Centered	Entero largo	262144
At the Top	Entero largo	327680
At the Bottom	Entero largo	393216

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.

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([Tabla1];"Entrada")

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