home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 September / Chip_2001-09_cd1.bin / zkuste / delphi / kolekce / d123456 / DFS.ZIP / DFSToolBar.txt < prev    next >
Text File  |  2001-06-28  |  8KB  |  147 lines
  1. TdfsToolBar v1.13
  2.  
  3.  
  4. Description:
  5.   A descendant of the TToolBar component (D3, C3, & D4) that adds a
  6.   "maximize - restore" button.  This mimics the behavior of the toolbar in
  7.   Netscape Communicator.  Clicking the button makes the toolbar small, hiding
  8.   its controls.  Clicking again returns it to normal.
  9.  
  10.  
  11. Contact Information:
  12.   The lateset version will always be available on the web at:
  13.     http://www.delphifreestuff.com
  14.   If you have any questions, comments or suggestions, please use the Delphi
  15.   Free Stuff Support Forum at:
  16.     http://www.delphifreestuff.com/discus/
  17.   If, for some reason, you can not use the web-based support forum, you can
  18.   email me at bstowers@delphifreestuff.com.  However, the support forum will
  19.   always take precedence over direct email since it provides a resource that
  20.   others can use when they have a problem.  Every message posted to the forum
  21.   is emailed directly to this account, so emailing me directly will not get
  22.   your message to me any faster.  It will only make the message less important
  23.   for me to respond to since only one person (you) is benefiting from it
  24.   instead of everyone interested.  Having said all that, please do email me
  25.   directly if it is regarding something that isn't really support related,
  26.   i.e. just to say thanks (as novel as that idea is).
  27.  
  28.  
  29. Installation:
  30.   Delphi 1, Delphi 2, C++Builder 1:
  31.     * This component is not compatible with Delphi 1, 2, or C++Builder 1.
  32.  
  33.   Delphi 3 and up, C++Builder 3 and up:
  34.     * Do one of the following:
  35.       + Create a new package by selecting File | New and choosing Package from
  36.         the New tab in the dialog.
  37.       + Open an existing package file.  I suggest you do this if you already 
  38.         have a package that you like to use for small, third party components.
  39.         I specifically have a package named "3rdParty.dpk" that I use for 
  40.         small components that come from other people.  Or, if you are using
  41.         several of my components, you might create a "DFS.dpk" package and 
  42.         use it for all of my DFS components.
  43.     * In the resulting package window, click the Add button.
  44.     * In the Add dialog, on the Add Unit tab, enter the full path name of the 
  45.       component's registration unit (the unit that ends with 'Reg.pas', i.e. 
  46.       'BrowseDrReg.pas') and click OK.
  47.     * You may want to add the other source files (*.pas) to the package as 
  48.       well in the same manner as you did the registration unit.  While this is
  49.       not required, not doing it will cause compiler warnings when the package
  50.       is compiled.  The component will function fine either way, but I 
  51.       personally find the warnings very irritating and am not happy until
  52.       every compiler warning and hint is gone.
  53.     * If this package is new, or it has never been installed, click the 
  54.       Install button in the package window.  If this package is already 
  55.       installed in Delphi, click the Compile button.
  56.  
  57.   C++Builder 5 and up:
  58.     * Perform the "Delphi 3 and up, C++Builder 3 and up" steps above, except
  59.       for the last step (Compile or Install).
  60.     * Select the package the component has been added to, and choose 
  61.       Project | Edit Option Source to open the package options in the editor.
  62.     * In the entry for PFLAGS, add the "-LUvcl50" option.  For example:
  63.         <PFLAGS value="-$YD -$W -$O -v -JPHNE -M -LUvcl50"/>
  64.     * Perform the final step from above, Compile or Install.
  65.     * For Borland's official word on this situation, open the C++Builder help
  66.       file and search the index for "dsgnintf.dcu" and see the "Compiling
  67.       packages with DsgnIntf" section.
  68.  
  69.   Delphi 6 and up:
  70.     * Perform the "Delphi 3, 4, 5, C++Builder 3 & 4" steps above, except
  71.       for the last step (Compile or Install).
  72.     * Add the DesignIDE package to the Requires list of the package into which
  73.       the component is being installed.
  74.     * Perform the final step from above, Compile or Install.
  75.     * This is necessary because of changes to the design-time support units
  76.       introduced in Delphi 6.  For complete information, see the Del6New.hlp
  77.       file in your Delphi 6 Help directory.  In the index, search for
  78.       "upgrade issues" and in the resulting list of topics, select the
  79.       "DsgnIntf renamed and related changes" topic.
  80.  
  81.  
  82. Notes:
  83.   * If you like this Netscape style enhancement, you may also be interested in
  84.     the TdfsSplitter component on my web site.
  85.   * Version 2.0 (whenever that happens) will have the ability to collapse
  86.     multiple toolbars into a single tab line like Netscape.  At this point,
  87.     I just want the single toolbar to work.  Supporting multiples in a single
  88.     line is going to be very complex internally, so I am putting it off until
  89.     I'm satisfied with it as it is now.
  90.  
  91.  
  92. Known Issues:
  93.   * If the toolbar is placed on a TControlBar, you will have to set the
  94.     TControlBar's RowSnap property to FALSE.  If you don't the TControlBar
  95.     will come behind me and reset the toolbar's height (that's what RowSnap
  96.     does) when it is being minimized, resulting in a really big tab button.
  97.   * The toolbar does not like being drag-n-drop style (DragKind = dkDock).
  98.     It gets really ugly.  Don't do this unless *you* want to try to make it
  99.     work.  This applies to Delphi 4 only since there's no such thing in D3.
  100.   * There were some problems with setting AutoSize to TRUE during early
  101.     private betas, but I think it is all worked out.  Still, you should be on
  102.     the look out for any curious behavior with AutoSize set to TRUE.
  103.   * The tab seems to get stuck with the highlight color sometimes in the IDE.
  104.     It doesn't seem to happen at run-time, so I'm inclined not to wory about it.
  105.     I had original thought to not even paint with the highlight color in the IDE
  106.     but figured it would make selecting the TabHighlightColor property easier if
  107.     you could actually see it at design-time.
  108.   * It is possible to get the direction arrows to paint outside of the button
  109.     if you use really big values for the TabSizeXXX properties.  If you're silly
  110.     enough to do it, you're silly enough to like it.  I don't consider it worth
  111.     the trouble to fix.  If you can make a reasonable case otherwise, send me
  112.     email.
  113.  
  114.  
  115. TdfsToolBar Revision History:
  116.  1.13: + Updated for Delphi 6 compatibility.  See updated install directions
  117.          above.
  118.  1.12: + Updated for C++Builder 5 compatibility.
  119.  1.11: + Fixed problem with Caption not appearing in some compilations.
  120.  1.10: + Added Caption property.  Caption is displayed to the left or below the
  121.          tab, depending on orientation, when the toolbar is minimized using the
  122.          Font property.  Also, note that only true-type fonts will rotate, so if
  123.          your toolbar is oriented vertically you need to make sure you have a
  124.          true-type font selected.  If not, Arial will be substituted.
  125.        + Adding the above feature also revealed a repaint problem that could
  126.          occur when the maximized state was changed.  This is related to the
  127.          problem that was (partially) addressed in v1.05.
  128.        + alNone alignment problems have been corrected.
  129.  1.05: + Fixed problem with buttons appearing in a minimized toolbar when the
  130.          parent form was maximized.
  131.  1.04: + It's *really* D5 compatible now.  Small change between the D5 eval
  132.          version and the real, shipping D5 version broke it.
  133.  1.03: + D5 compatibility.
  134.  1.02: + With AutoSize set to false, button hints and click events could still
  135.          occur.
  136.  1.01: + Added two known issues.
  137.        + Added DFSToolBarReg unit.  All IDE specific code (i.e. registering the
  138.          component, property editors, etc.) are contained in this unit.  This
  139.          was done for two primary reasons:  1) Using the component in a Delphi
  140.          or C++Builder expert would register the component as well.  2) Reduce
  141.          code size in some cases -- usually the smart linker removes this sort
  142.          of stuff since the app never references it, but now it's for certain
  143.          since it isn't even in the unit.  This change means that you need to
  144.          install the component using the new "registration" unit instead of
  145.          the unit containing the component.
  146.  1.00: + Initial release
  147.