|


The
main purpose of the VBCE Icons Tool program is to build "Resource
Only DLL's" with a number of Icons to be used on all the platforms
(Targets) supported by Windows CE.
Those DLL's may be used in several ways. Some examples:
 |
Assign an individual Icon to each
eVB script application |
 |
Give an Icon on the Windows CE Taskbar
to each eVB Form |
 |
Include a small Icon on the Windows
CE System Tray |
For
all the examples given, we have free source
code available to include on your applications. We have also
examples of Registry Manipulation, Fill a Form with an Image (.bmp)
and others. You can also check on how to use System Function Declares
using User Defined Types (structures) which are not available on
this version of the Toolkit. All the examples are for the Embedded
Visual Basic 3.0.



Let's start with the basics:
 |
Click "Add" and select
one or several Icons to include on the DLL. |
 |
You can "Remove" some
if you wish. |
 |
Or "Remove All" of them. |
 |
You can also uncheck some of the
Icons on the list and then "Remove Unchecked". This
is just a cosmetic operation: only those Icon files marked as
checked will be included on the DLL |
 |
You can change the order of the
files: click on a file and "Move" it up or down on
the list. |
 |
Then select the "Target Machine". |
 |
And press the "Build DLL"
|
On the "Icon" frame there two interesting values:
 |
"ID" gives us the number
to use on some system calls to get the Icon file selected. This
value will only be accurate if you remove all the unchecked
files on the list. |
 |
"Images" tell us the number
of images on the Icon file selected. Each Icon file may have
several images, usually a 32x32 pixels (large Icon) and a 16x16
pixels (small Icon). |



Let's
say you don't need the 32x32 pixels image on the selected Icon file.
Go to the Main form menu and select "Tools" > "Remove
Images from Icon". On the list, uncheck this particular image
and "Save" it. If you want to keep the original file use
"Save As". By just clicking each particular image, you
will see it on the left of the listing.

The
Main form menu option "Tools" > "Edit Icon"
will call the application defined on your computer as the default
edit application for .ico files passing the selected Icon file as
a call parameter. VBCE Icons Tool does not include in itself
this editing functionality.


After selecting all the required Icons to include on the DLL, there
are 3 main options on the VBCE Icons Tool application:
 |
"Build for selected Target":
Build just one DLL for a selected Target platform |
 |
"Build for all Targets":
Build DLL's for all available platforms (Targets). An additional
extension identifies the intended platform of the DLL. This
option also builds a DLL for the selected Target platform as
the previous one. Example: Build an Icon DLL to test on the
Windows CE Emulation but leave versions of the same DLL for
all available platforms. |
 |
"Create & Change VB6 Setup
Files": Build DLL's to include on CAB files generated by
the "Application Install Wizard" program available
on the "Embedded Visual Basic 3.0". This option performs
a number of changes on the .INF file and rebuilds all .CAB files.
It also includes Registry settings on the Target device to automatically
assign the first Icon of the DLL to the application. More details
on this later in this document. |


One of the drawbacks of the Embedded Visual Basic 3.0 is the impossibility
of assigning a different Icon to each application.
The
VBCE Icons Tool program addresses the problem by assigning
a specific Icon DLL to every application installed. This Icon DLL
may also include several other Icons to be used on other instances
of your application (like assigning Toolbar Icons to each Form).


Proceed as follows:
- Create your Embedded Visual Basic application.
- Call the "Application Install Wizard" to create the
Setup files for that application.
- Call VBCE Icons Tool and include all Icon files required.
Select the "Create & Change VB6 Setup Files" option
on the Main form menu and press the "Build" button.
- You will be asked to supply the Setup Directory previously used
by the eVB "Application Install Wizard" and the name
of the Icon DLL file to create. An emulation version of the DLL
(x86) will be left on this directory. The customized versions
of the DLL for each Target System will be left in separate subdirectories.
- Some other will replace the original extension of your executable
(.vb). You might accept a randomly generated extension or provide
your own one. On the WinCE device, registry settings will assign
the first Icon of the new Icon DLL to this extension.
- The original (built by the eVB "Application Install Wizard")
.INF file will be backed up and will never change. This permits
several Icon DLL's buildings with only one eVB "Application
Install Wizard" execution.
A new .INF file will be built which will include all the new settings.
- The eVB "Application Install Wizard" leaves a "README.TXT"
file on the Setup Directory, which provides the command to use
on following .CAB builds. After building the new .CAB files, they
will be moved to the CD1 subdirectory, replacing all previous
versions of those files.
- Everything needed to install the application will be left on
the CD1 subdir

The
unregistered version of the VBCE Icons Tool program is intended
to be used for evaluation purposes. It performs exactly as the registered
version BUT all the Icons included on the output DLL will be drawn
over a GRID with the COLORS SCRAMBLED.
To order VBCE Icons Tool please access this
page. You will need to provide some kind of Identification (Register
to) which will be displayed as the Caption of the Main form of the
VBCE Icons Tool.
After receiving the corresponding Key, hit the Main form menu option
"Help" > "Register" and enter the "Register
to" and "Key" assigned to you.
|