4D v15.4

Open form window

  •  
 
4D v15.4
Open form window

Open form window 


 

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

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

  • 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.
  • 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 (Compatibilidad). Note que sólo los tipos listados en el tema Abrir ventana formulario pueden utilizarse con el comando Open form window.

Cuando se pasa la constante Toolbar form window, la ventana se crea con la ubicación, el tamaño y las propiedades gráficas de una barra de herramientas, es decir:

  • La ventana se mostrará siempre justo debajo de la barra de menús.
  • El tamaño horizontal de la ventana se ajustará automáticamente para llenar todo el espacio horizontal disponible en el escritorio (en OS X) o dentro de la ventana principal de 4D (en Windows). El tamaño vertical de la ventana se basa en las propiedades del formulario, como todos los otros tipos de ventanas formulario.
  • La ventana no tiene borde, no se puede mover y no se puede cambiar el tamaño de forma manual, y los parámetros posH, posV y * se ignoran si están presentes.
  • No es posible crear dos ventanas de la barra de herramientas diferentes al mismo tiempo. Si se llama Open form window con el tipo Toolbar form window mientras ya existe una ventana barra de herramientas, se genera un error -10613 ("No se puede crear dos ventanas formulario de tipo barra de herramientas").

Barra de herramientas y modo pantalla completa en OS X: si su aplicación muestra a la vez una ventana barra de herramientas y una ventana estándar que admiten el modo de pantalla completa (opción Has full screen mode Mac), las normas de interfaz requieren que se oculte la barra de herramientas cuando una ventana estándar pase a  modo pantalla completa. Para saber si una ventana ha cambiado al modo pantalla completa, simplemente pruebe si su tamaño vertical es exactamente el mismo que la altura de la pantalla (consulte el comandos  HIDE TOOL BAR).

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.

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. 

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

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



Ver también 

FORM GET PROPERTIES
Open window
Tipos de ventanas (Compatibilidad)