Toolbar form windows

4D v15

4D v15 - Actualización (standard edition)

Originalmente introducido en 4D v14 R5

4D v14 R5 incluye una serie de implementaciones destinadas a ayudar a los desarrolladores a diseñar y administrar barras de herramientas personalizadas. Las barras de herramientas son ventanas con propiedades específicas en cuanto a su posición y tamaño.

Los siguientes comandos soportan la creación y la gestión de barras de herramientas:

Open form window: acepta el nuevo tipo Toolbar form window
Tool bar height: devuelve la altura de la barra de herramientas personalizada
HIDE TOOL BAR y SHOW TOOL BAR: anteriormente obsoletos, estos comandos se han reactivado para la gestión de barras de herramientas personalizadas.

Open form window

Tema: Ventanas



	Open form window ( {aTable ;} formName {; type {; hPos {; vPos {; *}}}} ) -> Resultado

El comando Open form window ahora puede crear ventanas formulario de tipo Barra de herramientas.

Una nueva constante ha sido añadido al tema "Crear ventana formulario" y utilizable en el parámetro type:

Constante	Tipo	Valor
Toolbar form window	Entero largo	35

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 disponible horizontal 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 bordes, no se puede mover y no se puede redimensionar manualmente, y HPOS, los parámetros posH, PosV y * se ignoran si se pasan.

No es posible crear al mismo tiempo dos ventanas de barra de herramientas diferentes. Si Crear ventana formulario se llama con el tipo Formulario ventana barra de herramientas mientras ya existe una ventana de barra de herramientas, se genera un error -10613 ("No se puede crear dos ventanas formularios de tipo barra de herramientas").

Nota sobre las ventana formulario barra de herramientas y modo pantalla completa OS X: si su aplicación muestra a la vez una ventana barra de herramientas y una ventana estándar que soporta el modo pantalla completa (opción Con modo pantalla completa Mac), las reglas de interfaz requieren que se oculte la barra de herramientas cuando una ventana estándar entra en modo pantalla completa. Para saber si una ventana ha cambiado al modo de pantalla completa, simplemente pruebe si su tamaño vertical es exactamente el mismo que la altura de la pantalla (ver abajo).

Altura barra de herramientas

Tema: Windows (comando desplazado desde el tema "Interfaz de usuario")

Tool bar height -> Resultado

Parámetro	Tipo		Descripción
Resultado	Entero largo	<-	Altura (expresada en píxeles) de la barra de herramientas o 0 si la barra de herramientas está oculta

A partir de 4D v14 R5, este comando también funciona con las barras de herramientas personalizadas creadas por el comando Open form window utilizando el tipo Toolbar form window.

Este comando devuelve la altura de la barra de herramientas visible actual, expresada en píxeles. Puede ser la barra de herramientas del modo Diseño de 4D, o una barra de herramientas creada por Open form window, dependiendo del contexto (la barra de herramientas del modo Diseño se oculta automáticamente si se muestra una barra de herramientas personalizada creada por Open form window).

Si la barra de herramientas está oculta, el comando devuelve 0.

HIDE TOOL BAR y SHOW TOOL BAR

Tema: Ventanas (comandos desplazados desde el tema "User interface")



	SHOW TOOL BAR No requiere ningún parámetro HIDE TOOL BAR No requiere ningún parámetro

Estos comandos ya no son obsoletos en 4D partir de la versión 14 R5: ahora se pueden usar para manejar las ventanas formulario de barras de herramientas personalizadas creadas con el comando Open form window para el proceso actual.

SHOW TOOL BAR: si se ha abierto una ventana barra de herramientas (llamando Open form window con la opción Toolbar form window), el comando hace que esta ventana sea visible. Si la ventana barra de herramientas ya era visible o no existe, este comando no hace nada.
HIDE TOOL BAR: si se ha abierto una ventana de la barra de herramientas (llamando Open form window con la opción Toolbar form window), el comando oculta esta ventana. Si la ventana barra de herramientas ya estaba oculta o no existe, este comando no hace nada.

Ejemplo

En OS X, que se ha definido una barra de herramientas personalizada y una ventana estándar con la opción Has full screen mode Mac. Cuando una ventana estándar es maximizada por un usuario mientras se muestra la ventana de barra de herramientas, usted no desea que la ventana maximizada sea solapada por la barra de herramientas.

Para evitar esto, en el evento "On Resize" del formulario de la ventana estándar, es necesario detectar cuando la ventana está en modo de pantalla completa y luego llamar a HIDE TOOL BAR:

 Case of

    :(Form event=On Resize)

       GET WINDOW RECT($left;$top;$right;$bottom)

       If(Screen height=($bottom-$top))

          HIDE TOOL BAR

       Else

          SHOW TOOL BAR

       End if

 End case

Constantes obsoletas

Las siguientes constantes relacionadas con el botón de la barra de herramientas Mac OS ahora tienen el prefijo _O_, ya que la opción correspondiente ha quedado en desuso por Apple desde OS X 10.6:

Has toolbar button Mac (temas "Open Form Window" y "Open Window") se ha renombrado por _O_Has toolbar button Mac.
On Mac Toolbar Button (tema "Form Events") se ha renombrado por _O_On Mac Toolbar Button.