Documentación de FoxRibbon Camf

 

29/12/2018

Actualizado el 07/04/2020

 

Documentación FoxRibbon Camf

Autor: Guillermo Carrero (D.E.P.)

Renovación y ampliación: César A. Mallo Fernández

Documentación: Walter R. Ojeda Valiente y César A. Mallo Fernández

Sistema operativo utilizado en la documentación: Windows 10

Diciembre de 2018

La documentación es una revisión del magnifico manual de Walter R. Ojeda Valiente adaptado a FoxRibbon Camf

 

Contenidos

  1. ¿Qué es FoxRibbon?
  2. ¿Qué es un menú de tipo ribbon?
  3. ¿Quién desarrolló FoxRibbon?
  4. ¿Quién renovó y amplió FoxRibbon?
  5. ¿Quién escribió esta documentación?
  6. ¿Cuánto cuesta FoxRibbon?
  7. ¿Qué necesito descargar para poder utilizar FoxRibbon?
  8. ¿Cómo hago para ver un demo de FoxRibbon?
  9. ¿Qué necesito conocer para poder usar FoxRibbon?
  10. ¿Cuáles son las librerías de clases que usa FoxRibbon Camf?
  11. ¿Qué debo escribir en mi programa principal, MAIN.PRG o similar?
  12. ¿Cuáles son las clases visuales que puedo utilizar?
  13. ¿Cómo agrego un formulario de nivel superior para crear una aplicación?
  14. ¿Cómo agrego una cinta Ribbon a mi formulario?
  15. ¿Cómo se ve lo que hemos hecho hasta aquí?
  16. ¿Cómo le agrego una barra de títulos al formulario?
  17. ¿Por qué usar una barra de títulos propia y no usar simplemente la que tienen los formularios?
  18. ¿Cómo hago para cambiar el color del texto y el tipo de letra?
  19. ¿Cómo le agrego una barra de estado a mi formulario?
  20. ¿Cómo le agrego un botón de inicio a mi formulario?
  21. ¿Cómo le agrego pestañas al menú Ribbon?
  22. ¿Cómo le muestro las opciones al usuario cuando hace click sobre una pestaña?
  23. ¿Cómo creo mis propias clases visuales para mostrar las opciones?
  24. ¿Cuáles serían los pasos a seguir?
  25. ¿Para qué sirve cada una de las clases de FoxRibbon?
  26. ¿Un consejo final?
  27. ¿Y si tengo dudas o consultas?
  28. Referencias

 

¿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.

Vea también Definición de Ribbons o Cintas

 

¿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:

Vea también en la pestaña Framework Ribbons - Cintas

 

¿Quién desarrolló FoxRibbon?

Guillermo Carrero, de Barcelona, España.

 

¿Quién renovó y amplió FoxRibbon?

César A. Mallo Fernández de León, España. A fecha de 01 Enero 2019 FoxRibbon Camf 0.34

 

¿Quién escribió esta documentación?

Walter R. Ojeda Valiente, de Asunción, Paraguay y César A. Mallo Fernández de León, España.

 

¿Cuánto cuesta FoxRibbon

Es gratis.

 

¿Qué necesito descargar para poder utilizar FoxRibbon?

El archivo FoxRibbon.rar, el cual debe descomprimir en cualquier carpeta que desee, por ejemplo en:

C:\FoxRibbon\

Recomiendo que una vez instalada una versión de FoxRibbon Camf en su carpeta raíz, si instala otra versión no se cambie el nombre de carpeta para evitar errores con las librerías instaladas. En mi caso la carpeta se llama FoxRibbon con independencia del nº de versión y es mi consejo. Para mas información vea: Añadir librerías FoxRibbon

Podrá descargar a FoxRibbon.rar desde: Portal de descargas FoxRibbon

Importante: FoxRibbon utiliza a System.app

 

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

Ejecute el programa FoxRibbon.exe

Tal y como viene el ejemplo que utiliza una base de datos de Visual FoxPro, es necesario tener este instalado para evitar errores.

 

¿Qué necesito conocer para poder usar FoxRibbon?

  1. Visual FoxPro en general
  2. Creación de clases visuales

Si no tiene un conocimiento al menos regular de Visual FoxPro no es mucho lo que podrá obtener de FoxRibbon ya que se atascará a cada rato. 

