home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 September / Chip_2001-09_cd1.bin / zkuste / delphi / kolekce / d123456 / DFS.ZIP / SystemImageList.txt < prev    next >
Text File  |  2001-06-28  |  10KB  |  181 lines
  1. TdfsSystemImageList v1.16
  2.  
  3. Description:
  4.   TdfsSystemImageList component which extends the TImageList component so that it
  5.   gives access to the Win32 system image list.  The system image list is a list
  6.   of images owned by the Win32 operating system that is made up of all the
  7.   images the OS uses in things like Explorer.
  8.  
  9.   NOTE:  This component can and will provide access to the REAL system image
  10.   list.  That means that if you make changes to the image list, those changes
  11.   are going to be reflected  throughout the OS (i.e. Explorer, file open/save
  12.   dialogs, etc).  If you will be doing something that requires modification of
  13.   the system image list, you must set the ShareImages property to FALSE.  This
  14.   will create a COPY of the system image list, and you can make changes to it
  15.   without effecting other parts of the OS.
  16.  
  17.  
  18. Contact Information:
  19.   The lateset version will always be available on the web at:
  20.     http://www.delphifreestuff.com
  21.   If you have any questions, comments or suggestions, please use the Delphi
  22.   Free Stuff Support Forum at: 
  23.     http://www.delphifreestuff.com/discus/
  24.   If, for some reason, you can not use the web-based support forum, you can
  25.   email me at bstowers@delphifreestuff.com.  However, the support forum will
  26.   always take precedence over direct email since it provides a resource that
  27.   others can use when they have a problem.  Every message posted to the forum
  28.   is emailed directly to this account, so emailing me directly will not get 
  29.   your message to me any faster.  It will only make the message less important
  30.   for me to respond to since only one person (you) is benefiting from it
  31.   instead of everyone interested.  Having said all that, please do email me 
  32.   directly if it is regarding something that isn't really support related, 
  33.   i.e. just to say thanks (as novel as that idea is).  
  34.  
  35.  
  36. Installation:
  37.   Delphi 1:
  38.     * This component is not compatible with Delphi 1.
  39.   
  40.   Delphi 2, C++Builder 1:
  41.     * Select the 'Component | Install' menu item.
  42.     * In the Install Components dialog, click the Add button.
  43.     * In the Add Module dialog, enter the full path name of the component's 
  44.       registration unit (the unit that ends with 'Reg.pas', i.e. 
  45.       'BrowseDrReg.pas') and click OK.
  46.     * In the Add Module dialog, click OK.
  47.     * The component library will be rebuilt and a new tab named 'DFS' will be 
  48.       available on the Component Palette.
  49.  
  50.   Delphi 3, 4, 5, C++Builder 3 & 4:
  51.     * Do one of the following:
  52.       + Create a new package by selecting File | New and choosing Package from
  53.         the New tab in the dialog.
  54.       + Open an existing package file.  I suggest you do this if you already 
  55.         have a package that you like to use for small, third party components.
  56.         I specifically have a package named "3rdParty.dpk" that I use for 
  57.         small components that come from other people.  Or, if you are using
  58.         several of my components, you might create a "DFS.dpk" package and 
  59.         use it for all of my DFS components.
  60.     * In the resulting package window, click the Add button.
  61.     * In the Add dialog, on the Add Unit tab, enter the full path name of the 
  62.       component's registration unit (the unit that ends with 'Reg.pas', i.e. 
  63.       'BrowseDrReg.pas') and click OK.
  64.     * You may want to add the other source files (*.pas) to the package as 
  65.       well in the same manner as you did the registration unit.  While this is
  66.       not required, not doing it will cause compiler warnings when the package
  67.       is compiled.  The component will function fine either way, but I 
  68.       personally find the warnings very irritating and am not happy until 
  69.       every compiler warning and hint is gone.
  70.     * If this package is new, or it has never been installed, click the 
  71.       Install button in the package window.  If this package is already 
  72.       installed in Delphi, click the Compile button.
  73.  
  74.   C++Builder 5 and up:
  75.     * Perform the "Delphi 3 and up, C++Builder 3 and up" steps above, except
  76.       for the last step (Compile or Install).
  77.     * Select the package the component has been added to, and choose 
  78.       Project | Edit Option Source to open the package options in the editor.
  79.     * In the entry for PFLAGS, add the "-LUvcl50" option.  For example:
  80.         <PFLAGS value="-$YD -$W -$O -v -JPHNE -M -LUvcl50"/>
  81.     * Perform the final step from above, Compile or Install.
  82.     * For Borland's official word on this situation, open the C++Builder help
  83.       file and search the index for "dsgnintf.dcu" and see the "Compiling
  84.       packages with DsgnIntf" section.
  85.  
  86.   Delphi 6 and up:
  87.     * Perform the "Delphi 3, 4, 5, C++Builder 3 & 4" steps above, except
  88.       for the last step (Compile or Install).
  89.     * Add the DesignIDE package to the Requires list of the package into which
  90.       the component is being installed.
  91.     * Perform the final step from above, Compile or Install.
  92.     * This is necessary because of changes to the design-time support units
  93.       introduced in Delphi 6.  For complete information, see the Del6New.hlp
  94.       file in your Delphi 6 Help directory.  In the index, search for
  95.       "upgrade issues" and in the resulting list of topics, select the
  96.       "DsgnIntf renamed and related changes" topic.
  97.  
  98.  
  99. Using C++Builder with Delphi Set Types:
  100.   A special note to C++Builder programmers:  Using set types such as the
  101.   TSystemFileAttributes type declared in SystemImageList.pas is not as
  102.   straightforward in C++ as it is in ObjectPascal.  For example, calling the
  103.   GetImageIndex method in Delphi would look like this:
  104.     SysImgList.GetImageIndex('c:\somefile.dat', FALSE, []);
  105.   or:
  106.     SysImgList.GetImageIndex('c:\somefile.dat', FALSE, [sfaReadOnly, sfaHidden]);
  107.   However, in C++Builder, the job is a bit more convoluted.  For those of you
  108.   not yet familiar with sets in C++Builder (there is info in the help file),
  109.   here are the two examples above translated for you:
  110.     SysImgList->GetImageIndex("c:\somefile.dat", false, TSystemFileAttributes());
  111.   and:
  112.     SysImgList->GetImageIndex("c:\somefile.dat", false,
  113.        TSystemFileAttributes() << sfaReadOnly << sfaHidden);
  114.   Because you don't need to pass file attributes if the file you are querying 
  115.   exists, you will probably be calling with an empty set very often.  I suggest
  116.   using a macro for this just to make it more readable, and require less typing:
  117.     #define SIL_NO_ATTRS TSystemFileAttributes()
  118.   Please see the Builder help file if you need more information than that, as
  119.   that's about the full extent of my knowledge of sets in C++Builder.  :)
  120.     
  121.  
  122. Known Issues:
  123.   * There are no known issues at this time.
  124.  
  125.  
  126. Revision History:
  127.  v1.16:  + Updated for Delphi 6 compatibility.  See updated install directions
  128.            above.
  129.  v1.15:  + Updated for C++Builder 5 compatibility.
  130.  v1.14:  + Reworked the GetImageIndex functions.  Some didn't need the Attrs
  131.            parameter (it wasn't used), and those that did now have an
  132.            AlwaysUseAttrs parameter.  This was introduced to allow you to
  133.            specify that you always want to use the attributes passed.  If this
  134.            is false, the functions will try to figure out what the attributes
  135.            are by looking at the thing you are querying for.  This is useful
  136.            because you probably don't want the functions to look at things like
  137.            the A: drive.  Instead, you would pass [sfaDirectory] as the
  138.            attributes parameter and TRUE for AlwaysUseAttributes.  That way it
  139.            won't try to figure out the attributes, and thus cause the drive to
  140.            spin up.  Not good at all if there's no disk in the drive.
  141.          + A couple of the GetIconIndex functions used Application.MainForm.
  142.            This was bad if you didn't have an Application.MainForm, or it hadn't
  143.            been set yet (i.e. in the main form's OnCreate event).  Fixed by
  144.            Christian Stein, many thanks.
  145.          +
  146.  v1.13:  + It's *really* D5 compatible now.  Small change between the D5 eval
  147.            version and the real, shipping D5 version broke it.
  148.  v1.12:  + Classname changed.
  149.          + D5 compatibility.
  150.  v1.11:  + Added Open parameter to all the functions and methods to get an
  151.            image index for an "open" item.  Generally, this only applies for
  152.            things like directories as most items' open image is the same as the
  153.            normal image.  For example, you'd assign the open index to a tree
  154.            node's SeectedImage property to make it behave like explorer.
  155.  v1.10:  + Added methods for getting the image index for PIDLs (PItemIDLists),
  156.            and for special shell items like Control Panel.  For example, to get
  157.            the image index for the Desktop item, you could do the following:
  158.              ImageIndex := SystemImageList1.GetImageIndex(siDesktop, FALSE, []);
  159.            The same has been added for the GetFileInformation method.
  160.            NOTE:  These are overloaded functions in D4, so the method names are
  161.            the same (GetImageIndex, GetFileInformation).  Overloading was only
  162.            introduced in D4, so in prior versions the methods are named
  163.            GetImageIndexPIDL and GetImageIndexSpecial (same scheme for
  164.            GetFileInformation).
  165.  v1.00:  + Initial public release.  The following items are included for those
  166.            who are upgrading from the old Beta 3 version.  All beta history has
  167.            been removed as it is not of general interest.
  168.          + Removed the inherited "ImageList Editor" component editor (on the
  169.            component context menu, also the one you get if you double click it).
  170.            The Delphi image list editor doesn't seem to be able to handle the
  171.            system image list, I suspect because it is so large.
  172.          + Version property was stored, but it shouldn't have been.  You may get
  173.            an error about this property not existing (or something similar) when
  174.            you open a project that used an older version; just tell it to ignore
  175.            it and everything should be fine.
  176.          + Added Selected parameter to TdfsSystemImageList.GetImageIndex and
  177.            GetFileInformation methods, GetIconIndex function,
  178.          + Demo rewritten.  It's now a little more useful, showing your basic
  179.            explorer-type app.
  180.  
  181.