Nota de Aplicacin: Como implementar pantallas con iFix

Tipo de Nota Comentario

Accin Informativa
Fecha apertura 27/04/04
Fecha de
Cierre
Generada por Gustavo Cerezo
Descripcin Describe como implementar y como entender las propiedades de
pantallas en iFix

Producto Intellution
Categora Interfases graficas
Componente Workspace
Versin
Dispositivo

Cliente
Usuario Final
Contacto

Distribuir a
ndice

Tipo de Nota..............................................................................................1

Comentario...............................................................................................1

Accin.......................................................................................................1

Fecha apertura..........................................................................................1

Terminologa..............................................................................................3

Conceptos de Pantalla (Picture)................................................................3

Pantalla.....................................................................................................3

Documento...............................................................................................3

Ventana (Picture Window).........................................................................4

Viewport....................................................................................................4

Sistema de Coordenadas..........................................................................5

Introduccin..............................................................................................5
Pixels.........................................................................................................5

Unidades Lgicas (Logical Units)..............................................................5

Porcentajes...............................................................................................7

PROPIEDADES DE LAS PANTALLAS EN FIX DYNAMICS...............................7

Implementando pantallas.........................................................................7

Introduccin..............................................................................................7

Creando una pantalla nueva.....................................................................7

Eligiendo adecuadamente las unidades lgicas........................................8

Administrando las propiedades de una pantalla.......................................9

Situaciones de Ejemplos.........................................................................10

Caso 1: Creando una pantalla completa.................................................10

Caso 2: Cambiando las medidas a una ventana.....................................11

Administrando las Scrollbars...................................................................13

Creando dos pantallas idnticas.............................................................14

Operaciones avanzadas de cambio de medidas.....................................15

Usando cdigo en VBA para generar una pantalla..................................15

Operaciones de visualizacin en el Workspace.......................................18

Ajustar la pantalla a la ventana (Fit Picture to Window)..........................18

Ajustando la ventana a la pantalla (Fit Window to Picture).....................18

Zoom 200%.............................................................................................18

Zoom 50%...............................................................................................18

Terminologa
Conceptos de Pantalla (Picture)

Pantalla
Una pantalla es un tipo de objeto que se utiliza en FIX Dynamics para
proveer al usuario de una representacin grfica de diferentes objetos.
Estos objetos pueden ser formas simples, tales como rectngulos u
valos, o Controles ActiveX embebidos en el documento tales como
Sumarios de Alarma (Alarm Summary), un documento de Word o una
hoja de Excel.

La Pantalla es el contenedor de los objetos. Es el objeto ActiveX que

contiene y muestra objetos. La pantalla es el objeto cuyo icono aparece
en el rbol de navegacin (system tree). Estos conos corresponden a los
archivos con extensin *.grf que se generan cuando se guarda una
pantalla. Los objetos que son contenidos en una pantalla pueden ser
visibles o no . Si bien el objetivo de una pantalla es mostrar informacin,
no es su nico objetivo. Hay que pensar que una pantalla es un
contenedor.

Documento

Una pantalla contiene un documento. El documento es el propietario de

los objetos que han sido dibujados para que sean mostrados al usuario.
Piense en el documento como un lienzo donde usted compone las
diferentes formas y objetos que desea que se muestren.

Ventana (Picture Window)

La ventana es la parte visible donde los objetos contenidos en una

pantalla se muestran. La ventana puede ser el documento completo, o
solo parte de ste. Bajo alguna circunstancia, el autor de la pantalla
puede desear mostrar al usuario solo parte del documento, por lo que en
ese caso definir la ventana de modo de cubrir solo una porcin del
documento.

Viewport

El Viewport de una ventana es el rea que actualmente esta disponible

para mostrar objetos. El viewport excluye, por ejemplo, la barra de
ttulos de la ventana, los mens de sistema, las scrollbars y el marco de
la ventana en si mismo.

La siguiente pantalla ilustra la relacin entre estos conceptos:

 Pantalla, Documento, Ventana y ViewPort