Si no sabe crear clases visuales en Visual FoxPro, entonces solamente podrá utilizar las clases que ya están diseñadas (que son muy pocas) y no podrá diseñar sus propias clases, personalizadas a su propio gusto. 

En otras palabras, si no conoce bastante bien los dos puntos anteriores, FoxRibbon no es para usted.

 

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

Si entra en la carpeta \VCX verá que hay cuatro librerías de clases:

FoxRibbon

Es la clase principal cuando quiera crear un menú de tipo ribbon.

CamfEngine

Contiene la clase custom Camf_Engine que se encarga del diseñador de estilos de forma automatizada.

CamfFunction

Contiene funciones y utilidades que utiliza FoxRibbon Camf

SampleRibbon

Contiene los ejemplos y no es necesaria. Puede basar su nueva aplicación en los ejemplos

 

Las tres primeras son obligatorias y en la última se encuentran los ejemplos.

Recomiendo crear una nueva librería para su aplicación o seguir creando las clases que necesite en SampleRibbon.

 

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

El programa principal Main.prg tiene un nuevo diseño lleno de variables lógicas, con los correspondientes comentarios de ayuda, que usted puede modificar a su gusto. En el puede elegir como va a funcionar la primera pantalla de los ejemplos de FoxRibbon Camf, si en la pantalla principal de Visual FoxPro (Screen) o en un Formulario de nivel superior. Los comentarios le van a ayudar a entender el funcionamiento de FoxRibbon Camf y le van guiar en el primer arranque de la aplicación. Entre en Main.prg y descubra sus secretos.

Si quiere no complicarse mucho, le recomiendo utilizar main.prg como plantilla para su aplicación.

Vea también: ¿Cómo crear mi primera aplicación FoxRibbon desde cero?


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

El nombre de cada una de ellas y su utilidad lo encontrará en ¿Para qué sirve cada una de las clases de FoxRibbon?.

A continuación puede ver algunos ejemplos de clases trabajando con ribbonc.

Haga clic en las imágenes para ampliar.

 

 

¿Cómo agrego un formulario de nivel superior para crear una aplicación?

1. Vea primero cómo añadir las librerías FoxRibbon a Visual FoxPro para poder utilizarlas.

Tiene varias formas de crear una aplicación:

  1. Crear todo en una clase y luego crear un formulario a partir de la clase
  2. Todo en un formulario
  3. De forma compartida en formulario y clase especifica personalizada

 

Las clases Ribbon y Ribbonc pueden utilizar todas

Vamos a utilizar la 1ª y la 2ª intentando ver como añadir Ribbon o Ribbonc

Tiene ejemplos de la 1ª en:

  • Librería SampleRibbon.vcx clase my_form_dual creando posteriormente el formulario main_dual.scx
  • Librería SampleRibbon.vcx clase my_form_dualc creando posteriormente el formulario main_dualc.scx

 

1. Crear todo en una clase y luego crear un formulario a partir de la clase

Vea el ejemplo main_dual

 

2. Crear todo en un formulario

 

2. Puede crear un formulario en blanco o bien crear uno sobre una clase de FoxRibbon.

Vamos a crear rápidamente una cinta ribbonc en un formulario de nivel superior de Visual FoxPro y un nuevo programa. Rápidamente le vamos a dar la posibilidad de utilizar colores y estilos personalizados

 

3. Abra la caja de herramientas Toolbox siguiendo las instrucciones del punto 1

 

4. En la librería CamEngine busque la clase camf_for_engine y haga clic con el botón derecho del ratón y después clic en Create Form. Esta clase ya está diseñada para esto.

 

5. Guarde el formulario en este caso como mainc2.scx, main3.scx etc.

 

6. En el administrador de proyectos, en documentos, busque main2.scx y si no aparece haga clic en el botón Agregar.

 

7. Ahora ya puede visualizar mainc2 y pulse en el botón Modificar.

Importante: Renombre Name a MAINC2 y guarde el formulario.

 

8. Ya tiene el nuevo formulario donde va a añadir clases FoxRibbon

 

9. Ahora necesita que se ejecute su Formulario de nivel superior como pantalla principal

 

 

 

10. Abra Main.prg y examine lo siguiente

llCamf_Screen = .F. && Por Camf. Con ello conseguimos utilizar FoxRibbon en Screen (.T.) o en un formulario de nivel superior (.F.)

 

