Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Abril de 2012
INDICE
Qu es FoxRibbon? ................................................ 1
Cmo hago para cambiar el color del texto y el tipo de letra? .... 10
Cmo creo mis propias clases visuales para mostrar las opciones? . 19
Qu es FoxRibbon?
Es una librera 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 mens de tipo ribbon y adems provee una serie de herramientas para
mejorar el aspecto visual de las aplicaciones.
-1-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
DO SYSTEM.APP
if VarType(_Screen.oRibbon) == "O"
_Screen.RemoveObject("oRibbon")
endif
_Screen.NewObject("oRibbon", "RibbonSettings")
with _Screen.oRibbon
.Language = "Espaol"
*--Calendario
.c_FirstDayWeek = 2
*--Das 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
-2-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
-3-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
-4-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
6. Si ahora haces click sobre esa clase con el botn derecho, eliges
Properties y luego Other, vers lo siguiente:
YourStatusBar sirve para indicar el nombre de la clase que muestra una barra de
estado (si hay una barra de estado, por supuesto)
-5-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
O sea, nada muy til hasta ahora, pero iremos avanzando hasta tener un men
totalmente funcional.
-6-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
-7-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
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 sern visibles los determinas en las propiedades de tu
formulario.
-8-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
En este caso, haces click con el botn derecho sobre el control Ribbon1, luego
en su propiedad YourTitleBar colocas el nombre de una clase que muestra la barra de
ttulos. Si usas la librera de clases que se entrega con FoxRibbon entonces podras usar
MyTitleBar, como se ve en la siguiente captura de pantalla:
O podras usar tu propia clase que muestre una barra de ttulos. Puedes revisar
justamente la clase MyTitleBar para tener una idea clara de cmo hacerla.
Por qu usar una barra de ttulos propia y no usar simplemente la que tienen los
formularios?
Porque a tu propia barra de ttulos la puedes PERSONALIZAR a tu propio
gusto, ponindole todas las opciones y los iconos que desees.
En un programa que estticamente deseas que sea bello (por eso justamente usas
la clase FoxRibbon) tener en cuenta todos los detalles es importante. Y una barra de
ttulos personalizada ayuda mucho.
-9-
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
Por qu no funcionan?
Porque sus valores estn definidos dentro del mtodo ReDraw() de la clase
RibbonLabel. As que si quieres cambiarlos tendrs que escribir en el mtodo ReDraw()
de RibbonLabel1 lo siguiente:
DODEFAULT()
WITH THIS
.FORECOLOR = IIF(.lFontAlternate, _SCREEN.oRibbon.FontColorAlternate, RGB(x,x,x))
.FONTNAME = "Tahoma"
ENDWITH
Donde reemplazaras RGB(x, x, x) por los colores que te plazcan, por ejemplo:
RGB(255, 255, 0)
- 10 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
De forma muy similar a como le has agregado una barra de ttulo, tambin tienes
dos formas:
- 11 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
9. Al igual que como hiciste con la barra de ttulos, le puedes cambiar el tipo de
letra, el color de las letras, el tamao, etc.
10. Si quieres cambiar el texto desde un mtodo de tu formulario, entonces
puedes escribir algo como:
ThisForm._statusbar1.RibbonLabel1.Caption = "Mensaje en la Barra de Estado"
O como:
ThisForm._statusbar1.RibbonLabel1.Caption = DtoC(Date())
En este caso:
1. Click sobre Ribbon1
2. En la propiedad YourStatusBar escribir el nombre de una clase que
muestre una barra de estado. Puedes usar MyStatusBar o alguna otra
de tu propia creacin.
- 12 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
Adems, para que cada una de las pginas de MyStartButton puedan ser
mostradas tendrs que agregarlas a tu clase, si es que ya no estn en ella.
- 13 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
- 14 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
5. Click con el botn derecho sobre RibbonTab1 (el control que acabamos de
agregar)
6. Opcin Edit
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
- 15 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
Como podemos ver, nuestro men ya est tomando forma, de a poco va siendo
ms til.
- 16 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
- 17 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
Cmo le muestro las opciones al usuario cuando hace click sobre una pestaa?
Para conseguir eso necesitars dos cosas:
1. Disear la clase que usars para mostrar tus opciones
2. Escribir el nombre de esa clase en la propiedad PageClass del control
RibbonTab, por ejemplo:
En este caso estamos usando una clase llamada DesignerTab que se encuentra
en la librera de clases MyDesigns.vcx
- 18 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
Cmo creo mis propias clases visuales para mostrar las opciones?
Para eso, puedes utilizar todas las clases que te provee la librera FoxRibbon.vcx
ya que all encontrars todo lo que necesitas.
EVENTO CLICK
=MessageBox(Hiciste click aqu)
- 19 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
_bandmenu
Es la banda vertical de los mens desplegables. Es utilizada en
RibbonFormMenu y se puede verla en los formularios Menu1 y Menu2
_borderform
Remarca an ms los bordes de un formulario y se ajusta
automticamente a ste
_calendar
Calendario
_container
Contenedor de otros objetos
_datepicker
Muestra y permite cambiar la fecha
_datetimepicker
Muestra y permite cambiar la fecha y la hora
_day
Muestra el nmero del da
_menubar
Es un contenedor (de botones o de lo que necesites)
_menutabs
Es un contenedor para colocar en l las opciones que se mostrarn en un
men vertical, como el de MyStartButton
_menutabsbutton
Utilizado en MyStartButton para mostrar opciones
_pageframeh
Es un contenedor de RibbonPage que simula un PageFrame. Ejemplos
de su uso se pueden ver en Acerca de y en Open a form example
_panel
Es un contenedor de diversos objetos que tiene una mejor apariencia. Un
ejemplo de su uso puede verse al hacer click en el botn Propiedades del
estilo.
_progressbar
Barra de progreso que tambin muestra un porcentaje
_statusbar
Barra de estado que se muestra en la parte inferior del formulario
- 20 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
_titlebar
Barra de ttulos que puede ser personalizada
_titlebarmax
Barra de ttulos que puede ser personalizada
ribbon
Men de tipo ribbon (o cinta, en castellano) que puede ser personalizado.
Inicialmente est vaco, se le deben agregar las distintas opciones.
ribbonbuttongroup
Muestra un formulario asociado a un grupo
ribbonbuttonh
Similar a un botn de comando que se muestra en forma horizontal y
puede tener un icono de 16 x 16 pixeles
ribbonbuttonv
Similar a un botn de comando que se muestra en forma vertical y puede
tener un icono de 32 x 32 pixeles
ribboncheck
Similar a un checkbox
ribboncombo
Similar a un ComboBox
ribboncommandbutton
Similar a un botn de comandos, puede tener un icono de 16 x 16 pixeles
a la izquierda
ribboneditbox
Similar a un EditBox
ribbonformbase
Es un formulario base, utilizado en Acerca de, Ver cdigo y es la
clase padre de RibbonFormCalendar, RibbonFormDateTime y de todas
las dems RibbonFormxxx
ribbonformcalendar
Formulario que muestra y permite cambiar una fecha
ribbonformdatetime
Formulario que muestra y permite cambiar la fecha y la hora
ribbonformmenu
Clase base para crear mens. Se puede ver un ejemplo de su uso en la
pestaa de Ejemplos, el botn Edit y los tres botones horizontales
Label1 que estn a su derecha.
- 21 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
ribbonformmsgbox
Similar a MessageBox() pero no hay interaccin con el usuario.
ribbonformwait
Similar a Wait Window y con una barra de progresos opcional
ribbongroup
Contenedora de un grupo de opciones
ribbon_groupseparator
Separa los grupos cuando se emula a Office 2010. Eso se hace mediante
la propiedad _Screen.oRibbon.SeeOutlineGroup. Cuando est en .T. est
visible, cuando est en .F. est invisible.
ribbonhelp
Ventanita para mostrar mensajes de ayuda que tiene un ttulo y un
mensaje, el cual puede tener hasta tres lneas
ribbonlabel
Similar a las etiquetas (label)
ribbonlistbox
Similar a un ListBox
ribbonmenuseparator
Barra horizontal para separar las opciones del men
ribbonoptiongroup
Grupo de botones de radio
ribbonpage
Contenedora de las clases visibles, que automticamente alinea a los
objetos que tiene contenidos
ribbonseparator
Muestra una barra para separar a un ribbonbuttonv de otro
ribbonsettings
Configuracin de FoxRibbon. En lugar de usar variables pblicas o
propiedades del objeto _Screen, se usan propiedades de esta clase
ribbonspinner
Similar a un Spinner
ribbonstartbutton
Contenedora de todas las opciones que puede mostrar el botn de inicio
ribbontab
Pestaa de ttulo, que adems puede tener un icono
- 22 -
Autor: Guillermo Carrero Documentacin: Walter R. Ojeda Valiente
ribbontextbox
Similar a un TextBox
Un consejo final?
Revisa cada una de las clases que se encuentran en la librera MyDesigns.vcx,
as podrs conocer como fueron hechas y te resultar muy fcil crear tus propias clases.
- 23 -