Sistema de Coordenadas
Introduccin
De forma de poder explicar como se relacionan en FIX Dynamics las formas, las
dimensiones y las posiciones de los objetos, es necesario hacer una introduccin al
Sistema de Coordenadas.
Definicin: El Sistema de Coordenadas se conforma por reglas convencionales que se adoptan
para tomar sin ambigedad la posicin y la medida de un objeto.

Pixels
En el mundo de las computadoras, una de las unidades de medidas mas usadas y familiares
son los pixels. El pxel es la unidad bsica que se puede mostrar en una pantalla (monitor).
La resolucin de un monitor se toma a partir del nmero de pixels que se muestran a lo
ancho y lo alto de un monitor respectivamente. Las cuatro resoluciones de pantalla ms
comunes son: 640 por 480, 800 por 600, 1024 por 768 y 1152 por 882. Otras resoluciones
mayores son: 1280 por 1024 y 1600 por 1200 pixels.
Es importante notar que:

640/480 = 800/600 = 1024/768 = 1152/882 = 1.3333, o 4/3

Esto significa que todos los monitores comunes tienen la misma relacin ancho-alto de 4/3. Esto
ser importante para nuestra discusin de Sistema de Coordenadas.

Unidades Lgicas (Logical Units)

El inconveniente ms grande de utilizar un sistema de coordenadas basado en pixels, es
que ste no es independiente del dispositivo. Supongamos que quiero disear una pantalla
que ser mostrada en pantalla completa. En un monitor de 1280 por 1024 pixels deber
definir un documento de 1280 por 1024 pixels. Sin embargo, cuando vaya a utilizar esta
pantalla en la planta, si el operador tiene un monitor de 800 por 600 pixels, suceder que la
parte del documento que va entre 801 y 1280 ser entrecortado, igual que la parte de abajo
que va desde 601 hasta 1024 pixels. Estas reas pueden contener informacin que es
importante conservar, como ser alarmas. Usando unidades lgicas se resuelve este
problema, declarando el alto y el ancho de la pantalla con dos nmeros arbitrarios. Por
ejemplo, eligiendo 100 y 75 como unidades lgicas, un objeto que tenga 100 unidades
lgicas de ancho ocupar la totalidad del ancho de la pantalla, mientras que un objeto de 75
unidades de alto ocupar la totalidad del alto de la pantalla, independientemente de la
resolucin del monitor. Esto se logra realizando un clculo que es enteramente transparente
al usuario.
El ejemplo de arriba fue realizado con unidades de 100 x 75, porque estas unidades tiene un
relacin ancho-alto que es la misma que en las resoluciones normales de monitores, 4/3.
Esto simplifica la disposicin de los objetos en la pantalla. Intellution recomienda utilizar
unidades lgicas cuya relacin sea de 4/3. Sin embargo, la eleccin de las unidades lgicas
es totalmente arbitraria, y usted podr decidir que nmero, incluso con decimales, querr
que represente el ancho y el alto de la pantalla.

Porcentajes
El sistema de coordenadas en porcentajes usa dos nmeros porcentuales para expresar las
medidas de un objeto. Un porcentaje es simplemente la relacin de una medida con otra. Por
ejemplo, si pantalla completa lo representamos con 200 unidades en ancho y con 150 unidades en
alto, una ventana que es 50% ancho y 33% alto ocupar la mitad del total de la pantalla en el
ancho y una tercera parte en el alto.

PROPIEDADES DE LAS PANTALLAS EN FIX DYNAMICS

Implementando pantallas

Introduccin

En este prrafo, presentamos qu tipos de unidades se utilizan para las

propiedades de los objetos en las pantallas de FIX Dynamics. Tambin
describimos cmo manipular las propiedades de las pantallas para lograr
un resultado especfico. Para acceder a las propiedades de una pantalla
hacer click derecho sobre la ventana y seleccionar Properties Window.