11. Y ahora que se ejecute mainc2

*DO FORM SCX\mainc &&main_dualc && Entramos en FoxRibbon FNS con Ribbonc de César A. Mallo Fernández
DO FORM SCX\mainc2 && prueba de ejemplo en documentación

Aquí se activa el formulario que acabamos de crear mainc2.

 

12. Generamos el ejecutable.

 

13. Abrimos la aplicación y podemos observar que ya tenemos un formulario de inicio que posteriormente podemos modificar o crear otro nuevo.

 

14. Y vemos algo como esto (Clic para ampliar imagen). De momento funciona

 

¿Cómo agrego una cinta Ribbon a mi formulario?

1. Añadimos ribbonc, la nueva cinta ribbon de Camf.

 

2. Desde el Administrador de proyectos situados sobre mainc2 pulsamos modificar.

 

3. Desde Toolbox en la librería FoxRibbon arrastre la clase ribbonc al formulario mainc2 y verá algo como esto:

 

Tranquilo, no se desespere, ya sé que parece chino, pero enseguida lo entenderá.

 

4. Si ahora hace click sobre esa clase con el botón derecho, elige “Properties…” y luego “Otros”, verá lo siguiente:

Si mira las últimas líneas verá 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)

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 ejecuta su formulario verá algo como esto:

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

 

¿Cómo le agrego una barra de títulos al formulario?

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


1. Desde afuera del menú Ribbon

1. Ahora vamos a añadir una barra de título y como queremos tener posibilidades de cambiar estilos y colores de una forma sencilla, procedemos de la siguiente manera:

 
  • Abrimos el formulario Mainc2
  • Bajamos ribbonc para alojar encima la barra de título
  • Abrimos la caja de herramientas Toolbox
  • Buscamos la librería CamfEngine
  • Buscamos la clase personalizada _c_titlebar_app y la arrastramos al formulario Mainc2

Clic en la imagen derecha para ampliar

2. Guardamos los cambios en el formulario.

 

3. Generamos el ejecutable

 

4. Abrimos la aplicación y vemos algo como esto:

 

 
 
  • Aquí viene la magia de FoxRibbon Camf.
  • De una manera muy sencilla se ha creado una aplicación con el icono de propiedades de estilo.
  • Se pueden configurar los estilos y los colores para guardarlos posteriormente en el archivo STYLE.MEM que se encuentra en el directorio Styles.
  • En la parte inferior seis botones que nos permiten todas las configuraciones.
  • Al abrir un estilo se nos permite guardarlo por defecto.
  • Cierre la aplicación y pruebe volver a ejecutarla. Verá como lo que ha guardado por defecto es lo que visualiza en pantalla.
  • Con esto punto y final para el botón Ver código y luego pegar en Main.prg.
  • Nuestro cliente puede configurar la aplicación a su gusto.
  • Es por lo que digo que FoxRibbon Camf es desmontable sin complicaciones, cosa muy complicada con la versión 0.14
  • Podemos añadir o quitar cualquier botón de la pestaña Diseñador de estilos y todo va a seguir funcionando. Lo mismo con los iconos de la barra de título y todo se sincroniza al mismo tiempo.
  • Al cerrar la aplicación nos aparece un mensaje de confirmación, configurable totalmente..
 

5. Ahora, para ponerle un título a nuestro menú lo que hacemos es cambiar la propiedad “Caption” de nuestro formulario.

Recuerde: es la propiedad “Caption” del formulario la que cambia.

 

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 tiene definidos en las propiedades de su formulario, si no quiere verlos entonces simplemente les coloca el valor .F.

 Recuerde: los botones que serán visibles los determina en las propiedades de su formulario

 

6. 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.), debe:

a. Hacer click con el botón derecho sobre _titlebar1.

b. Elegir la opción “Edit”.

c. Hacer click sobre Ribbonlabel1.

d. En la ventana “Properties” cambiarle los valores a las propiedades.

2. Para cambiar la ubicación de la barra de título (ponerla más arriba, más abajo, más a la derecha, más a la izquierda) debe:

a. En FoxRibbon Camf no importa la posición, se centra automáticamente en su sitio.

b. Ribbonc solo se centra horizontalmente. Esto nos da posibilidades de posicionarlo a nuestro gusto.

