CONTENTS:
=========

	- DESCRIPTION
	- INSTALL
	- HOW TO USE
	- TOOLS
	- OPTIONS
	- VBCE TOOLKIT - THE APPLICATION ICON DRAWBACK
	- VBCE ICONS TOOL - THE WORKAROUND
	- EVALUATION VERSION
	- REGISTRATION
	- PRICE



DESCRIPTION:
============

One of the most important issues of the Microsoft "Windows
CE Toolkit for Visual Basic 6.0" when compared with the 
regular version, is the lack of icons assigned to the 
Applications themselves and to their Forms. The "VBCE Icons 
Tool" is a regular Visual Basic add-on application that runs 
on the developer system to perform two main functions:

	- Build "Resource only DLL's" that include all the 
	  Icons required by a VBCE application. These DLL's 
	  are customized to run on all the processors 
	  supported by Windows CE.

	- Change the output of the  "Application Install  
	  Wizard" - part of the "CE Toolkit for Visual Basic 
	  6.0" - to include the Icon DLL that will assign an 
	  icon to the application on the Windows CE device. 

This application is self contained and does not require any 
additional product (beside the VB6.0 runtime files). All 
the changes are done with no user intervention so that no 
in-depth knowledge of the process is required. 

Free source code examples are included in two ZIP files:

	AppTest.zip	: Assign an Icon to an Application
	FormTest.zip	: Icons on the Taskbar for 2 Forms

Other free source code examples like "How to include a small 
Icon on the Windows CE System Tray" and others, are available 
on our site at:

	http://www.commedia.pt/ce



INSTALL:
========

	- Unzip this file to a temporary directory

	- Run "Setup.exe" to install "VBCE Icons Tool"

	- The free source code examples are contained on 
	  "AppTest.zip" and "FormTest.zip". Unzip these 2
	  files to separate directories

IMPORTANT: To reduce its size, this file does not contain 
the Microsoft Visual Basic 6.0 runtime files. If they are
not yet installed on your system, check this URL:

	http://www.simtel.net/simtel.net/win95/dll.html

Download, unzip and install the VB6 runtime zip file 
(currently simvb6-5.zip) before running the "VBCE Icons 
Tool" setup.



HOW TO USE:
===========

THE MAIN FORM:

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). 



TOOLS:
======

THE IMAGES FORM:

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.


EDIT ICONS:

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.



OPTIONS:
========

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 "Windows
	  CE Toolkit for Visual Basic 6.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. 



VBCE TOOLKIT - THE APPLICATION ICON DRAWBACK:
=============================================

One of the drawbacks of the VB6.0 CE Toolkit 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).



VBCE ICONS TOOL - THE WORKAROUND:
=================================

Proceed as follows:

	- Create your Visual Basic application for Windows CE. 

	- 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 VBCE "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 value 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 VBCE "Application Install 
	  Wizard") .INF file will be backed up and will never 
	  change. This permits several Icon DLL's buildings 
	  with only one VBCE "Application Install Wizard" 
	  execution. 

	- A new .INF file will be built which will include 
	  all the new settings. 

	- The VBCE "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 subdirectory. 



EVALUATION VERSION:
===================

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 their 
COLORS SCRAMBLED


REGISTRATION:
=============

To register "VBCE Icons Tool" there are two options available:

	- Secure Online Registration directly on the web

     	- Download and execute the "Register" program

The Register program provided by Kagi - a shareware payment 
processing service - will accept payments in US Check, 
Money Order, Cash, Visa, Mastercard, American Express, 
First Virtual, and Invoice. 

You either email the data generated by the registration 
program or print it and send it via postal mail or fax. 
Sensitive information, like credit card numbers, is encoded 
for better security. Each payer receives an email reply. 

For either option, access:

	http://www.commedia.pt/ce/Registration.html

or email:

	sales@commedia.pt

for more details. 



PRICE:
======

The price of the version 1.0 of "VBCE Icons Tool" is:

	USD $25.00

