Theme:
v
Ribbon Resources Compilation

The LC.CompileResources.exe Application

The Ribbon© product includes a satellite C# application which allows you to compile all the images you want to use in your ribbon, into one DLL.

This application is called LC.CompileResources.exe and is installed in your Ribbon folder. It requires the .Net Framework v4.0.

Ribbon Images Files

The Ribbon© product assumes that:

  • all your Ribbon button images are .png files (either 16x16 or 32x32 pixels images)
  • the icons you may want to use for the QatIconImage property are 16x16 pixels .ico files

Icon Libraries

We recommend that you purchase or use one or more good icon libraries. Some good ones are:

How to Use the Compile Resources Application

To use the LC.CompileResouces.exe application:

  1. open Windows Explorer and double click LC.CompileResources.exe in your Ribbon folder
  2. click the DLL FileName button (top right button)
  3. select the LC.Objects.Ribbon.Images.dll file in your Ribbon folder
  4. click the Images Folder button (top right button just below the DLL FileName button)
  5. select a folder containing .png and/or .ico images (all .png and .ico images in this folder should get displayed in the left grid)
  6. in the left grid, select those images you would like to use in your ribbon
  7. click the button to transfer those images to the right grid (you may also click the button to transfer all images to the right grid)
  8. optionally repeat steps 4. to 7. to add more images to the right grid, selecting various source Images Folders on your computer
  9. once you have copied all the .png and .ico images you want to use in your Ribbon, in the right grid, click the Compile Resources button
    If compilation went ok you should see a MessageBox similar to:

After you click the Compile Resources button, all your selected images are compiled into the LC.Objects.Ribbon.Images.dll: this allows you to deploy only 2 files for your ribbon to work in your APL+Win application:

  • LC.Objects.Ribbon.dll (the Ribbon control itself)
  • LC.Objects.Ribbon.Images.dll (the DLL containing all yoru ribbon images)

Note that you can rename your Images DLL to any name with the .dll extension, but in that case you must tell the ribbon control the name of your images DLL, using the ImagesDll property and you should do that right after instantiating the Ribbon object.

Example: (assuming that you have renamed LC.Objects.Ribbon.Images.dll to MyRibbonImages.dll):

    ⎕wself←'ff'⎕wi'*.rib.Create' 'LC.Objects.Ribbon.LoaderHookerAttribute'
    ⎕wself←'ff'⎕wi'*.rib.Create' 'LC.Objects.Ribbon.Ribbon'
    Z←⎕wi'imagesdll' 'MyRibbonImages.dll'