Theme:
v
Ribbon 30-days Trial Version

Download the 30-days Ribbon Trial Version for APL+Win

Download the 30-days Ribbon Trial Version for APL+Win

Download the 30-days Ribbon Trial Version for Dyalog APL

Download the 30-days Ribbon Trial Version for Dyalog APL

Other pages of interest:

Please read this page before installing Ribbon.

Requirements

You must have the Microsoft .Net Framework 4.0 installed on your computer.

You must have a version of APL+Win greater or equal to v3 (or a version of Dyalog APL supporting ActiveX)

Installation

Proceed as follows to install the Ribbon 30-days Trial:

  1. run RibbonSetup.exe (or RibbonDyalogSetup.exe) after downloading it using one of the above links
  2. APL+Win users: set the Ribbon.sf file as your top level UCMD file:
          ]ufile <path>\ribbon
    
    where <path> is the full path of the folder where you installed the Ribbon control
  3. APL+Win Users: the Ribbon.w3 sample workspace is delivered in APL+Win v6.4 format
    If you own an earlier version of APL+Win you can recreate the Ribbon.w3 workspace from the Ribbon.sf User Command file as follows:
          )clear
          ]uload * /F=<path>\Ribbon
          ⎕lx←'AutoStart'
          )wsid <path>\Ribbon
          )save
    
    where <path> is the full path of the folder where you installed Ribbon

The Ribbon Sample Workspace

Once Ribbon has been properly installed as described in the above steps, you can load the Ribbon.w3 (or Ribbon.dws) workspace

In this workspace you can run the following sample functions:

RibbonPad''Displays an APL form with a Ribbon control, a bit similar to Windows 7 WordPad
Ribbon2''Displays an APL form with a Ribbon control demonstrating a lot of the Ribbon control features
Ribbon''Creates an APL form with an empty Ribbon object (practical to start testing Ribbon properties and methods)
PricesDisplay the Ribbon product Price List

Also note that you can use a left argument of 1 with the RibbonPad, Ribbon2 and Ribbon APL functions, in which case the form that is displayed is made "ontop"

The Ribbon Sample Workspace Tutorial

The Ribbon.w3 workspace includes a Tutorial that demonstrates most of the Ribbon features.

In order to be able to run this Tutorial, you must first set the Ribbon.sf as your top level User Command file: you can do so by executing function: SetUCMDFile

You can then run the Tutorial with:

      ]demo RibbonDemo

or:

      ]DEMO RibbonDemo

if your User Command Processor is case sensitive.

Be sure to run the Tutorial!

Getting documentation

If you installed the product properly and set the Ribbon.sf file as your top level UCMD file, then you can use the following 4 User Commands to get documentation about the DLL:

First the ]ribprops User Command lets you know about all properties available in the DLL

      ]ribprops
xAllowContextMenu         xEnabled                  xRibbonHeight
xAllowQatCustomization    xMinimizeOnDoubleClick    xRibbonMinimized
xCalculatorBackColor      xMruTooltips              xTheme
xCalculatorBorderColor    xMrus                     xThemes
xCalculatorNumberColor    xQatIconImage             xTranslationKeys
xCalculatorOperatorColor  xQatIconVisible           xTranslations
xCalculatorTitleColor     xQatPositionedTop         xVersion
xCalledFromAPL            xQatVisible               xVisible
xCaptionVisible           xRibbonBarMinWidth

Then the ]ribmeths User Command lets you know about all methods available in the DLL

      ]ribmeths
XAbout              XAddQATMenuButton   XRemoveBar
XAddBar             XAddSplitButton     XRemoveButton
XAddButton          XAddTab             XRemoveContainer
XAddButtonData      XAddThemeButton     XRemoveTab
XAddCalculator      XAddVContainer      XSelectFirstTab
XAddFontColors      XAlignInRibbonBar   XSelectTab
XAddFontCombos      XBringToFront       XSetButtonTooltip
XAddGallery         XEnableBar          XSetRibbonBarWidth
XAddHContainer      XEnableButton       XSetTabIndex
XAddMenuButton      XEnableTab          XShowBar
XAddMenuTab         XGetButtonData      XShowButton
XAddQATButton       XRefresh            XShowTab

The ]ribevents User Command lists all events you can receive and handle in APL:

      ]ribevents
XCalculatorResultChanged  XFontNameChanged          XRibbonHeightChanged
XClick                    XFontSizeChanged          XSelectedColorChanged
XDblClick                 XRibbonButtonClicked

And finally the ]ribdoc user command (which is not case sensitive) lets you get documentation about any property or method:

      ]ribdoc addbar
The AddBar method allows to add a new ribbon bar to a given ribbon tab

APL+Win Syntax:		'ff.rib'⎕wi'*XAddBar' tab bar orientation dialogLauncherVisible
Dyalog APL Syntax:	ff.rib.AddBar tab bar orientation dialogLauncherVisible
C# Syntax:			rib.AddBar(tab, bar, orientation, dialogLauncherVisible);

tab should be the caption of an existing ribbon tab
bar should be the caption of the ribbon bar to create
orientation should be a character string, one of:
	'Vertical'
	'Horizontal'
	''             (which means Horizontal)
dialogLauncherVisible should be a boolean value indicating if the dialog
	launcher little button is visible or not in the ribbon bar caption

Example:
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Pages'            '' 0
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Tables'           '' 1
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Illustrations'    '' 1
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Links'            '' 0
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Header && Footer' 'Horizontal' 1
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Text'             '' 0
	'ff.rib'⎕wi'*XAddBar' '&Insert' '&Symbols'          '' 1