FOXRIBON

FOXRIBBON

Autor: Guillermo Carrero

Documentación: Walter R. Ojeda Valiente

Abril de 2012

INDICE

¿Qué es FoxRibbon? ................................................ 1

¿Qué es un menú de tipo ribbon? ................................... 1

¿Quién desarrolló FoxRibbon? ...................................... 1

¿Quién escribió esta documentación? ............................... 1

¿Cuánto cuesta FoxRibbon? ......................................... 1

¿Qué necesito descargar para poder utilizar FoxRibbon? ............ 1

¿Cómo hago para ver un demo de FoxRibbon? ......................... 1

¿Qué necesito conocer para poder usar FoxRibbon? .................. 1

¿Cuáles son las librerías de clases que usa FoxRibbon? ............ 2

¿Qué debo escribir en mi programa principal, MAIN.PRG o similar? .. 2

¿Cuáles son las clases visuales que puedo utilizar? ............... 3

¿Cómo agrego FoxRibbon a mi formulario? ........................... 4

¿Cómo se ve lo que hemos hecho hasta aquí? ........................ 6

¿Cómo le agrego una barra de títulos al menú ribbon? .............. 7

¿Por qué usar una barra de títulos propia y no usar simplemente

la que tienen los formularios? .................................... 9

¿Cómo hago para cambiar el color del texto y el tipo de letra? .... 10

¿Cómo le agrego una barra de estado a mi formulario? .............. 11

¿Cómo le agrego un botón de inicio a mi formulario? ............... 13

¿Cómo le agrego pestañas al menú Ribbon? .......................... 15

¿Cómo le muestro las opciones al usuario cuando hace click sobre

una pestaña? ...................................................... 18

¿Cómo creo mis propias clases visuales para mostrar las opciones? . 19

¿Cuáles serían los pasos a seguir? ................................ 19

¿Para qué sirve cada una de las clases de FoxRibbon? .............. 20

¿Un consejo final? ................................................ 23

¿Y si tengo dudas o consultas? .................................... 23

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 1 -

¿Qué es FoxRibbon?

Es una librería de clases .VCX que puede ser utilizada por los programadores de

Visual FoxPro y que fue realizada 100% en este lenguaje. Sirve para mostrar en las

aplicaciones menús de tipo ribbon y además provee una serie de herramientas para

mejorar el aspecto visual de las aplicaciones.

¿Qué es un menú de tipo ribbon?

Los menús de tipo ribbon (o de cinta, en castellano) son los utilizados en las

últimas versiones de los programas de Microsoft Office, como se ve a continuación:

¿Quién desarrolló FoxRibbon?

Guillermo Carrero, de Barcelona, España.

¿Quién escribió esta documentación?

Walter R. Ojeda Valiente, de Asunción, Paraguay

¿Cuánto cuesta FoxRibbon?

Es gratis.

¿Qué necesito descargar para poder utilizar FoxRibbon?

El archivo FoxRibbon.rar, el cual debes descomprimir en cualquier carpeta que

desees, por ejemplo en:

C:\FoxRibbon\

Podrás descargar a FoxRibbon.rar desde:

http://sites.google.com/site/foxribbonclass/

Importante: FoxRibbon utiliza a System.app

¿Cómo hago para ver un demo de FoxRibbon?

Ejecuta el programa FoxRibbon.exe

¿Qué necesito conocer para poder usar FoxRibbon?

1. Visual FoxPro en general

2. Creación de clases visuales

Si no tienes un conocimiento al menos regular de Visual FoxPro no es mucho lo

que podrás obtener de FoxRibbon ya que te trancarás a cada rato.

Si no sabes crear clases visuales en Visual FoxPro, entonces solamente podrás

utilizar las clases que ya están diseñadas (que son muy pocas) y no podrás

diseñar tus propias clases, personalizadas a tu propio gusto.

En otras palabras, si no conoces bastante bien los dos puntos anteriores,

FoxRibbon no es para ti.

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 2 -

¿Cuáles son las librerías de clases que usa FoxRibbon?

Si entras en la carpeta \VCX verás que hay dos librerías de clases:

FoxRibbon

MyDesigns

La primera (FoxRibbon) es la que debes usar siempre, sí o sí, cuando quieras

crear un menú de tipo ribbon. La segunda (MyDesigns) contiene las diversas opciones

que le mostrarás a los usuarios. Su nombre no es obligatorio, o sea que puedes

