home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 16 / CD_ASCQ_16_0994.iso / news / 2549 / toolbr11 / readme.1st < prev    next >
Text File  |  1994-05-12  |  10KB  |  225 lines
  1. TOOLBARS VERSION 1.1
  2.  
  3.            Two controls for Visual Basic that allow easy creation
  4.            of button-bars and status-bars in any Visual Basic for
  5.            Windows (version 2.0 or higher) application.
  6.  
  7.  
  8. 1. GENERAL INFORMATION
  9.  
  10.            The TOOLBARS.VBX contains two custom controls for
  11.            Visual Basic: StatusBar and ButtonBar. Both controls
  12.            have an integrated helpfile that can be called from the
  13.            VB development environment when you press F1 in the
  14.            properties-window or when you select an event in the
  15.            code window. There are also some ready to use examples
  16.            in the helpfile. Therefore this documentation-file is
  17.            very brief.
  18.            If you have a problem with (one of these) controls, or
  19.            think of an enhancement that I don't already have
  20.            planned (see the æfuture enhancementsÆ section below),
  21.            please e-mail to the special account that has been set
  22.            up for this purpose: vbx_dev@shear.iaf.nl.
  23.  
  24.  
  25. 2. SHORT DESCRIPTION OF VERSION 1.0 FEATURES
  26.  
  27.            The StatusBar control allows you to create a statusbar
  28.            at the top or bottom of the client area of your
  29.            application to display status-messages. It offers 20
  30.            fully configurable text-fields and a few other extras
  31.            as well. Here's a quick summation:
  32.            -    automatically adjusted border-line for different
  33.                 alignments (top, bottom or none)
  34.            -    automatically size one field (ExpandField
  35.                 property) to fill the entire status-area (can be
  36.                 turned off). If the window is resized, one of the
  37.                 statusbar fields is resized as well.
  38.            -    can be used as a progress indicator (FloodField,
  39.                 FloodInvertText, FloodPercent, FloodShowPct,
  40.                 FloodColor properties). Absolutely no flickering
  41.                 on updates.
  42.            -    adjustable left- and right-margins (LeftMargin and
  43.                 RightMargin property
  44.            -    etc...
  45.  
  46.            Text-field specific properties:
  47.            -    alignment (left, right or centered) (Alignment
  48.                 property array)
  49.            -    font-color (ForeColor property array)
  50.            -    message (the text to display in the text-field)
  51.                 (Message property array)
  52.            -    field type (FieldType property array)
  53.                 Field-types are:
  54.                 - normal (display text in Message property)
  55.                 - clock (type-of clock can be set with the
  56.                   with ClockFormat property)
  57.                 - num-lock indicator (user-definable text for
  58.                   on- and off state)
  59.                 - scroll-lock indicator    (    "   "     )
  60.                 - caps-lock indicator      (    "   "     )
  61.            -    field width (FieldWidth property array)
  62.            -    define spacing between fields (SpaceAfter property
  63.                 array)
  64.            -    control type (for TypeOf statements): StatusBar
  65.            -    etc...
  66.  
  67.            The ButtonBar control allows easy creation of a
  68.            buttonbar at the top or bottom of the client area of
  69.            your application. You only have to specify a picture
  70.            for the button to create it. The ButtonBar
  71.            automagically creates the needed bitmaps for the down
  72.            and disabled states for the button with the picture you
  73.            specify. It's also possible to specify a picture for
  74.            the disabled state of the button if you don't like the
  75.            ButtonBar's disabling method. Summation of features:
  76.            -    automatically adjusted border-line for different
  77.                 alignments (top, bottom or none)
  78.            -    create buttons by simply specifying one or two
  79.                 bitmaps for the up-state of the button (Picture
  80.                 and PictureDisabled property arrays).
  81.            -    2 types of buttons available: normal and 2-state
  82.                 (ButtonType property array)
  83.            -    group buttons into GroupPushButtons (ButtonGroup
  84.                 and GroupAllowAllup property arrays)
  85.            -    enable or disable individual buttons
  86.                 (ButtonEnabled property array)
  87.            -    connect the ButtonBar to the StatusBar to display
  88.                 a message in a textfield when a user selects a
  89.                 button (hWndStatusBar and StatusField properties,
  90.                 and the ButtonMessage property array).
  91.            -    define spacing between buttons (SpaceAfter
  92.                 property array)
  93.            -    control type (for TypeOf statements): ButtonBar
  94.            -    etc...
  95.  
  96.  
  97. 3. KNOWN PROBLEMS/BUGS
  98.  
  99.            None at the moment. If you find any however, please
  100.            inform me at the e-mail address earlier in this file.
  101.  
  102.  
  103. 4. DIFFERENCES WITH VERSION 1.0 / WHAT'S NEW ?
  104.  
  105.            Two bugs have been fixed:
  106.            -    when setting the ClockFormat property for the
  107.                 StatusBar control to an AM/PM  clock, the AM/PM
  108.                 time-indication wasn't properly updated at 12 noon
  109.                 and 12 o'clock midnight. This bug has been fixed.
  110.            -    the ButtonBar control released the mouse capture after
  111.                 the Click event. This is no problem if you don't show
  112.                 modal forms on a click on a button, but when you do
  113.                 display a modal form on a click, this window can't
  114.                 receive the input-focus. This bug has been fixed by
  115.                 releasing the mouse capture before firing the click
  116.                 event.
  117.  
  118.            Three new properties and a new event were added to the
  119.            StatusBar:
  120.            -    toggle event: this event is fired whenever the num-lock
  121.                 caps-lock or scroll-lock key is pressed. It helps you
  122.                 to keep track of the status of these keys, for example
  123.                 when you're writing a text-editor.
  124.            -    AutoToggle allows users to double-click on a num-lock,
  125.                 caps-lock or scroll-lock field. The statusbar control
  126.                 automatically sets or resets the state of the toggle-key.
  127.            -    Numlock, Capslock and ScrollLock properties allow you to
  128.                 get or set the status of the num-lock, caps-lock or
  129.                 scroll-lock keys.
  130.  
  131.            The ButtonBar also has a new feature:
  132.            -    The OutlineChildren automatically gives a three-D
  133.                 outline to controls placed on the buttonbar, to make
  134.                 them look raised or inset.
  135.  
  136.            Also, some very stupid mistakes were corrected:
  137.            -    The Enabled property was added to the StatusBar
  138.            -    The Visible and Enabled properties were added to
  139.                 the ButtonBar
  140.  
  141. 5. FUTURE ENHANCEMENTS
  142.  
  143.            I can think of only one future enhancement for the
  144.            StatusBar control:
  145.            -    different font-properties (FontName, FontSize etc.)
  146.                 for each text-field.
  147.  
  148.            The ButtonBar control however has some extra features
  149.            I'm considering to implement:
  150.            -    bitmaps for all states of the buttons (up, down,
  151.                 disabled up and down)
  152.            -    specify only one bitmap to define all buttons at
  153.                 once (like the picture-clip control)
  154.            -    tooltips (like in Word 6.0)
  155.            -    moveable toolbar (like the toolbars in Word 6.0)
  156.            -    alignment at the top, bottom, left and right of
  157.                 the form.
  158.  
  159.            If you have more suggestions or remarks, let me know.
  160.  
  161.  
  162. 5. ARCHIVE CONTENTS AND INSTALLATION NOTES
  163.  
  164.            This archive's original name is TOOLBR11.ZIP and contains
  165.            the following files:
  166.  
  167.            TOOLBARS.VBX   The toolbars vbx-library.
  168.            TOOLBARS.HLP   Design time helpfile.
  169.            README.1ST     This file
  170.            SHEAR.LIC      License file
  171.  
  172.            In order to use the toolbars vbx you must copy the
  173.            files TOOLBARS.VBX and SHEAR.LIC to your Windows system
  174.            directory. If you donÆt copy the SHEAR.LIC file, the
  175.            VBX will not work in at design-time. To be able to use
  176.            the design time help, you must copy the TOOLBARS.HLP
  177.            file to the Visual Basic directory.
  178.  
  179.  
  180. 6. DISCLAIMER
  181.  
  182.            The TOOLBARS.VBX control library is distributed "as is"
  183.            and without warranties as to performance or
  184.            merchantability or any other warranties whether
  185.            expressed or implied. No warranty of fitness for a
  186.            particular purpose is either expressed or implied.
  187.  
  188.  
  189. 7. LICENCE AGREEMENT AND COPYRIGHT
  190.  
  191.            In this notice, "The controls" refers to the
  192.            TOOLBARS.VBX custom controls library for Visual Basic
  193.            and the "the author" refers to Arjen Broeze.
  194.  
  195.            The control is copyright (C) 1994 by the author. You may
  196.            distribute this control with your applications under
  197.            certain conditions. Firstly, it may not be distributed
  198.            with commercial or shareware applications without the
  199.            permission of the author. You may use this control in
  200.            your applications for your own use without
  201.            restriction. The control may be used in Public Domain
  202.            applications  where the author states in the
  203.            documentation that the control is copyright of and
  204.            written by the author.
  205.  
  206. 8. FURTHER NOTES
  207.  
  208.            This is the second release of TOOLBARS.VBX. Although
  209.            some bugs have been fixed, It's still not guaranteed
  210.            error-free, but I think it works pretty well. If you
  211.            wish to use it in your applications (subject to the
  212.            above restrictions), you may do so.
  213.  
  214.            To use the TOOLBARS.VBX in a commercial or shareware
  215.            application, you must obtain a commercial version. This
  216.            version will be shareware with a small registration fee
  217.            (25 Dutch guilders for shareware use and 50 Dutch
  218.            guilders for commercial use). If you want to order a
  219.            commercial version, then e-mail to vbx_dev@shear.iaf.nl.
  220.  
  221.            Arjen Broeze
  222.            29/04/94
  223.  
  224.  
  225.