Ventana principal

Grupo de comandos de interfaz que permiten interactuar con el marco del proyecto.

Interfaz: ¿es visible el dock?

Comando de instrucción del grupo Interfaz que nos informa si el dock es o no visible.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista docks de formulario declarados en el marco principal del proyecto. Seleccionar el dock a evaluar.

• Identificador de variable local booleana de retorno de ok

  Variable local que retornará si el dock es visible (1) o no (0).

Funcionalidad

Este comando permite conocer si un dock está o no visible o no llevando el resultado a la variable local booleana indicada en el segundo parámetro el resultado,

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Este comando solamente es válido para docks.

Ejemplo

Comprobamos si está visible el dock DOCK_PRINCIPAL llevando el resultado a la variable local VISIBLE para posteriores evaluaciones.

Interfaz: ¿es visible el dock? ( DOCK_PRINCIPAL, VISIBLE )

Interfaz: ¿está el dock flotando?

Comando de instrucción del grupo Interfaz que nos informa si el dock se encuentra flotando o no.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista docks de formulario declarados en el marco principal del proyecto. Seleccionar el dock a evaluar.

• Identificador de variable local booleana de retorno de ok

  Variable local que retornarla si el dock está flotando (1) o no (0).

Funcionalidad

Este comando permite conocer si un dock está flotando llevando el resultado a la variable local booleana indicada en el segundo parámetro.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Este comando solamente es válido para docks.

Ejemplo

Comprobamos si está el dock DOCK_UTILIDADES flotando y en caso afirmativo lo ocultamos.

Interfaz: ¿está el dock flotando? ( DOCK_UTILIDADES, FLOTANDO )
If ( FLOTANDO )
    Interfaz: ocultar el dock ( DOCK_UTILIDADES )

Interfaz: establecer posición y tamaño de dock

Comando de instrucción de proceso que nos permite establecer la posición y tamaño de un dock del marco.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista de docks de formularios declarados en el marco principal del proyecto. Seleccionar el dock a evaluar.

• Posición (opcional)

  En este parámetro podemos establecer la posición del dock. Los valores posibles son:

  • Ninguna: el dock se mantendrá en la posición en la que estaba.

  • Abajo: el dock se fijará en la parte inferior del marco.

  • Arriba: el dock se fijará en la parte superior del marco.

  • Derecha: el dock se fijará en la derecha del marco.

  • Izquierda: el dock se fijará en la parte izquierda del marco.

• Tipo de ajuste de tamaño (opcional)

  Nos permite configurar cómo se ajustará el tamaño del dock (alto si es horizontal o ancho si es vertical). Los valores posibles son:

  • Automático en base al contenido: el tamaño del dock se ajustará en base a su contenido.

  • Personalizado: personalizaremos en el comando el tamaño que va a tener el dock.

• Valor personalizado (opcional)

  Si en el parámetro tipo de ajuste hemos seleccionado el valor personalizado, aquí especificaremos el tamaño en píxels que tendrá el dock. Si éste está situado en la parte superior o inferior del marco, configuraremos la altura en píxels del dock. Si éste está situado a la izquierda o a la derecha del marco, en este parámetro especificaremos el ancho del control.

Funcionalidad

Este comando permite establecer la posición y el tamaño de un dock del marco.

Comentarios

Este comando solamente es válido para docks.

Este comando, puede ser usado tanto en manejadores de eventos como en procesos.

Usando manejadores de evento podremos usarlo para forzar por programación la funcionalidad de que un dock que se muestre plegado y se despliegue al pasar el puntero del ratón sobre él. O para aplicar una css concreta cuando un formulario abierto en la vista central de vClient gane el foco.

Para ello podemos programar conexiones de evento que se disparen con las señales Hover: entrar y Hover: salir.

Ejemplo

En nuestra aplicación usamos un formulario en un dock del marco a modo de menú y queremos que sea colapsable, es decir que se muestre plegado y que al pasar el puntero del ratón sobre el mismo, se despliegue. Para ello crearemos dos manejadores de evento:

Manejador que es ejecutará al gana el foco el dock (HOVER_IN):

Rem ( Para que se despliegue el dock lo configuraremos para que se expanda según su contenido )
Interfaz: Establecer posición y tamaño de dock ( Marco AUTOEXEC@vgest_app.MENU, Izquierda, Automático en base al contenido,  )

Manejador de evento que se ejecutará al perder el foco el dock (HOVER_OUT):

Rem ( Para colapasar el dock le daremos un ancho de 80 píxels  )
Interfaz: Establecer posición y tamaño de dock ( Marco AUTOEXEC@vgest_app.MENU, .Ninguna, Personalizado, 80 )

