isCOBOL Evolve : User Interface : Working With UI and Controls : Default icons
Default icons
The isCOBOL Framework includes a series of default icons that are used in various places of the GUI.
These icons are PNG and GIF files stored in the com/iscobol/gui/client/swing package in the iscobol.jar library.
It’s possible to customize these icons by adding a library (or a folder) with the same package before iscobol.jar in the CLASSPATH.
This is the list of available icons:
Image file
Corresponding icon
cancelfind.png
Close icon in Grid and Tree-View search panel
checkmenuitem.gif
Check icon in menu-bar and pop-up menu
chevron_down.png
Collapse button in Tree-View with the FLAT style
chevron_right.png
Expand button in Tree-View with the FLAT style
clearfind.png
Clear icon in Grid search panel
Error.gif
Error icon in message box
first.gif
First button in paged Grid and List-Box
funnel_delete.png
Funnel delete icon on Grid heading
funnel_update.png
Funnel update icon on Grid heading
funnel.png
Funnel icon on Grid’s heading
grip.gif
Grip icon in Status-Bar
Inform.gif
Default icon in message box
last.gif
Last button in paged Grid and List-Box
pageprev.gif
Previous Page button in paged Grid and List-Box
pagesucc.gif
Next page button in paged Grid and List-Box
prev.gif
Previous button in paged Grid and List-Box
Question.gif
Question icon in message box
searchfind.png
Find icon in Grid’s search panel
sortdown.png
Sort descending icon in the heading of Grid and Tree Table-View
sortnone.png
Unsorted icon in the heading of Grid and Tree Table-View
sortup.png
Sort ascending icon in the heading of Grid and Tree Table-View
succ.gif
Next button in paged Grid and List-Box
vV.png
Case sensitive icon in Grid’s search panel
vV2.png
Case insensitive icon in Grid’s search panel
Warn.gif
Warning icon in message box
Let’s make an example.
Suppose that you wish to customize the funnel icon shown on the Grid’s heading when either the FILTERABLE-COLUMN style or the FILTER-TYPES property is set. You can proceed as follows:
1. Change to a temporary folder where you will build the custom package, e.g.
cd %TEMP%
2. Create the folder structure:
mkdir com\iscobol\gui\client\swing
3. Place a file named funnel.png in the swing subfolder, e.g.:
copy C:\path\to\yourfunnel.png %TEMP%\com\iscobol\gui\client\swing\funnel.png
4. Include the folder structure in a jar, e.g.:
cd %TEMP%
jar -cvf myicons.jar com
5. Copy myicons.jar to the “jars” folder of your isCOBOL SDK:
copy %TEMP%\myicons.jar %ISCOBOL%\jars
From now on, when you run a COBOL program using the isCOBOL SDK, you will see your custom funnel on grid headings.
Note - the above sample commands are applicable to the Windows operating system and assume that the JDK bin directory is in the Path. On Unix/Linux platforms the same commands are slightly different.