El siguiente sistema de coordenadas se utiliza para las propiedades de

una pantalla:

El Alto (Height) y Ancho (Width) del Documento se expresa en unidades

lgicas.

El Alto (Height) y Ancho (Width) del Viewport se expresa en unidades

lgicas.

El Alto (Height) y Ancho (Width) de la Ventana se expresa en porcentaje

de la pantalla completa.

Creando una pantalla nueva

Una parte importante del proceso de generar una pantalla en FIX

Dynamics, es la generacin de una pantalla nueva. Crear una nueva
pantalla involucra propiedades que estn almacenadas en las
preferencias de usuario (User Preferences). Para ver estas propiedades,
seleccione User Preferences en el men Workspace, y seleccione la
lengeta Picture Setup. Las unidades lgicas usadas para generar una
pantalla nueva se muestran en los campos Ancho del Documento
(Document Width) y Alto del Documento (Document Height). El Ancho
del Documento, expresado en unidades lgicas, es el nmero elegido
para representar el ancho total de la pantalla, mientras que el Alto del
Documento representa el alto total del Documento. Es importante notar
que estos dos nmero condicionan qu unidades lgicas representaran a
una pantalla durante toda su vida, a menos que usted realice alguna de
las operaciones avanzadas que se describen luego.

Usted puede cambiar las unidades lgicas cada vez que genere una
nueva pantalla, pero cada pantalla mantendr las unidades lgicas que
le fueron asignadas cuando fue generada. Por ejemplo, si usted crea una
pantalla con unidades lgicas de 100 y 75, y otra con 200 y 150, estas
dos pantallas podrn tener la misma medida, pero la dimensin en
nmero de estos dos documentos ser diferente, aunque la medida de la
pantalla es la misma.

Eligiendo adecuadamente las unidades lgicas

Los valores por defecto para el Ancho de Documento y Alto de

Documento son 100 y 75. Esto es porque estos nmero tienen la misma
relacin de ancho y alto que las resoluciones normales de monitores
comunes. De esta forma, es fcil crear forma geomtricas especficas,
definiendo la misma dimensin para el ancho que para el alto. Por
ejemplo, se puede crear un crculo creando un valo, y cambiando el
ancho y el alto al mismo nmero, por ejemplo 20. Sin embargo, usted
podra seleccionar diferentes relaciones entre las unidades lgicas del
Ancho y el Alto del documento, por ejemplo 200 x 75. En este caso, si
usted quiere crear un crculo, usted tendr que recordar que una unidad
horizontal representa la mitad de una unidad vertical, por lo que tendr
que cambiar las propiedades del valo a 40 y 20 respectivamente.

Administrando las
propiedades de una
pantalla

Para mostrar las propiedades

de una pantalla, oprimir el botn derecho
sobre la pantalla y seleccionar
Property Window. La siguiente
figura representa una imagen de las
propiedades disponibles:
La ventana de propiedades muestra todo lo relativo a la pantalla que
esta actualmente activa en el Workspace. Cuando cree una nueva
pantalla, el Ancho del Documento y el Alto del Documento son los que se
especificaron en las preferencias de usuario. Usted puede cambiar las
dimensiones del documento en la ventana de propiedades, pero el
nmero que usted vio all cuando cre la pantalla, corresponde a las
dimensiones de pantalla completa. Es importante sealar que las
pantallas, generalmente, son utilizadas en modo de pantalla completa.
En este modo, el Workspace no muestra su ventana, ni sus mens, ni
sus toolbars. En modo Pantalla Completa, usted tendr acceso a la
totalidad de su pantalla para mostrar la informacin. Por esta razn,
podr ver que aparecen las scrollbar en su ventana cuando desarrolla en
vista normal (no en Full Screen).

En modo pantalla completa, el Workspace no muestra su ventana, ni la

barra de tareas, ni el borde de la ventana, ni los mens, ni las toolbars ni
el rbol de navegacin.