En el formulario que usamos como dock crearemos tres conexiones de evento:

1. Una que disparará el manejador de evento HOVER_OUT con la señal de onshow.

2. Una que disparará el manejador de evento HOVER_OUT con la señal de hover: salir.

3. Una que disparará el manejador de evento HOVER_IN con la señal de hover: entrar.

Interfaz: mostrar el dock

Comando de instrucción del grupo Interfaz que nos permite mostrar un dock que hubiese sido ocultado previamente.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista de docks de formularios declarados en el marco principal del proyecto. Seleccionar el dock a evaluar.

Funcionalidad

Este comando permite mostrar un dock.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Para ocultar un dock usaremos el comando Interfaz: ocultar el dock.

Este comando solamente es válido para docks.

Ejemplo

Mostrar los docks indicados en el caso de que el dock DOCK_PRINCIPAL no esté visible.

Interfaz: ¿es visible el dock? ( DOCK_PRINCIPAL, VISIBLE )
If ( ! VISIBLE )
    Interfaz: mostrar el dock ( DOCK_PRINCIPAL )
    Interfaz: mostrar el dock ( DOCK_FRAS )
    Interfaz: mostrar el dock ( DOCK_ALB )

Interfaz: ocultar el dock

Comando de instrucción del grupo Interfaz.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista de docks de formulario declarados en el marco principal del proyecto. Seleccionar el dock a evaluar.

Funcionalidad

Este comando permite ocultar un dock.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Para mostrar un dock usaremos el comando Interfaz: mostrar el dock.

Este comando solamente es válido para docks.

Ejemplo

Si no es administrador el usuario actual mostramos el DOCK_PRINCIPAL y ocultamos el resto de DOCKS.

If ( ! sysIsAdministrator )
    Interfaz: mostrar el dock ( DOCK_PRINCIPAL )
    Interfaz: ocultar el dock ( DOCK_INFORMES )
    Interfaz: ocultar el dock ( DOCK_UTILIDADES )

Interfaz: set dock features

Comando de instrucción del grupo Interfaz.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista docks de formulario declarados en el marco principal del proyecto. Seleccionar el dock a evaluar.

• Dock features

  Este parámetro desplegará una lista con las características que pueden ser o no activadas. Estas son:

  • Cerrable: si activamos esta propiedad, el dock podrá ser cerrado por el usuario final.

  • Movible: si activamos esta propiedad, el usuario final podrá modificar la ubicación del dock.

  • Flotante: si activamos esta propiedad, el usuario podrá podrá desanclar el dock del marco y hacerlo flotante.

  • Barra de título vertical: si activamos esta propiedad, la barra de título del dock será mostrada verticalmente, en lugar de horizontalmente.

Funcionalidad

Este comando permite establecer las características de un dock, activando o desactivando para ello, las propiedades que se muestran al desplegar el contenido del segundo parámetro

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Este comando solamente es válido para docks.

Ejemplo

Establecemos las opciones del dock de tipo formulario DOCK_FRM a cerrable, movible, flotante y con barra de título vertical.

Rem ( Dock formulario de tipo cerrable, movible, flotante y barra de título vertical )
Interfaz: set dock features ( DOCK_FRM, 1111 )

Interfaz: set dock flotante

Comando de instrucción del grupo Interfaz que permite hacer flotante un formulario configurado como dock del marco y que tenga configurada la propiedad tipo ventana con el valor dock.

Origen de la instrucción: cualquiera.

Destino del subproceso: ninguno.

Parámetros

• Identificador dock

  Este comando desplegará la lista de docks declarados en el marco principal del proyecto. Seleccionar el dock deseado. Debemos seleccionar uno que sea un formulario y que tenga configurada la propiedad tipo ventana con el valor dock.
• Fórmula de condición

  Expresión de tipo fórmula para establecer la condición que debe cumplirse para que el dock de formulario se vuelva flotante. Para facilitar su introducción podemos hacer uso del asistente para edición de fórmulas.

Funcionalidad

Este comando permite desanclar un dock y hacerlo flotante. Debe ser un formulario configurado como dock del marco y que tenga configurada la propiedad tipo ventana con el valor dock.

Comentarios

Este comando, puede ser usado tanto en manejadores de eventos.

Este comando solamente es válido para docks.

Ejemplo

Si el usuario en curso es administrador establecemos el dock DOC_FRM como flotante y si no lo es como no flotante.

If ( sysIsAdministrator )
    Interfaz: set dock flotante ( DOCK_FRM, 1 )
Else
    Interfaz: set dock flotante ( DOCK_FRM, 0 )