renombrarla o crear tu propia librería de clases, por ejemplo llamándola: MisClases

¿Qué debo escribir en mi programa principal, MAIN.PRG o similar?

SET CLASS TO FOXRIBBON ADDITIVE

SET CLASS TO MYDESIGNS ADDITIVE

DO SYSTEM.APP

if VarType(_Screen.oRibbon) == "O"

_Screen.RemoveObject("oRibbon")

endif

_Screen.NewObject("oRibbon", "RibbonSettings")

with _Screen.oRibbon

.Language = "Español"

*--Calendario

.c_FirstDayWeek = 2

*--Días feriados de la semana

.c_1SunHoli = .T.

.c_2MonHoli = .F.

.c_3TueHoli = .F.

.c_4WedHoli = .F.

.c_5ThuHoli = .F.

.c_6FriHoli = .F.

.c_7SatHoli = .T.

endwith

FoxRibbon es la librería de clases que necesitarás sí o sí para que puedas tener

en tu formulario un menú de tipo ribbon. MyDesigns es la que contiene tus propios

diseños e inclusive es conveniente que la renombres o que crees tu propia librería, para

no interferir con versiones futuras que vayan surgiendo de FoxRibbon.

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 3 -

¿Cuáles son las clases visuales que puedo utilizar?

El nombre de cada una de ellas y su utilidad lo encontrarás al final de este

documento, algunas de ellas puedes verlas a continuación:

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 4 -

¿Cómo agrego FoxRibbon a mi formulario?

1. Crea un formulario en blanco

2. En Form Controls elige Add…

3. Agrégale la librería de clases FoxRibbon.vcx

4. A tu formulario agrégale la clase Ribbon

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 5 -

5. Y verás algo como esto:

Tranquilo, no te desesperes, ya sé que parece chino, pero enseguida lo

entenderás.

6. Si ahora haces click sobre esa clase con el botón derecho, eliges

“Properties…” y luego “Other”, verás lo siguiente:

Si miras las últimas líneas verás las propiedades:

FirstTabClick

YourStartButton

YourStatusBar

YourTitleBar

De las cuatro, la única obligatoria es FirstTabClick, que servirá para indicarle

cual será la pestaña que estará habilitada al iniciar el programa.

YourStartButton sirve para indicar el nombre de la clase que llama el botón de

inicio (si hay un botón de inicio, claro)

YourStatusBar sirve para indicar el nombre de la clase que muestra una barra de

estado (si hay una barra de estado, por supuesto)

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 6 -

YourTitleBar sirve para indicar el nombre de la clase que muestra la barra de

título (si hay una barra de título, desde luego)

¿Cómo se ve lo que hemos hecho hasta aquí?

Si ejecutas tu formulario verás algo como esto:

O sea, nada muy útil hasta ahora, pero iremos avanzando hasta tener un menú

totalmente funcional.

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 7 -

¿Cómo le agrego una barra de títulos al menú ribbon?

Tienes dos formas, debes elegir UNA de ellas, no ambas:

Desde afuera del menú Ribbon

1. Haces click sobre el formulario

2. En la ventanita de “Form Controls” haces click sobre la opción “_titlebar”

3. Haces click sobre el formulario (arriba de él, pero NO en la barra de títulos)

Y verás algo como:

Donde en la parte superior apareció una barra con el texto “Label1”

4. Ahora, para ponerle un título a nuestro menú lo que hacemos es cambiar la

propiedad “Caption” de nuestro formulario.

Autor: Guillermo Carrero Documentación: Walter R. Ojeda Valiente

- 8 -

Recuerda: es la propiedad “Caption” del formulario la que cambias.

Queremos ver como nos está quedando, así que ejecutamos el formulario y

vemos esto:

Bueno, bueno, bueno, ya está tomando forma, al menos ya tenemos el título y

los botones de Minimizar, Maximizar y Cerrar el formulario

¿Y si no quiero tener los botones de Minimizar, Maximizar y Cerrar?

Muy simple, esos botones son los que tienes definidos en las propiedades de tu

formulario, si no quieres verlos entonces simplemente les colocas el valor .F.

Recuerda: los botones que serán visibles los determinas en las propiedades de tu

formulario.

5. Para cambiar la apariencia de la barra de títulos:

1. Para cambiar alguna de las propiedades de la barra de título (el color

de fondo, si es transparente o no, el tamaño, etc.),

...