En modo de vista normal, para que el Workpace pueda hacer que todo
se vea en la pantalla, nuestra ventana aparecer con scrollbars, y habr
una parte que no estaremos viendo, pero recordar que en pantalla
completa tendremos acceso a este espacio nuevamente.
Situaciones de Ejemplos

Caso 1: Creando una pantalla completa

Para entender mejor como se muestra una pantalla en el Workspace

cuando se genera desde cero, modifique el Workspace de modo que este
no ocupe la pantalla completa. En las preferencias de usuario (User
Preferences) asegrese que la medida de ventana este en Full Screen, y
que el Ancho y Alto de documento sean 100 y 75 respectivamente. Cree
una nueva pantalla seleccionando New FIX Picture desde el men
File. La pantalla se ver aproximadamente as:
Ntese que cuando cre la pantalla, la ventana de la pantalla es
generada ocupando todo el espacio disponible en la ventana del
Workspace, excluyendo la barra de ttulos, la barra de estado, el rbol de
navegacin, los mens y las toolbars. Sin embargo, se puede ver que
tiene scrollbars, porque el documento ha sido generado para ocupar la
pantalla completa. Para mostrar el documento en pantalla completa
deber seleccionar Full Screen en el men Workspace. Las scrollbars
en la ventana de la pantalla desaparecen mientras que la pantalla se
ajusta exactamente en la medida del documento.

Caso 2: Cambiando las medidas a una ventana

Con las preferencias de usuario igual que en el caso anterior, crear una
nueva pantalla. Abrir las propiedades de la pantalla haciendo click
derecho en la ventana de la pantalla. El ancho y el alto del documento
debera ser 100 y 75 respectivamente. Cambie a 50 el ancho y a 40 el
alto. Para poder visualizar mejor el cambio de las medidas de la ventana,
inserte
algunos
objetos
como
rectngulos
en ella. La
pantalla se
deber ver

aproximadamente as:

Cambie la medida de la ventana haciendo click en la esquina inferior

derecha y desplazando el mouse de modo de modificar la medida de la
pantalla; la ventana automticamente modificar sus medidas y se
mantendr con sus nuevas medidas cuando suelte el botn del mouse.
En la ventana de propiedades, el ancho y el alto del documento se
conservan, mientras que la propiedad WindowWidthPercentage,
WindowHeightPercentage, ViewportWidth y ViewportHeight se modifican
de acuerdo a la nueva medida de la ventana. Notar que las scrollbars
aparecen en la parte de abajo y en la parte derecha del documento, esto
ser as hasta que el viewport cubra la totalidad del rea del documento.

En este punto, su pantalla deber lucir aproximadamente as:

Administrando las Scrollbars

Cuando se disminuye la medida de la pantalla arrastrando el borde en

alguna direccin, aparecen dos scrollbars. Por ejemplo, si se repite la
operacin del caso previo, desplazando hacia arriba el borde inferior de
la ventana, una scrollbar aparecer en el lado derecho debido a que el
viewport no es suficiente para cubrir la totalidad de la altura del
documento. Inmediatamente, otra scrollbar aparece en la parte inferior
de la ventana debido a que la scrollbar que se encuentra a la derecha
esta ocupando espacio de el viewport impidiendo que este ocupe la
totalidad del documento. Recordemos que el rea del viewport excluye
cualquier elemento que sea parte de la ventana de la pantalla.

Para impedir este efecto, una vez que cambi la medida de la altura,
extienda el ancho de la ventana desplazando el borde derecho hacia el
lado exterior. Esto tendr como efecto que se incrementar el ancho del
viewport hasta cubrir la totalidad del ancho del documento, por lo tanto
removiendo las scrollbars horizontales.

Luego de esto, su pantalla deber lucir aproximadamente as:

Creando dos pantallas idnticas

En algunos casos, puede ser interesante generar dos pantallas de la