Ejemplo:

 

Posiciones en mainc2

 

Y el resultado es este:

 

Desde dentro del menú Ribbon

En este caso, hacemos click con el botón derecho sobre el control my_Ribbonc, luego en la pestaña Favoritos, en su propiedad YourTitleBar colocamos el nombre de una clase que muestra la barra de títulos. Si usamos la librería de clases que se entrega con FoxRibbon Camf, entonces usaremos la anterior de la librería CamfEngine -> “_c_TitleBar_app”, como se ve en la siguiente captura de pantalla:

En este caso uso mi propia clase que muestra una barra de títulos. Puede revisar justamente la clase _c_TitleBar_app para tener una idea clara de cómo hacer su propia clase.

Nota: hacemos click con el botón derecho sobre el control my_Ribbonc, luego en la pestaña diseño la propiedad Left y Top tienen que tener un valor de 0. Esto solo es por estética, ya que como he explicado se autocentrará al ejecutarse a los valores Left y Top 0.

 

¿Por qué usar una barra de títulos propia y no usar simplemente la que tienen los formularios?

Porque su propia barra de títulos la puede PERSONALIZAR a su propio gusto, poniéndole todas las opciones y los iconos que desee.

En un programa que estéticamente se desea que sea bello (por eso justamente usa la clase FoxRibbon) tener en cuenta todos los detalles es importante. Y una barra de títulos personalizada ayuda mucho.

Y aquí tenemos una barra de título normal

 

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

Si ha probado cambiar las propiedades de RibbonLabel1 posiblemente habrá notado que puede cambiar el valor de todas las propiedades y funcionan … excepto FontName y ForeColor. Esas no cambian, haga lo que haga.

¿Por qué no funcionan?

Porque sus valores están definidos dentro del método ReDraw() de la clase RibbonLabel. Así que si quiere cambiarlos tendrá que escribir en el método ReDraw() de RibbonLabel1 lo siguiente:

DODEFAULT()

WITH THIS
.FORECOLOR = IIF(.lFontAlternate, _SCREEN.oRibbon.FontColorAlternate, RGB(x,x,x))
.FONTNAME = "Tahoma"
ENDWITH

Donde reemplazaría RGB(x, x, x) por los colores que le plazcan, por ejemplo: RGB(255, 255, 0)

Y FontName = “Tahoma” por el tipo de letra que le gusta, por ejemplo: FontName = “Times New Roman”

 

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

De forma muy similar a como le ha agregado una barra de título, también tiene dos formas:

Desde afuera del menú Ribbon

Si su formulario sólo tiene una barra de título y quiere incluirle una barra de estado, solamente puede utilizar esta opción.

 
  • Abrimos el formulario Mainc2
  • Abrimos la caja de herramientas Toolbox
  • Buscamos la librería CamfEngine
  • Buscamos la clase personalizada _c_StatusBar y la arrastramos al formulario Mainc2

Clic en la imagen derecha para ampliar.

2. Guardamos los cambios en el formulario.

 

3. Generamos el ejecutable

 

4. Abrimos la aplicación y vemos algo como esto:

 

 

 

Esta barra de estado se ha personalizado a partir de la clase _statusbar.

Tiene la siguiente información:

Versión: La versión de FoxRibbon que estamos utilizando

Modo:

  • FNS Utilizamos como pantalla un formulario de nivel superior
  • Screen La pantalla principal es la de Visual FoxPro

Style: El estilo que estamos utilizando

Y por último, si hacemos clic sobre la fecha y hora se abre una ventana que permite cambiar fecha y hora

 

5. Haga click con el botón derecho sobre la barra de estado que acaba de agregar (la cual tendrá por nombre: o_c_StatusBar1)

6. Haga click sobre RibbonLabel1

7. Si queremos que se muestre texto personalizado cambiamos la barra de estado por la de la librería FoxRibbon _StatusBar. En la ventana de Properties, en la propiedad “Caption” escriba el texto que desea que se muestre en la barra de estado, por ejemplo:

Nota: Si _idtranslate tiene un valor asignado y cambiamos la propiedad “Caption” es igual que hagamos cambios en .ribbonlabel1.caption a no ser que actualicemos _idtranslate de acuerdo a .ribbonlabel1.caption. De lo contrario no va a funcionar a no ser que _idtranslate no tenga un valor asignado.

