TSysImageList for Delphi 3-5
----------------------------

Autor: Kambiz R. Khojasteh
E-mail: khojasteh@mail.com
Web: http://www.crosswinds.net/~khojasteh/


TSysImageList is a special ImageList that contains the icons used by the Windows
operating system. By using ImageIndexOf method presented in this component you
can find the image associated to any file, folder, special folder, or URL.

Important note: Please do not change any property of component except which that 
are listed below. Especially by changing SharedImage property to false you will 
lose all system icons in the current session of Windows. 
    

P R O P E R T I E S
-------------------

* BlendColor: TColor; 
  Determines which foreground color to use when drawing an image. 
  
* BkColor: TColor; 
  Determines which background color to use when drawing an image. 
  
* DrawingStyle: TDrawingStyle;
  TDrawingStyle = (dsFocus, dsSelected, dsNormal, dsTransparent); 
  Specifies the style to be used when the image list is drawing an image.
  
     dsFocused 	    Draws the image blending 25% with the color specified by 
                    the BlendColor property. This only affects image lists that 
                    contain masks. 
     dsSelected     Draws the image blending 50% with the color specified by 
                    the BlendColor property. This only affects image lists that
                    contain masks. 
     dsNormal 	    Draws the image using the color specified in the BkColor 
                    property. If the BkColor is clNone, the image is drawn  
                    transparently using the mask. 
     dsTransparent  Draws using the mask regardless of the BkColor setting. 
  
* IconSize: TIconSize;
  TIconSize = (isSmallIcons, isLargeIcons); 
  Specifies the size of each image in the image list.
  
  isSmallIcons 	  Fills image list by using system small icons (16x16).
  isLargeIcons 	  Fills image list by using system large icons (32x32).
 

E V E N T S
-----------

* OnChange: TNotifyEvent
  Occurs when the image list changes.


M E T H O D S
-------------

* function TSysImageList.ImageIndexOf(const Path: String; OpenIcon: Boolean): Integer;
  This function returns index of the image associated to the path in the image list.
  Path can be a full file path, a file mask, a folder, a special folder, a protocol, 
  or an URL. If OpenIcon parameter is true, the returned index is index of the image 
  when the path is open. If function does not find any image, it will return -1.

  Examples:

     Index := SysImageList.ImageIndexOf('c:\autoexec.bat', False);
     Index := SysImageList.ImageIndexOf('c:\Windows', True);
     Index := SysImageList.ImageIndexOf('*.pas', False);
     Index := SysImageList.ImageIndexOf('gopher:', False);
     Index := SysImageList.ImageIndexOf('http://www.borland.com', False);
     Index := SysImageList.ImageIndexOf('My Documents', False);


H I S T O R Y
-------------

* Version 1.01 - 10 Nov 2000
  - A minor bug fixed.

* Version 1.00 - 1 Oct 2000
  - Initial release.


D I S C L A I M E R
-------------------

TSysImageList component is freeware. You may copy component's files AS LONG AS YOU COPY 
ALL OF THEM. If you want to change the source code in order to improve the component's 
features, performance, etc. please send me the new source code so that I can have a look 
at it. The changed source code should contain descriptions what you have changed, and of 
course your name. The only thing you MAY NOT CHANGE is the ORIGINAL COPYRIGHT INFORMATION. 
The author is NOT liable for any DAMAGES resulting from the use and misuse of the 
component, especially he is NOT liable for DAMAGES that were caused BY ANY VERSION WHICH 
HAS NOT BEEN PROGRAMMED BY THE AUTHOR HIMSELF.


If you have any suggestions or bug reports about this component, feel free to mail me.

Have fun!
Kambiz
