VMainWindow
Esta clase nos crea un único objeto theMainWindow. Nos da acceso a las funciones de manejo de la ventana principal de la aplicación.
Está disponible en procesos javascript en primer plano, manejadores de eventos javascript y QML.
String fileDialogGetExistingDirectory( String caption, String dir, Number optionFlags = ShowDirsOnly )
String fileDialogGetOpenFileName( String caption, String dir, String filter, String selectedFilter = 0, Number optionFlags = 0 )
Array de Strings fileDialogGetOpenFileNames( String caption, String dir, String filter, String selectedFilter = 0, Number optionFlag = 0 )
String fileDialogGetSaveFileName( String caption, String dir, String filter, String selectedFilter = 0, Number optionFlags = 0 )
Inicializado
On Close
Pre inicialización
Pre-vista eliminada
Vista activada
Vista añadida
Vista eliminada
Personaliza los botones y la barra de título de la ventana.
Parámetros:
- nFlags: ver enum de personalización de la barra de título. Los valores con combinables mediante el uso del operador bitwise or booleano "|".
Devuelve el alto en píxeles de la ventana.
Oculta la ventana.
Devuelve true si la ventana está a pantalla completa.
Devuelve true si la ventana está maximizada.
Devuelve true si la ventana está minimizada.
Devuelve true si la ventana es visible.
Mueve la ventana a la posición especificada.
Parámetros:
- x: posición horizontal en píxeles, contando desde la esquina superior izquierda.
- y: posición vertical en píxeles, contando desde la esquina superior izquierda.
Modifica el tamaño de la ventana.
Parámetros:
- nWidth: ancho de la ventana en píxeles.
- nHeight: alto de la ventana en píxeles.
Cambia la hoja de estilo (CSS) que se aplicará a la ventana.
Parámetros:
- szCssText: texto con el CSS a aplicar.
Cambia el título de la ventana.
Parámetros:
- szTitle: texto del nuevo título de la ventana.
Muestra la ventana si está oculta.
Visualiza la ventana en modo a pantalla completa.
Visualiza la ventana en modo maximizada.
Visualiza la ventana en modo minimizada.
Visualiza la ventana en modo normal.
Devuelve la hoja de estilo (CSS) que se está aplicando a la ventana.
Devuelve el título de la ventana.
Devuelve el ancho en píxeles de la ventana.
Devuelve la posición x de la ventana, píxeles contados desde la esquina superior izquierda.
Devuelve la posición y de la ventana, píxeels contados desde la esquina superior izquierda.
Devuelve el objeto que está dentro del dock especificado, de una de las clases derivadas de VAbstractDataView.
Parámetros:
- szIdPrimarioDock: identificador del dock.
Devuelve un objeto de la clase VToolbar (*) que está dentro del dock especificado.
Parámetros:
- szIdPrimarioDock: identificador del dock.
(*) Esta clase todavía no se encuentra disponible
Oculta el dock.
Parámetros:
- szIdPrimarioDock: identificador del dock.
Devuelve true si el dock está flotante.
Parámetros:
- szIdPrimarioDock: identificador del dock.
Devuelve true si el dock está visible.
Parámetros:
- szIdPrimarioDock: identificador del dock.
Modifica las características del dock.
Parámetros:
- szIdPrimarioDock: identificador del dock.
- nFeatures: ver enum de características del dock. Los valores con combinables mediante el uso del operador bitwise or booleano "|".
Fija el dock como flotante.
Parámetros:
- szIdPrimarioDock: identificador del dock.
- bSet = true para activarlo como flotante, false para desactivarlo como flotante.
Muestra el dock.
Parámetros:
- szIdPrimarioDock: identificador del dock.
Añade una acción a la barra de menú.
Parámetros:
- idRefAction: idRef del objeto Acción.
Añade un menú a la barra de menú.
Parámetros:
- idRefMenu: idRef del objeto Menú.
Añade un separador a la barra de menú.
Añade una opción de menú en stock a la barra de menú.
Son validos todos los menús en stock salvo StockMenuAlternativeViews y StockMenuBaskets.
Parámetros:
Limpia todos los subobjetos que contenga la barra de menús.
Oculta la barra de menú.
En macOS no se puede ocultar la barra de menús ya que la barra de menú no se crea en la aplicación sino que se integra en la propia barra de menú del sistema operativo y ésta sólo se oculta si la oculta el propio sistema, no e posible ocultarla desde la aplicación Velneo.
Inserta una acción en una posición específica de la barra de menú.
Parámetros:
- pos: número que indica la posición de inserción.
- idRefAction: idRef del objeto Acción.
Inserta un menú en una posición específica de la barra de menú.
Parámetros:
- pos: número que indica la posición de inserción.
- idRefMenu: idRef del objeto Menú.
Inserta un separador en una posición específica de la barra de menú.
Parámetros:
- pos: número que indica la posición de inserción.
Inserta una opción de menú en stock en una posición específica de la barra de menú.
Son validos todos los menús en stock salvo StockMenuAlternativeViews y StockMenuBaskets.
Parámetros:
- pos: número que indica la posición de inserción.
Devuelve true si la barra de menú está visible. Solamente es válida para Windows y para Linux; no es válida para el resto de las plataformas por el modo en el que la gestionan.
Muestra la barra de menú.
Ejecuta la acción especificada en el parámetro.
Parámetros:
- szIdRefAction: identificador de referencia (proyecto/identificador) correspondiente al objeto de tipo acción que será ejecutado.
Limpia el mensaje que se está mostrando en la barra de estado.
Devuelve el mensaje que se está mostrando en la barra de estado.
Oculta la barra de estado si está visible.
Devuelve true si está visible el grip de cambio de tamaño de la ventana.
Devuelve true si la barra de estado está visible.
Habilta o deshabilita el grip de cambio de tamaño de la ventana.
Parámetros:
- bSet: true para habilitar el grip de la cambio de tamaño, false para deshabilitar.
Muestra un mensaje en la barra de estado.
Parámetros:
- szMsg: mensaje de texto a mostrar en la barra de estado.
- nMiliSegsTimeout: tiempo en milisegundos que estará visible, por defecto 0 = no se oculta el mensaje.
Muestra la barra de estado si está oculta.
Abre una nueva vista visualizando la lista de registros especificada en el tipo de objeto con el identificador de referencia especificado en los parámetros y devuelve el objeto de la vista creada.
Parámetros:
- idRefObj: idRef (Proyecto/Identificador) del objeto a visualizar.
Abre una nueva vista visualizando el registro especificado en el tipo de objeto con el identificador de referencia especificado en los parámetros y devuelve el objeto de la vista creada.
Parámetros:
- idRefObj: idRef (Proyecto/Identificador) del objeto a visualizar.
Abre una nueva vista visualizando un control HTML que visualizará la URL pasada en el parámetro y devuelve el objeto de la vista creada.
Parámetros:
- url: senda de la página o fichero a visualizar.
Cierra todas las vistas.
Cierra la vista en curso.
Cierra la vista correspondiente al objeto pasado en el parámetro.
Parámetros:
- view: objeto con la vista a cerrar.
Cierra la vista correspondiente al índice indicado en el parámetro.
Parámetros:
- index: número ordinal de la vista que deseamos cerrar.
Parámetros:
Aplica el interfaz MDI en cascada.
Aplica el interfaz MDI en mosaico.
Hace visible la siguiente vista a la vista en curso.
Hace visible la vista previa a la vista en curso.
Fijar el modo de interfaz de documento de la ventana.
Parámetros:
Activa como la vista en curso la vista pasada en el parámetro.
Parámetros:
- view: objeto con la vista en curso a activar.
Devuelve el número de vistas abiertas.
Muestra el cuadro de diálogo de cambio de contraseña del usuario.
Ocultar el dock que muestra los procesos en ejecución en segundo plano.
Mostrar el dock que muestra los procesos en ejecución en segundo plano.
Conmuta el dock que muestra los procesos en ejecución en segundo plano. Si está visible lo oculta o viceversa.
Devuelve el directorio seleccionado en el cuadro de diálogo.
Parámetros:
- caption: nombre del directorio seleccionado que queremos que aparezca escrito por defecto.
- dir: directorio por defecto que visualiza.
- optionFlags: configuración del cuadro de diálogo y del filtrado de ficheros. Ver enum de flags de cuadro de diálogo de ficheros, por defecto se muestran solo directorios.
Devuelve el fichero seleccionado en el cuadro de diálogo.
Parámetros:
- caption: nombre del fichero seleccionado que queremos que aparezca escrito por defecto.
- dir: directorio por defecto que se visualiza.
- filter: filtro de ficheros o extensiones a mostrar. múltiples filtros se deben separar por ";;". Por ejemplo: "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"
- selectedFilter: cuál de los filter aparecerá seleccionado inicialmente en el combobox.
- optionFlags: configuración del cuadro de diálogo y del filtrado de ficheros. Ver enum de flags de cuadro de diálogo de ficheros.
Devuelve una lista de ficheros seleccionados en el cuadro de diálogo.
Parámetros:
- caption: nombre del fichero seleccionado que queremos que aparezca escrito por defecto.
- dir: directorio por defecto que se visualiza.
- filter: filtro de ficheros o extensiones a mostrar. múltiples filtros se deben separar por ";;". Por ejemplo: "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"
- selectedFilter: cuál de los filter aparecerá seleccionado inicialmente en el combobox.
- optionFlags: configuración del cuadro de diálogo y del filtrado de ficheros. Ver enum de flags de cuadro de diálogo de ficheros.
Devuelve el nombre del fichero a guardar especificado en el cuadro de diálogo.
Parámetros:
- caption: nombre del fichero seleccionado que queremos que aparezca escrito por defecto.
- dir: directorio por defecto que se visualiza.
- filter: filtro de ficheros o extensiones a mostrar. múltiples filtros se deben separar por ";;". Por ejemplo: "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"
- selectedFilter: cuál de los filter aparecerá seleccionado inicialmente en el combobox.
- optionFlags: configuración del cuadro de diálogo y del filtrado de ficheros. Ver enum de flags de cuadro de diálogo de ficheros.
Ejemplo:
theMainWindow.fileDialogGetSaveFileName("Save File", "/home/jana/untitled.png", "Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)", "Images (*.png *.xpm *.jpg)")
// Escribiendo el título directamente
theMainWindow.setWindowTitle( "Nuevo título" );
// Usando variables
var szTitulo = "Aplicación " + szAppName;
theMainWindow.setWindowTitle( szAppName );
theMainWindow.setBootMode(1);
// Barra de titulo vertical + Cerrable
theMainWindow.setDockFeatures( "DOCK_MAIN", 0x09 );
// -----------------------------------------------------------
// Muestra u oculta un dock en función de si está visible o no
// -----------------------------------------------------------
if ( theMainWindow.isDockVisible( "DOCK_MAIN" ) )
{
theMainWindow.hideDock( "DOCK_MAIN" );
}
else
{
theMainWindow.showDock( "DOCK_MAIN" );
};
theMainWindow.customizeWindowHint(0x01|0x02|0x04|0x08);
// --------------------------------------------------------------------------------
// Busca una vista con el título y si la encuentra la habilita
// Si no la encuentra ejecuta la acción
//
// El proceso recibe 2 parámetros a través de las variables locales
// TITULO = Título de la pestaña
// ACCION = Acción a ejecutar
// --------------------------
var numVistas = theMainWindow.viewsCount();
var ejecutar = true;
for ( i = 0; i < numVistas + 1; i++ )
{
var vista = theMainWindow.currentView()
if ( vista.title() == theRoot.varToString( "TITULO" ) )
{
ejecutar = false;
}
else
{
theMainWindow.nextView();
};
}
// Si no se ha encontrado se lanza la acción para abrir la vista y se retorna true (para seguir)
if ( ejecutar == true )
{
theMainWindow.runAction( theRoot.varToString( "ACCION" ) );
};
/**
* --------------------------------------------------------------------------------
* Deshabilita los controles del formulario
*
* @param {VFormDataView} formularioParam Formulario a procesar
* --------------------------------------------------------------------------------
*/
var deshabilitaControles = function ( formularioParam )
{
if ( formularioParam )
{
var tiposEnabled = [ VMainWindow.WTypeDataView, VMainWindow.WTypeMdiView,
VMainWindow.WTypeWebView, VMainWindow.WTypeTabWidget,
VMainWindow.WTypeStackedWidget, VMainWindow.WTypeToolBox,
VMainWindow.WTypeSplitter, VMainWindow.WTypeGroupBox ];
var control;
for ( var numControl = 0; numControl < formulario.controlCount(); numControl++ )
{
control = formulario.control( numControl );
if ( control )
{
tipo = theMainWindow.widgetType( control );
if ( tiposEnabled.indexOf( tipo ) === -1 )
{
control.enabled = false;
};
};
};
};
};
Última actualización 1yr ago