misma medida. Para obtener dos pantallas de la misma medida, crear la
primera pantalla y cambiar sus propiedades de acuerdo al aspecto que
deseamos que tenga. Crear una segunda pantalla, utilizando el mismo
seteo en User Preferences que se utiliz para la primera. Utilizar la
ventana de propiedades para copiar las propiedades DocumentWidth,
DocumentHeight, WindowWidthPercentage y WindowHeightPercentage
de la pantalla original a la nueva pantalla. El viewport del nuevo
documento cambiar automticamente luego que modifiquemos las
propiedades del documento y la ventana.
Cambiando la medida del documento desde su ventana

En lugar de ingresar manualmente los datos en la ventana de

propiedades, puede desear hacerlo modificando el ancho y el alto del
documento, con lo cual el viewport se ajustar a la nueva ventana. Para
realizar esta operacin, cambie la medida de la pantalla manteniendo
presionada la tecla Shift. El documento automticamente ajustar su
medida para mostrarse completamente en la nueva medida de ventana.

Operaciones avanzadas de cambio de medidas

El Workspace de FIX Dynamics dispone de una operacin que permite

preservar las unidades del documento, mientras se modifica su aspecto.
Debemos ser concientes de que esta operacin altera las unidades
lgicas, es decir la relacin 4/3 ancho alto. Para hacer uso de esta
operacin, mantenga presionado Ctrl+Shift mientras cambia las
medidas de la pantalla. Esta modificacin no queda guardado en la cola
de Volver Atrs (Undo) por lo que no ser posible volver atrs esta
modificacin.

Usando cdigo en VBA para generar una pantalla

Se puede utilizar scripts en VBA para generar una pantalla en el

Workspace de FIX Dynamics. Por ejemplo, si desea crear un botn en
una toolbar que automticamente genere una nueva pantalla con ciertas
caractersticas, deber definir un botn de usuario y colocar el siguiente
script en el evento Click:

Dim iNewDoc As Object

Dim iPage As Object

Set iNewDoc = Application.documents.Add("FIX.PICTURE")

Set iPage = iNewDoc.Page

With iPage

' Set the document height

.DocumentHeight = 50#

' Set the document width

.DocumentWidth = 100#
 ' This places the picture 15 percent from the top of the
client area

.WindowTopPercentage = 15#

' This places the picture against the left border of the
workspace

.WindowLeftPercentage = 0#

' If you are making it bigger than it was this will expand

' to get rid of scrollbars

.FitWindowToDocument

End With

' These two statements free up the objects for a later close or
delete

' (not always necessary, but a good practice)

Set iNewDoc = Nothing

Set iPage = Nothing

End Sub

Cada vez que haga click sobre este botn en la toolbar, se generar una
pantalla nueva idntica.
Operaciones de visualizacin en el Workspace
Ajustar la pantalla a la ventana (Fit Picture to Window)

Seleccionando este comando se ajustar el Ancho y el Alto del

documento de modo que el Viewport de la ventana activa cubrir la
totalidad del rea del documento.

Ajustando la ventana a la pantalla (Fit Window to Picture)

Seleccionando este comando expandir la ventana, de modo que el viewport cubrir la totalidad del
documento, haciendo que las scrollbars desaparezcan. Si el Viewport ya esta cubriendo la totalidad
de documento, este comando no afectar en nada.

Zoom 200%
Utilizando este comando, se producir un zoom hacia el interior de la ventana, de modo de
poder trabajar en su interior con un mayor grado de detalle. El ViewportWidth y el
ViewportHeight se vern afectando por un factor de 0.5, pero no aparecern las scrollbar.

Zoom 50%
Utilizando este comando, se producir un zoom hacia los lmites exteriores de la ventana,
de modo de tener una vista mas amplia del documento. El ViewportWidth y el
ViewportHeight sern multiplicados por un factor de 2 pero ninguna scrollbar desaparecer.
Este es el nico caso en el cual el ViewportWidth y el ViewportHeight son mayores que el
DocumentWidth y el DocumentHeight, y los lmites del documento actual no se vern
materializados dentro de la ventana.