8. Ejecute su formulario y verá algo como:

 

9. Al igual que como hizo con la barra de títulos, le puede cambiar el tipo de letra, el color de las letras, el tamaño, etc.

10. Si quiere cambiar el texto desde un método de su formulario, entonces puede escribir algo como:

ThisForm.o_c_StatusBar1.RibbonLabel1.Caption = "Mensaje en la Barra de Estado"

O como:
ThisForm.o_c_StatusBar1.RibbonLabel1.Caption = DtoC(Date())

 

Desde dentro del menú Ribbon

En este caso:

      1. Click sobre Ribbon1
      2. En la propiedad “YourStatusBar” escriba el nombre de una clase que muestre una barra de estado. Puede usar _c_StatusBar o alguna otra de su propia creación.

       

 

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

Los botones de inicio son muy útiles para mostrarle al usuario las opciones más utilizadas, para que las tenga fácilmente a mano. Una posibilidad sería llevar un contador de las veces que utiliza cada opción y aquellas que más utiliza colocarlas en el botón de inicio, para que pueda acceder rápidamente a ellas.

De forma muy similar a como le ha agregado una barra de título y una barra de estado, también tiene dos formas:

Desde afuera del menú Ribbon

Si su formulario sólo tiene una barra de título y quiere incluirle un botón de inicio, solamente puede utilizar la esta opción.

 

1.

  • Abrimos el formulario Mainc2
  • Abrimos la caja de herramientas Toolbox
  • Buscamos la librería SampleRibbon
  • Buscamos la clase personalizada _my_startbutton y la arrastramos al formulario Mainc2

Clic en la imagen derecha para ampliar.

 

2. No intente posicionarla en su sitio, déjela donde está, de lo contrario va a ser un estorbo para seguir configurando posteriormente la cinta Ribbon y la Barra de título.

 

3. Escriba lo siguiente en el método Init de o_my_startbutton1

DODEFAULT()
WITH THIS
.Top=0
.Left=5
ENDWITH

 

 

4. Nos situamos en _menutabs1

En favoritos verá la propiedad:
FirstTabClick, que servirá para indicarle cual será la pestaña que estará habilitada al iniciar el programa. En nuestro caso_menutabsbutton1

 

 

5. Nos situamos en la pestaña 1 _menutabsbutton1

En favoritos verá la propiedad:
pageclass, que servirá para indicarle que clase se activa al pulsar la pestaña mostrándole su contenido. En nuestro caso page_1

Para que cada una de las páginas de o_my_startbutton1 puedan ser mostradas tendrá que agregarlas a su clase, si es que ya no están en ella.

Naturalmente, a las páginas Page1, Page2, etc., las personaliza a su gusto.

 

 

6. Guardamos los cambios en el formulario.

 

7. Generamos el ejecutable

 

8. Abrimos la aplicación y vemos algo como esto:

Este botón de inicio se ha personalizado a partir de la clase c_startbutton.

 

Esta es la clase Page_1 en modo de ejecución

:

 

Y aquí la vemos en modo de diseño:

 

Desde dentro del menú Ribbon

Para agregar un botón de inicio:

1. Click sobre my_ribbonc
2. En la propiedad “YourStartButton” poner el nombre de una clase que muestre el botón de inicio, por ejemplo: _my_startbutton

En este caso, para personalizar el botón de inicio tiene que abrir, en la librería SampleRibbon, la clase _my_startbutton

 

 

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

 

1. Añadimos pestañas. Abrimos Toolbox y Mainc2.

 

2. En Toolbox seleccionamos librería FoxRibbon y la pestaña para ribbonc es ribonctab.

 

3. Con la tecla Ctrl pulsada hacemos clic izquierdo sobre ribbonc.

 

4. Ahora arrastramos ribbonctab desde Toolbox hasta la parte sup. de ribbonc y colocamos, así hasta tener dos pestañas.

 

 

5. Reubicamos las pestañas

 

6. Con la tecla Ctrl pulsada hacemos clic izquierdo sobre RibboncTab1 (el control que acabamos de agregar)

 

7. Click sobre RibbonLabel1 (la etiqueta que está dentro de ese control)

 

