18.6 The X_ICOBMP.DAT Defaulting File
The X_ICOBMP.DAT icon and bitmap defaulting file may optionally reside in the partition SOURCE directory (i.e. <drive>:\X_LANSA\X_ppp\SOURCE
where "ppp" is the partition identifier.
It is a standard text file and may be edited with most common source editors such as Notepad.
Each individual line should start with one of these "keywords" to indicate what the line contains:
|
ICO |
Identifies an icon file (without the .ico suffix) |
|
BMP |
Identifies a bitmap file (without the .bmp suffix) |
|
NAM |
Identifies an associated object name |
|
STR |
Identifies an associated search string |
|
PDO |
Identifies a pull down option code (pd$opt value) |
All keywords, file and object names are automatically converted to uppercase before being used. Note that strings (STR=) are not converted to uppercase and are always compared in the case specified.
If the specified icon or bitmap file cannot be found in the SOURCE directory of the current partition then a warning is issued and the line (and all associated NAM= and STR= options) are ignored.
The use of this file is best indicated by example:
ico=cust
nam=LXRSF01
nam=LXRSF02
str=Customer
str=customer
* <-------- This line does not start with a keyword
ico=printer so it will be ignored.
str=Print
str=print
str=Report
str=report
pdo=REP
pdo=PRT
First an icon called CUST is identified.
Any process or function named LXRSF01 or LXRSF02 is to be automatically associated with it.
This association could also be achieved by copying the CUST icon to create icons called LXRSF01.ICO and LXRSF02.ICO. However, using this file means that many processes and functions can be associated with a single icon.
Additionally, any object that has textual identification containing "Customer" or "customer" is to be automatically associated with this icon.
Next, another icon called PRINTER is identified.
Any object that has textual identification containing "Print", "print", "Report" or "report" should be automatically associated with it.
Any pull down menu entry that has a PD$OPT value of REP or PRT should appear in the tool bar area and use the PRINTER icon to identify it.
Some final points:
- No input line should be longer than 50 characters.
- Up to 40 characters of STR= value may be specified.
- STR= values are case sensitive.
- ICO=, BMP=, NAM= and PDO= values are not case sensitive.
- Blank characters following STR= values are stripped and ignored.
- Blank characters preceding STR=values are significant.
- Association priority is from the start of the file to the end. Once a match is found processing stops and no further comparisons are performed.
- A very large number of entries in this file could degrade process compile times. The "icon association" stage of a process compile is indicated by messages. If the time between messages becomes very long it may be because there are an unreasonably large number of entries in this file.
- A set of demonstration icons and a demonstration version of X_ICOBMP.DAT is shipped with Visual LANSA. They are automatically installed into all partitions that exist at the time.
The demonstration icons all start with S_ and have English language associations in the shipped X_ICOBMP.DAT file.