How Does an Application Work?

Marinas-Gui is a library for creating Windows-based graphics programs that contain controls. These controls trigger actions based on events allowed for each control.
Marinas-GUI es una librería para crear programas gráficos basados en Ventanas que contienen controles. Estos controles disparan acciones en base a los eventos permitidos por cada control.

Any Marinas-Gui application should have a main window called MAIN which must remain ACTIVATED throughout the execution of the program and is generally the window where you set the application's main menu, toolbar and status bar.
Toda aplicacion Marinas-GUI debe tener una ventana principal llamada MAIN que debe permanecer ACTIVADA durante toda la ejecución del programa y es generalmente la ventana en donde se define el menu principal de la aplicacion, la barra de herramientas y la barra de estado.

When a control triggers an action (we will call it the event hereafter), program flow moves from the current window to the program code that executes the required actions and then program flow returns to the window in which the event occurred.
Cuando un control dispara una acción (la llamaremos evento de aquí en más), el flujo del programa pasa de la ventana actual al código del programa para ejecutar la o las acciones requeridas y luego retornar a la ventana que produjo el evento.

Instead of doing a quick or "short" task, there are some events that call an entire branch of our application which sometimes creates a new window with a new set of controls. Depending on what type of window is set in this event, control may or may not return immediately to the window that triggered this event.
Hay algunos eventos que en lugar de una taréa rápida o "corta", invocan toda una rama de nuestra aplicación y generalmente utilizan una nueva ventana con sus nuevos controles. Dependiendo de que tipo de ventana se defina en dicho evento, el control puede volver inmediatamente a la ventana que produjo el evento o no.

There exist several possible sub windows types, but in Marinas-GUI we can use only two of these window types:

CHILD Window

MODAL WIndow

.
Existen varios tipo de sub ventanas, actualmente, en Marinas-GUI podemos utilizar dos tipos:

Ventanas CHILD

Ventanas MODAL

.

CHILD Window: These windows are created and displayed on the screen by a calling window that triggers the window creation event. Program flow then immediately returns to the calling window unless it is expressly prevented.
These windows have an operation similar to the main window, but their behavior does not depend on other application windows.
If an application creates multiple child windows of the MAIN application window then you can use any window or window control without having to follow a specific sequence to work through an application.
Ventana CHILD: estas ventanas se representan en la pantalla pero el flujo del programa vuelve inmediatamente (salvo que uno lo evite de exprofeso) a la ventana que disparó el evento que la creó.
Estas ventanas tienen un funcionamiento similar a la ventana main, o sea, tienen un comportamiento que no depende de otra ventana.
Si una aplicacion crea varias ventanas CHILD desde la MAIN, se podrían utilizar los controles de cualquiera de las ventanas sin tener que respetar un orden específico.

MODAL Window: This type of window takes control of the program flow preventing the user from interacting with any other application window that is currently open. A MODAL window is dependent on the window that created it (i.e., if the main window is minimized then the MODAL window will also be minimized). When the modal window is closed, the application returns control to the window that created it (which may be another modal window). These windows are generally used for the entry of small data sets and often serve to convey messages to users (they are known as DIALOG windows). The use of a MODAL window halts the calling application until the user closes the MODAL window.
Ventana MODAL: Este tipo de ventana toma el control del flujo del programa impidiendo que el usuario pueda utilizar la ventana que la ha generado. Son dependientes de la ventana que la ha creado (por ej: si la ventana creadora es minimizada desde el programa, esta ventana MODAL tambien se minimizará con ella). Cuando la ventana MODAL es cerrada, el control de la aplicación vuelve a la ventana que la había creado (que puede ser otra ventana MODAL). Estas ventanas, generalmente, son utilizada para el ingreso de un grupo pequeño de datos (se las conoce como DIALOG) o para actividades que requieren que el resto de la aplicacion no este disponible para el usuario mientras estamos realizando alguna actividad.

Go to the topic Main Window and Others for a complete description of the associated properties and methods.
Vaya al tópico Main Window and Others para una completa descripción de sus propiedades y métodos.

Marinas-GUI Version 03.06 and
Marinas-IDE Version 05.06 and
LEX Files Version 02.06

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
last update: April 27
2017
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

A Harbour/QT framework to make multiplatform programs

(©) Copyright 2009-2017 by Fernando Santolin (aka CarozoDeQuilmes)
CarozoDeQuilmes@gmail.com

2009-2017 Beta tester and full English translator: Bruno Luciani
Bruno.Luciani@gmail.com

2014-2015 Final English corrector: David Worboys
DavidWorboys@hotmail.com

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

www.marinas-gui.org

www.marinas-gui.org