8. Cambiarle la propiedad “Caption”. En este ejemplo se puso la palabra “Archivos”. Proceder de la misma manera con las pestañas que agregamos

 

 

9. Hacemos clic sobre my_ribbonc y luego en propiedades sobre la pestaña favoritos. cómo ya hemos visto en ¿Cómo agrego una cinta Ribbon a mi formulario?, la propiedad FirstTabClick es obligatoria, que servirá para indicarle cual será la pestaña que estará habilitada al iniciar el programa. Ver imagen derecha.

 

 

Al ejecutar el formulario veremos algo así:

Como podemos ver, nuestro menú ya está tomando forma, de a poco va siendo más útil.

 

Ahora, le agregaremos más opciones, para que se parezca más a un menú que pueda ser utilizado por los usuarios de nuestras aplicaciones.

 

Al ejecutar el formulario veremos esto:


Si queremos que las pestañas tengan un pequeño iconito a su izquierda, entonces se lo agregamos, como vemos a continuación:

En la propiedad “Picture” de Image1 especificamos el archivo gráfico que allí será mostrado. Al ejecutar el formulario podremos ver algo así:

En este caso se colocó un símbolo de interrogación pero por supuesto puede elegirse cualquier otro gráfico que uno desee.

IMPORTANTE: El tamaño del archivo gráfico debe ser de 16 x 16 píxeles.

 

¿Cómo le muestro las opciones al usuario cuando hace click sobre una pestaña?

Para conseguir eso necesitará dos cosas:

  1. Diseñar la clase que usará para mostrar sus opciones
  2. Escribir el nombre de esa clase en la propiedad “PageClass” del control RibboncTab, por ejemplo:

 

En este caso estamos usando una clase llamada “whathistab” que se encuentra en la librería de clases "SampleRibbon.vcx”

 

Al ejecutar nuestro formulario veremos algo como esto:


 

Al hacer click sobre la pestaña “Archivos” automáticamente aparecieron las opciones que se habían puesto en la clase “whathistab”.

 

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

Para eso, puede utilizar todas las clases que le provee la librería FoxRibbon.vcx ya que allí encontrará todo lo que necesita.

 

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

1. Crear una clase contenedora

CREATE CLASS TabArchivos OF MisOpciones AS RIBBONPAGE

NOTA: Podríamos también haber escrito:
CREATE CLASS TabArchivos OF MisOpciones AS CONTAINER

Y funcionaría bien después de ajustar las propiedades BackStyle = 0, BorderWidth = 0, Height = 92. Sin embargo usar la clase RibbonPage tiene una ventaja: ella se encarga de ajustar las propiedades Top de los grupos contenidos y de refrescar (ReDraw()) si se cambia el estilo o el idioma.

 

2. Establecer las propiedades

Height   =  92 (la altura debe ser 92, no la cambie)
Width   = 900 (el ancho por supuesto que puede variar)

 

3. Agregarle los controles deseados:

a. Un control RibbonGroup con las propiedades:

Left = 5
Top  = 0
RibbonLabel1.Caption = Maestros

b. Dentro de RibbonGroup1 un control RibbonButtonV con las propiedades

Left = 3
Top  = 3
Image1.Picture  = Carita01.ico
RibbonLabel1.Caption = Empresa

En lugar de Carita01.ico puedes colocar cualquier otro gráfico con dimensiones de 32 x 32 píxeles

Y en el evento Click() de RibbonButtonV escribimos el código  deseado, por ejemplo:

EVENTO CLICK
=MessageBox(“Hiciste click aquí”)

 

4. En la propiedad “PageClass” del control “RibbonTab” escribir el nombre de la clase que será mostrada (en este ejemplo la clase se llama: TabArchivos

A partir de este momento, ya todo depende de su creatividad

 

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

Vea librerías FoxRibbon Camf:

 

¿Un consejo final?

Revise cada una de las clases que se encuentran en las librerías CamEngine.vcx, CamfFunction y SampleRibbon.vcx, así podrá conocer como fueron hechas y le resultará muy fácil crear sus propias clases.

 

¿Y si tengo dudas o consultas?

Ante cualquier duda, consulta o sugerencia, puede contactar con:

foxribbonlib@gmail.com


 

Referencias

Documentación FoxRibbon 0.14 de Walter R. Ojeda Valiente

Autor: Camf

 



error: Contenido protegido