ARG-Software Command Bars Library
                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                    What's new in the latest version
                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[!] Important
[+] New
[-] Fixed error
[*] Changes
[NNNNN] Issue Id


---------------------------------------------------------------------------
Version 10.3.002 - 2025-07-19
---------------------------------------------------------------------------

Ribbon class
~~~~~~~~~~~~
[!][-] CustomUI. "itemSize" attribute of a child "menu" element of "splitButton" element was not processed while loading Ribbon definition from XML file.

       For example: <splitButton ... ><button ... /><menu ... itemSize="large""> was not processed.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.3.001 - 2025-06-18
---------------------------------------------------------------------------

General
~~~~~~~
[!][-] Right-aligned controls appear incorrectly if their BeginGroup property is set to .T.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.3.000 - 2024-10-03
---------------------------------------------------------------------------

General
~~~~~~~
[!][*] Barcode/QR-code scanners may produce wrong result when used on a form with Command Bars.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.2.001 - 2021-12-19
---------------------------------------------------------------------------

General
~~~~~~~
[!][*] Some anti-viruses may block access to the library files, because they detect them (False Positive) as viruses or so.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.2.000 - 2021-11-11
---------------------------------------------------------------------------

General
~~~~~~~
[!][+][*] Added support for VFP Advanced 64-bit.

       For more information visit: http://www.baiyujia.com/vfpadvanced/


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.1.017 - 2021-10-01
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] SetFontSize method. Sets the font size for text displayed on command bars, menus. Available at run time only.
    
    Syntax:     SetFontSize( tnFontSize)

    Parameters:
                tnFontSize - Specifies the size of the font in points. Value from 8 to 32, or 0 to reset it to default.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.1.016 - 2021-10-01
---------------------------------------------------------------------------

CommandBar's controls
~~~~~~~~~~~~~~~~~~~~~

[+] ForeColor property. Sets the foreground color used to display text of a control.


Internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.1.000 - 2019-04-04
---------------------------------------------------------------------------

General
~~~~~~~
[!][+] Added support for VFP Advanced (32-bit only).
    For more information visit: http://www.baiyujia.com/vfpadvanced/


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.0.000 - 2018-03-25
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] SubsequentClickCount property.
    
    Specifies whether subsequent clicks are allowed (and how many) while VFP is executing click code of other control (for example, modal form is displayed).

    Default is 0; subsequent clicks not allowed.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.0.RC2 - 2017-12-07 (PREVIEW BUILD)
---------------------------------------------------------------------------

General
~~~~~~~

[!][-] VFP crashes when you maximize child MDI form.
       Applies only to Windows 8/10 Ribbon theme.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 10.0.RC1 - 2017-11-30 (PREVIEW BUILD)
---------------------------------------------------------------------------

General
~~~~~~~

[!][+] Windows 8/10 Ribbon theme.

[!][*] Color schemes changed. Added new Windows 8/10 color scheme.

[!][*] ARGRibbonResource.dll file updated.

[!][+] DpiAware class. Useful for High-DPI. Drop it onto your form and call ScaleControls()
       to rescale form size and all controls according the current DPI settings.

       For example (in the Init() of your form):

           ThisForm.DpiAware.ScaleControls()


[!][+] DpiAwareForm class. Useful for High-DPI. Create your forms based on this class
       to automatically rescale form size and all controls according the current DPI settings.
       
       Note: If you override Load() and/or Init() events, do not forget to call DoDefault().

... and more ...


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[!][*] ColorScheme property. Returns the current color scheme.

    Values:  0 - Office 2007 Blue     (default);
             1 - Office 2007 Black;
             2 - Office 2007 Aqua;
             3 - Office 2007 Silver;
             4 - Office 2010 Blue;
             5 - Office 2010 Silver;
             6 - Office 2010 Black;
             7 - Windows 7 Scenic;
             8 - Windows 8/10;

[!][*] SetColorScheme method. Sets the current visual theme and built-in color scheme.

    Syntax:     SetColorScheme( tnVisualTheme, tnColorScheme)

    Parameters:
                tnVisualTheme - specifies the base visual theme:

                          6 - Office 2007;
                          7 - Ribbon.

                tnColorScheme - specifies the color scheme:

                          0 - Office 2007 Blue     (default);
                          1 - Office 2007 Black;
                          2 - Office 2007 Aqua;
                          3 - Office 2007 Silver;
                          4 - Office 2010 Blue;
                          5 - Office 2010 Silver;
                          6 - Office 2010 Black;
                          7 - Windows 7 Scenic;
                          8 - Windows 8/10;

Ribbon class
~~~~~~~~~~~~

[!][*] Corrected CustomUI support.

[!][+] CustomUI. Support for "//customUI/ribbon/contextualTabs" element containing a collection of contextual tab sets "tabSet" elements.
       Each "//customUI/ribbon/contextualTabs/tabSet" element contains definition of contextual tabs, "tab" elements.

[!][+] CustomUI. Support for "//customUI/contextMenus" element containing definitions of context menus.

[!][+] ContextMenus object.

       Contains a collection of context menus loaded from customUI XML file or created at design/run-time.

       For example, to display a context menu in your code you can use:
    
           ThisForm.CBM.ShowPopupMenu( ThisForm.Ribbon.ContextMenus.someContextMenu1)

[!][-] RemovaAllTabs() method causes error in the RibbonTab.ReindexControls() method.


... and more ...


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 9.1.000 - 2017-02-15
---------------------------------------------------------------------------

Intermediate internal release


---------------------------------------------------------------------------
Version 9.0.000 - 2016-10-20
---------------------------------------------------------------------------

Intermediate internal release


---------------------------------------------------------------------------
Version 8.3.002 - 2016-03-19
---------------------------------------------------------------------------


General
~~~~~~~
[*] Library crashes when InkEdit ActiveX control is used on a form and that form gets released.

    Actually, it is not the library bug, but InkEdit control internal bug.
    So, this library update is a workaround for that InkEdit control bug.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.3.001 - 2016-02-03
---------------------------------------------------------------------------


General
~~~~~~~
[-] Library crashes with "unhandled exception in KernelBase.dll" on Windows 10 (build 10586 or higher) when user changes system theme, colors and so on.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.3.000 - 2015-03-07
---------------------------------------------------------------------------


General
~~~~~~~

[!][*] Some PNG images are not displayed.

[*] Re-worked internal functions that processes PNG images. Now the library uses GdiPlus features, instead of libpng.


Ribbon class
~~~~~~~~~~~~

[*] Control buttons (minimize, restore, close) of maximized child MDI form are not displayed even if HideMdiButtons is set to False.


RibbonTab class
~~~~~~~~~~~~~~~

[-] When Index property changes at run-time, the tab position also changes (that is correct); but object's position in the Ribbon.Tabs collection doesn't change.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.2.003 - 2011-09-16
---------------------------------------------------------------------------

DialogBar class
~~~~~~~~~~~~~~~

[!][-] Version 8.2.002 generates "API call caused an exception" error. DialogBar doesn't display its child form.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.2.002 - 2011-09-14
---------------------------------------------------------------------------

General
~~~~~~~

CommandBar class
~~~~~~~~~~~~~~~~

[+] DelayRedraw method. Call this method to redraw command bar.
    May be useful to force commandbar redrawing after you made changes to its controls.

    For example:


    ThisForm.Ribbon.LockRedraw = .T.

    ... change the commandbar/ribbon controls' properties here: change picture and so on...

    ThisForm.Ribbon.DelayRedraw()
    ThisForm.Ribbon.LockRedraw = .F.

[-] Tooltips of some controls displayed too wide, trailing spaces not trimmed.


Ribbon.QuickAccessToolbar object
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Controls do not refresh according evaluated value of the SkipFor and MarkFor properties.

[+] RemoveAddedControls method. Removes all controls (added by the user at run-time)
    from the QuickAccessToolbar.

[+] RemoveAllControls method. Removes all controls from the QuickAccessToolbar.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.2.001 - 2011-06-10
---------------------------------------------------------------------------

General
~~~~~~~

[-] GPF (General Protection Fault) error may happen when application quits,
    if application uses several forms (or opens/closes one form several times)
    with Office frame (CBM.EnableOfficeFrame=.T.).

[*] Corrected and enhanced Ribbon themes for Windows Vista/7 Aero.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.2.000 - 2011-04-20
---------------------------------------------------------------------------

General
~~~~~~~

[!][*] If you use Command Bars library with controls from the Common Controls library,
    make sure you use the latest release (6.1 or later) of the Common Controls Library.

[*] The main VFP screen doesn't resize correctly, frame may disappear in case of command bars are attached to the Screen and the main VFP menu is hidden (AttachToScreen = .T., or CommandBarsManager added directly to the Screen and HideSysMenu = .T.).

[!][-] Fixed some potential problems that may cause "API call caused an exception" error.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] DoEvents method. Executes all pending Windows events. Useful when _VFP.AutoYield is set to False. DoEvents method doesn't impact performance and works a lot faster than standard 'DOEVENTS FORCE' command.

[+] SuspendIdleUpdate property. When set to True, the library doesn't refresh command bars (SkipFor and MarkFor properties are not evaluated) on the form in the idle state. Default is False.

[+] UseKeyboardCues property. Gets or sets a value indicating how keyboard cues (hot key underlines/access keys) are used.
    For example: control has the Caption property set to "\<File", "F" is its access key, so control can be activated by pressing Alt+F key.

    Values:  0 - Not used;
             1 - Activate items by using access key only, default;
             2 - Activate items by using access key or the firts character of the Caption, if access key not assigned.

[+] OnCommandBarCustomized event. Occurs when the user has customized the CommanBar, added/removed control(s).

    Syntax:     OnCommandBarCustomized( toCommandBar)

    Parameters:
                toCommandBar - customized commandbar.


[*] HideSysMenu property. When set to True, hides the main VFP menu only if command bars are attached to the Screen (AttachToScreen = .T. or CommandBarsManager added directly to the Screen).

[*] Enabled property. When set to False, in addition to the disabled/locked command bars it also suspends all controls refresh in the idle state. SkipFor and MarkFor properties are not evaluated, this provides more CPU time to your program.

[*] BeginModalState method. In addition to the disabled/locked command bars it also suspends all controls refresh in the idle state. SkipFor and MarkFor properties are not evaluated, this provides more CPU time to your program.


CommandBar class
~~~~~~~~~~~~~~~~

[+] OnCustomized event. Occurs when the user has customized the CommanBar, added/removed control(s).

[+] OnCustomizedDelegate property. Specifies the function/method, or "delegate", that handles OnCustomized event. Default is "This.OnCustomized".

    Delegate parameters:

                toCommandBar - customized commandbar.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.008 - 2010-12-24
---------------------------------------------------------------------------

General
~~~~~~~
[-] Tooltips for native VFP controls may contain unspecified and unexpected image, in some cases.
 
    Note: when CBM.ShowFormTips is set to True.


---------------------------------------------------------------------------
Version 8.1.007 - 2010-12-24
---------------------------------------------------------------------------

General
~~~~~~~
[*] Only one OnAction code/procedure can be executed at a time.
    This means: while the OnAction code is running, any subsequent pressing/clicking of other controls do not execute their OnAction code.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] BeginModalState method.

    Tip: You can use BeginModalState method to prevent pressing/clicking controls on the main form while a child modal form is running.

    For example:

        ThisForm.CBM.BeginModalState()
        Do Form MyModalForm
        ThisForm.CBM.EndModalState()


[+] EndModalState method.


Ribbon class
~~~~~~~~~~~~

[+] OnTabChanged event. Occurs when the active tab is changed.

    Syntax:     OnTabChanged( tnTabIndex)

    Parameters:
                tnTabIndex - the index of the current/active tab.


[!][*] OnActiveTabChanged event is obsolete and will be removed in future version. Use OnTabChanged event instead.

[!][*] OnTabSelected event is obsolete and will be removed in future version. Use OnTabChanged event instead.

[+] AllowQuickAccessToolbarPositionChange property. Specifies whether the position of the Quick Access Toolbar can be changed (show above/below the Ribbon). Default is True.

[*] Misspelled AllowQuickAccessToolbarPostionChange property is obsolete and will be removed in future version.
    
    Use AllowQuickAccessToolbarPositionChange property instead.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.006 - 2010-11-13
---------------------------------------------------------------------------

Minor changes and corrections.

---------------------------------------------------------------------------
Version 8.1.005 - 2010-11-03
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] ClosePopups method. Closes all open/displayed popups and tooltips.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.004 - 2010-10-28
---------------------------------------------------------------------------

Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[*] Corrected some CustomUI issues.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.003 - 2010-10-22
---------------------------------------------------------------------------

Ribbon class
~~~~~~~~~~~~

[+] OnTabChanging event. Occurs when the active tab is about to be changed.

    Syntax:     OnTabChanging( tnNewTabIndex)

    Parameters:
                tnNewTabIndex - the index of the tab to be selected.

    Returns:
                .T. - to allow the tab to be selected, default;
                .F. - to prevent active tab change.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.002 - 2010-10-15
---------------------------------------------------------------------------

CommandBar/MenuBar/Popup/Ribbon controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Delete method generates "API call caused an exception" error.
    Applies only to popup type controls: split button, popup, etc.


Ribbon class
~~~~~~~~~~~~

[+] RemoveAll method. Removes all ribbon tabs, groups, controls, OfficeMenu items and QuickAccessToolbar items.

    Note: this method doesn't remove inherited controls: cmdMinimizeRibbon, cmdAbout, OfficeMenu.RecentFileList.

[+] RemoveAllTabs method. Removes all ribbon tabs.

[+] RemoveAllControls method. Removes all controls directly placed on the Ribbon.

    Note: this method doesn't remove inherited controls: cmdMinimizeRibbon, cmdAbout.


RibbonTab class
~~~~~~~~~~~~~~~

[+] Delete method. Deletes the Ribbon tab.

[+] RemoveAllGroups method. Removes all groups of the Ribbon tab.


RibbonGroup class
~~~~~~~~~~~~~~~~~

[+] Delete method. Deletes the Ribbon group.

[+] RemoveAllControls method. Removes all controls of the Ribbon group.

    Note: this method doesn't remove inherited controls: DialogLauncher.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.001 - 2010-10-14
---------------------------------------------------------------------------

General
~~~~~~~
[*] Ribbon CustomUI feature is corrected; fixed some issues and so on...

[-] Tooltips of VFP controls (when CBM.ShowFormTips=.T.) may flicker, in case of the form contains ActiveX control(s).


CommandBar/MenuBar/Popup/Ribbon classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] InitControl method generates an error, in case the second parameter (that specifies control Index) is passed.


CommandBar/MenuBar/Popup/Ribbon controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Empty string stored to the ShortcutText property at run-time generates "API call caused an exception" error.


Ribbon class
~~~~~~~~~~~~
[-] LoadCustomUI method generates errors, if called before the InitCommandBars
    method of the CommandBarsManager object.

[+] LoadCustomUI method supports "labelControl" entry.

    Example:

    <labelControl id="label1" label="label caption" />

[*] CustomUI. Specify both (not empty) "supertip" and "description" attributes to create
    button with ButtonStyle=5 (Image, Caption and Description).

	Note: "description" attribute has a higher priority, so its value will
    be used for the Description property of a control.

    Example:

    <button id="button1" label="Button with Image, Caption and Description" supertip="any text" description="Button description" />


Ribbon.QuickAccessToolbar controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[*] Visible property. Specifies whether the control is visible, or not. Default is True.

    Note: Assigining .F. to the Visible property also sets the _ACB_CHF_HIDEGENERIC flag to the HideFlags property. So, the control becomes invisible and removed from the "Customize Quick Access Toolbar" menu.

[*] HideFlags property. Specifies the visibility of the control. Default is 0 (no flags set, the control is visible).
    For additional information see _ACB_CHF_* constants defined in the ARGCommandBars.h file.


RibbonTab class
~~~~~~~~~~~~~~~

[-] Enabled property. Specifies whether the tab is enabled, or not. Default is True.

    Note/Tip: in case you are going to disable the current/active tab: change active tab to other (enabled) tab, because controls of active (but disabled) tab remain enabled and available.
    In case all tabs are disabled, set ActiveTab property of the Ribbon to 0 (Zero).


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.1.000 - 2010-08-26
---------------------------------------------------------------------------

General
~~~~~~~

[+] Themed Label (_label class) added to the Extensions library (ARGCommandBarsExt).

[+] Themed Button (_button class) added to the Extensions library (ARGCommandBarsExt).

[+] Gradient image (_gradientImage class) added to the Extensions library (ARGCommandBarsExt).


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] ShowPopupTooltips property. Specifies whether to show ToolTips for controls in popup menus. Default is .T.


Popup controls
~~~~~~~~~~~~~~

[+] ShowPopupTooltip property. Specifies whether to show ToolTip for the control in a popup menu. Default is .T.


Ribbon class
~~~~~~~~~~~~

[*] DisableCustomize property. Specifies whether the ribbon customization is disabled, or not. Default is .T.

    When set to .F., "Customize Quick Access Toolbar" and "More commands..." items appear in the ribbon context menu.

[+] OnCustomize event. Fires (if DisableCustomize set to .F.) when "Customize Quick Access Toolbar" or
    "More commands..." item of the ribbon context menu is selected.

    You can use this event to create your own Qat/Ribbon customization form.

[*] Fixed some internal CustomUI issues.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.014 - 2010-06-24
---------------------------------------------------------------------------

General
~~~~~~~

[+] Support (partial; full support will be added later) of High-DPI and Large-Fonts awareness.

[+] Images for built-in Office icons (see OfficeImageId property): 20x20, 24x24, 40x40, 48x48.
    So, built-in Office icons appear correctly when High-DPI or Large-Fonts used.

[!][*] ARGRibbonResource.dll file updated.

[*] Some colors of Office 2010 color schemes are changed/corrected.


CommandBar/MenuBar/Popup/Ribbon Controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[*] SetPicture method. Extended tnImageSize parameter.

    Syntax:     SetPicture( tcImageFile [, tnImageSize])

    Parameters:
                tcImageFile - image file to load;

                tnImageSize - image size, optional. Possible values:
                              
                              16 - load 16x16 pixels image, default;
                              20 - load 20x20 pixels image (new);
                              24 - load 24x24 pixels image (new);
                              32 - load 32x32 pixels image;
                              40 - load 40x40 pixels image (new);
                              48 - load 48x48 pixels image (new).


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.013 - 2010-05-29
---------------------------------------------------------------------------

General
~~~~~~~

[!][-] Incorrect controls/commandbars/ribbon size, if DPI setting is changed to non-standard value (96 DPI).

[!][*] ARGRibbonResource.dll file updated.

[*] Colors of Office 2010 color schemes are changed/corrected.


DialogBar class
~~~~~~~~~~~~~~~

[!][-] Child VFP forms ignore (do not respond to) mouse clicks, if main form maximized/restored, DialogBar is docked/undocked, or floating DialogBar is moved.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.012 - 2010-05-18
---------------------------------------------------------------------------

General
~~~~~~~

[!][-] VFP menus don't work, when command bars added to the main screen.


RibbonTab class
~~~~~~~~~~~~~~~

[-] Caption of contextual tabs/headers displayed in wrong position.


Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[-] Visible property. Office button visibility doesn't change at run-time.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.011 - 2010-05-17
---------------------------------------------------------------------------

General
~~~~~~~

[!][*] ARGRibbonResource.dll file updated.

[*] Some colors of Office 2010 color schemes are changed/corrected.


CommandBar/MenuBar/Popup/Ribbon Controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[!][*] OnClick property is obsolete and will be removed in future version. Use OnAction property instead.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.010 - 2010-05-14
---------------------------------------------------------------------------

General
~~~~~~~

[!][*] ARGRibbonResource.dll file updated.



Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[-] ToolTip property. Tooltip doesn't change at run-time.

[-] Description property. Description doesn't change at run-time.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.009 - 2010-04-02
---------------------------------------------------------------------------

Ribbon class
~~~~~~~~~~~~
[+] LoadCustomUI method supports "getContent" attribute of the "dynamicMenu" element.

    Example:

    <dynamicMenu id="mnuDynamic1" getContent="ThisForm.GetDynamicContent" visible="true" />


    Note: the current implementation of the getContent callback function
          receives two parameters: toControl, taItems.

          toControl - reference to the CommandBarMenuItem object,
          taItems - reference to the array that will contain menu items.

          For example see the GetDynamicContent method of the frmRibbon form.


[+] LoadCustomUI method supports "menuSeparator" element.

    Example:

    <menuSeparator id="menuSeparator1" title="Menu Separator" />




Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.008 - 2010-02-21
---------------------------------------------------------------------------

General
~~~~~~~

[-] The library does not use Closable property of the form anymore.
    The Close button highlighting do not work when value of this
    property changed to .F., and then back to .T.

    VFP issue. Applies only to Windows Vista and Seven.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[+] UseCyrillicIcons property. Specifies whether the library uses localized
    (cyrillic) icons to display predefined images (see OfficeImageId property)
    such as "Bold", "Italic", "SortAscending" and so on. Default is False.
    
    Makes sense and applies only to cyrillic locales (Russian etc.).


Ribbon class
~~~~~~~~~~~~
[+] PopupOldStyleBehavior property. Specifies the ribbon popups behavior.
    If set to True, popups of popup controls are closing when the mouse
    pointer moved to other ribbon controls. Default is False.


Ribbon controls
~~~~~~~~~~~~~~~

[-] SetFocus method doesn't set the keyboard focus to the control.


Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[+] CloseFormOnDblClick property. Specifies whether the form will close
    when the user double clicks the Office Button. Default is True.

    Applies to Top-level forms with Office Button style of Office 2007.


[-] SkipFor property of child items does not work as expected.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.007 - 2009-12-30
---------------------------------------------------------------------------

General
~~~~~~~

[-] StatusBar do not display icons assigned to panels, if icons are set
    before InitCommandBars.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.006 - 2009-12-30
---------------------------------------------------------------------------

General
~~~~~~~

[-] StatusBar panels from Common Controls Library are displayed with borders
    even the BorderStyle is set to 0 (no borders).


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.005 - 2009-12-29
---------------------------------------------------------------------------

General
~~~~~~~

[!][-] Recreating (call to Recreate method) StatusBar control from Common
    Controls Library after InitCommandBars method causes the library to stop
    working as expected. Also, it may cause GPF or VFP "Internal consistency error".

[!][+] Extended behavior of StatusBar panels (from Common Controls Library).
    Panels behave as buttons if panel's property PanelStyle is set to 1 (Button).

    Tip:  Use Click event of the StatusBar control to handle panel/button click event.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.004 - 2009-12-21
---------------------------------------------------------------------------


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[*] SetStatusBarDivider method.

    Sets the position (pane index) of the status bar divider.

    Syntax:     SetStatusBarDivider( tnIndex)

    Parameters:
                tnIndex - the index of pane from which the status bar
                          should be visually divided:
                          "light" part - panels 1 thru tnIndex-1
                          "dark" part - panels tnIndex thru PanelsCount.


Ribbon class
~~~~~~~~~~~~

[!][-] Tooltips of the Ribbon controls cover Quick Access Toolbar (QAT) items
    when QAT is located below Ribbon.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.003 - 2009-12-20
---------------------------------------------------------------------------

Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[+] ShowImageInToolTip property. Specifies whether the image appears in
    the tool tip. Default is True.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.002 - 2009-12-20
---------------------------------------------------------------------------

Some internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.001 - 2009-12-19
---------------------------------------------------------------------------

General
~~~~~~~

[!][*] StatusBar control (from Common Controls Library) doesn't show images
    assigned to StatusBar panels.


CommandBar/Menu/Popup/Ribbon controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[!][*] LargeIcon property is deprecated, it will no longer be supported in
    a future release and should no longer be used. Use ControlSize property
    instead.

[+] ControlSize property. Specifies the icon (and control) size.
    
    Values:  0 - Auto (default);
             1 - Normal (small);
             2 - Large.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 8.0.000 - 2009-12-13
---------------------------------------------------------------------------

General
~~~~~~~

[!][+] Office 2010 style for the Office menu/button.

[!][*] Color schemes changed. Added new Office 2010 color schemes (Blue and Black).
    "White" color scheme changed to Office 2010 "Silver"

[!][+] Some common Office icons (such as FileNew, FileOpen etc.) are stored
    in the library so there is no need to use external BMP and/or PNG files.
    All you need to do is just set the OfficeImageId property of the control.

[!][+] Ribbon customization and extensibility supported (partially).
    For more information look for the "Ribbon Extensibility", "CustomUI"...
    on MS/MSDN web site.

[!][-] Fixed all (at least known) potential problems with "buffer overruns".

[!][*] Updated ARGRibbonResource.dll file.

[!][-] Office menu/button on the Ribbon doesn't have an access key, so there
    is no way to activate it by using keyboard.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] AllowDuplicatedShortcutKeys property. Specifies whether the same shortcut
    key can be assigned to different controls. Default is .F.

[!][+] EnableOfficeFrame property. This is the replacement for the deprecated
    EnableOffice2007Frame property.

[!][*] EnableOffice2007Frame property is deprecated, it will no longer be
    supported in a future release and should no longer be used. Assignments
    to this property will generate an error message.
    Use EnableOfficeFrame property instead.

[+] DisableFrame property. Allows to disable the window containing CBM object,
    instead of disabling all child windows (scroll bars etc.) when you set
    CBM's Enabled property to .F.. Default value is .F.
    Useful when you run child modal forms that are Desktop or Top-Level forms.

    Example:
                ThisForm.CBM.DisableFrame = .T.
                ThisForm.CBM.Enabled = .F.

                && ... run modal form here
                && ThisForm.CBM.ShowModalForm( someForm)
                && or
                && Do Form someModalForm

                ThisForm.CBM.Enabled = .T.

    Urgent Note: the ShowModalForm method is the most preferred way to show
          modal forms (the following isn't required) but, if you use DO FORM,
          it is a good idea to enable CBM object of the main form before
          child modal form closes/releases.
          For example, assume the "mainForm" variable references the calling
          main form:


                && Destroy event (or Release method) of a modal form/class
                
                mainForm.CBM.Enabled = .T.
                DoDefault()

[*] ColorScheme property. Returns the current color scheme. Applicable to
    Office 2007 (6) and Ribbon (7) visual themes.

    Values:  0 - Office 2007 Blue     (default);
             1 - Office 2007 Black;
             2 - Office 2007 Aqua;
             3 - Office 2007 Silver;
             4 - Office 2010 Blue;
             5 - Office 2010 Silver;
             6 - Office 2010 Black;
             7 - Windows 7 Scenic.


[*] SetColorScheme method. Sets the current visual theme and built-in color scheme.

    Syntax:     SetColorScheme( tnVisualTheme, tnColorScheme)

    Parameters:
                tnVisualTheme - specifies the base visual theme:

                          6 - Office 2007;
                          7 - Ribbon.

                tnColorScheme - specifies the color scheme:

                          0 - Office 2007 Blue     (default);
                          1 - Office 2007 Black;
                          2 - Office 2007 Aqua;
                          3 - Office 2007 Silver;
                          4 - Office 2010 Blue;
                          5 - Office 2010 Silver;
                          6 - Office 2010 Black;
                          7 - Windows 7 Scenic.


CommandBar/MenuBar/DialogBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] ShowInToolbarList property. Specifies whether the bar appears in the toolbar list.


CommandBar/Ribbon controls
~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] OfficeImageId property. Specifies the image to display on the control.
    
    For the list of supported images see _imgMso_* constants defined
    in the ARGCommandBars.h file.

    Also, you can assing VFP system menu bar identifiers to the OfficeImageId
    property such as "_mfi_new", "_mfi_save" and so on.

    Example:
                cmdNew.OfficeImageId = "FileNew"

                cmdSave.OfficeImageId = "_mfi_save"

[-] ShortcutText property. Empty string ("") stored to this property doesn't reset control shortcut, so the shortcut assigned earlier to control still works.


Ribbon class
~~~~~~~~~~~~

[+] LoadCustomUI method.

    Loads the custom UI from the specified XML file or the string containing XML data.

	
    Example:
                ThisForm.Ribbon.LoadCustomUI( "CustomUI.xml")


[+] RibbonXml property. Contains the current XML representation of the Ribbon UI.



RibbonGroup class
~~~~~~~~~~~~~~~~~

[*] ControlsCentering property. Default value changed to .T.


Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[+] ButtonStyle property. Specifies Office Button style.

    Values:  0 - Automatic (depends on the selected Color Scheme);
             1 - Office 2007;
             2 - Office 2010.


[+] ButtonColor property. Specifies Office Button color. Applies to Office 2010 style button

    Values:  0 - None (simple button);
             1 - Blue;
             2 - Yellow;
             3 - Green;
             4 - Red;
             5 - Purple;
             6 - Cyan;
             7 - Orange.


[+] Caption property. Default is "\<File". Similar to all other VFP controls,
    you can specify an access key to activate the Office menu by pressing
    the ALT key and the specified key (default is "F").


[+] KeyTip property. Default is "F". 



CommandBarButton class
~~~~~~~~~~~~~~~~~~~~~~

[+] SplitButtonMenuDescription property.

[+] SplitButtonMenuToolTip property.




Other internal fixes, corrections and improvements.


---------------------------------------------------------------------------
Version 7.1.000 - 2009-08-26
---------------------------------------------------------------------------

General
~~~~~~~

[!][-] "API call caused an exception" error if a button (with ButtonType
    property set to 0) on the ribbon group has child items.

[!][-] The Ribbon disappears when the user tries to resize form by draging
    the upper horizontal border of the top-level form on Windows Vista or
    later (Windows 7).

[+] New color schemes: White (Office 2010), Scenic (Windows 7 Ribbon).


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[*] ColorScheme property. Returns the current color scheme. Applicable to
    Office 2007 (6) and Ribbon (7) visual themes.

    Values:  0 - Blue;
             1 - Black;
             2 - Aqua;
             3 - Silver;
             4 - White (Office 2010);
             5 - Scenic (Windows 7 Ribbon).


[*] SetColorScheme method. Sets the current visual theme and built-in color scheme.

    Syntax:     SetColorScheme( tnVisualTheme, tnColorScheme)

    Parameters:
                tnVisualTheme - specifies the base visual theme:

                          6 - Office 2007;
                          7 - Ribbon.

                tnColorScheme - specifies the color scheme:

                          0 - Blue;
                          1 - Black;
                          2 - Aqua;
                          3 - Silver;
                          4 - White (Office 2010);
                          5 - Scenic (Windows 7 Ribbon).

Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.008 - 2009-06-11
---------------------------------------------------------------------------

General
~~~~~~~
[!][-] GPF (General Protection Fault) error when user clicks the form's icon
    (at the left-top corner) or right click the title bar of the form.

    Applies only to VFP version 7 and earlier.

[-][340] Fixed keyboard focus issues when CBM propeties set as follows:
    AttachToScreen = .T.
    AttachToFrame = .F.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.007 - 2009-06-10
---------------------------------------------------------------------------

General
~~~~~~~

[!][-] Double click on the Top-Level form caption (with Ribbon control or
    Office 2007 frame enabled) maximizes the form much larger than actual/available
    display size.

[!][*] Main VFP window with hidden system menu (HideSysMenu = .T.) has
    incorrect Office 2007 frame if command bars are attached to the screen
    (AttachToScreen = .T.).


Ribbon class
~~~~~~~~~~~~

[+] cmdAbout object (CommandBarButton class).
    
    Note: You can hide this button by setting its Visible property to .F.

[+] cmdMinimizeRibbon object (CommandBarButton class).
    Similar to Office 2010 Ribbon, allows to minimize/collapse the Ribbon
    so that only the tab names are showing. The shortcut key is Ctrl+F1.
    
    Note: You can hide this button by setting its Visible property to .F.


CommandBarComboBox class
~~~~~~~~~~~~~~~~~~~~~~~~

[!][*] RowSourceType and RowSource properties are supported now.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.006 - 2009-06-02
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 7.0.005 - 2009-05-19
---------------------------------------------------------------------------

General
~~~~~~~

[!][+] If the ARGRibbonResource.dll file was added to the project file,
    there is no need to call the SetRibbonThemeResourceDLL method. DLL is
    loading automatically when the CommandBarsManager object initializes.


[-][303] DialogBar added to the main VFP screen (CBM.AttachToScreen = .T.)
    always activates the CBM form which it was instantiated.


[!][-][335] Each mouse click on the active form triggers Deactivate and then
    Activate events.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.004 - 2009-05-13
---------------------------------------------------------------------------

General
~~~~~~~

[-] Fixed some Office 2007 and Ribbon frame issues such as caption buttons
    size, position etc.

[-] Inactive child (non top-level) form with Office 2007 frame enabled
    doesn't activate when the user clicks the caption of the form.

[+] You can add the ARGRibbonResource.dll file to your project (Other Files).
    So, there is no need to ship it as an additional file for your compiled
    application.


Ribbon class
~~~~~~~~~~~~

[+] TabToolTipBehaviour property. Specifies the tool tip behaviour for tabs.

    Values:  0 - don't show tool tips for tabs;
             1 - show tool tips for tabs always;
             2 - show tool tip only if tab was shrunk. Default.


[+] ShowTabImages property. Specifies whether the tab images are displayed.
    Default is False.


RibbonTab class
~~~~~~~~~~~~~~~

[+] ToolTip property. Specifies the text that appears as a ToolTip for the tab.

[+] Description property. Specifies the text that is displayed in the status
    bar when the mouse pointer moves over the tab.

[+] Image object. Specifies an image to display on the tab.


CommandBarComboBox class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] DisplayCount property. Gets or sets the maximum number of items to be
    shown in the drop-down portion of the CommandBarComboBox control.
    The minimum for this property is 1 and the maximum is 100. Default is 12.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.003 - 2009-05-05
---------------------------------------------------------------------------

General
~~~~~~~

[-] Tooltips of the StatusBar control from Common Controls library do not
    appear.

[+] Tooltips of the StatusBar control from Common Controls library have the
    same appearance as tooltips of other library controls (buttons etc.)
    
    See also: CommandBarsManager.ToolTipOptions object.


Ribbon class
~~~~~~~~~~~~

[+] AllowQuickAccessToolbarPostionChange property. Specifies whether the
    position of the Quick Access Toolbar can be changed (show above/below
    the Ribbon). Default is True.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] EnableAnimation property. Specifies whether the animation is enabled.
    Default is False.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.002 - 2009-04-29
---------------------------------------------------------------------------

Ribbon class
~~~~~~~~~~~~

[+] ShowCustomizeQuickAccessToolbarButton property. Specifies whether the
    "Customize Quick Access Toolbar" button is visible, or not.
    Default is True.


Ribbon.OfficeMenu object
~~~~~~~~~~~~~~~~~~~~~~~~

[+] Image object. Specifies 32x32 pixels image that appears on the Office
    Menu button.

[+] ToolTipImage object. Specifies the image that appears on the Office
    Menu tool tip.

    Note:

      Image size should be larger than 32x32 pixels. 32x32 pixels image
    replaces the image of the Office Menu button.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.001 - 2009-04-13
---------------------------------------------------------------------------

General
~~~~~~~

[+] "__ACB_NOREFRESH__" variable. If defined and set to true, the library
    suspends command bars refreshing, doesn't evaluate SkipFor and MarkFor
    properties etc. May be useful while debugging.


Ribbon class
~~~~~~~~~~~~

[!][*] The Width property of the OfficeMenu.RecentFileList object specifies
    the width (in pixels) of recent file list of the Office menu.
    Default is 300.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] The RestoreStateFromXml method restores/adds controls added by the user
    at run-time to the Quick Access toolbar.

[+] The SaveStateToXmlFile method saves controls added by the user at
    run-time to the Quick Access toolbar.


CommandBar controls
~~~~~~~~~~~~~~~~~~~

[-] MarkFor and SkipFor properties do not work as expected if they set after
    the InitCommandBars method is called.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 7.0.000 - 2009-03-19
---------------------------------------------------------------------------

General
~~~~~~~
[!][+] Ribbon class.

[+] New _ACB_LSID_* constants defined in the ARGCommandBars.h file that
    allow to localize Ribbon specific popups ( "Customize Quick Access
    Toolbar", for example).


[-] Keyboard shortcuts containing spaces (for example: "Ctrl+Page Up")
    do not work.

...

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] DisableShortcuts property. If set to .T., the keyboard shortcuts are
    disabled. Default is .F.

[+] DisableKeyboardMenuActivation property. If set to .T., menu doesn't
    activate when the user presses ALT or F10 key. Default is .F.

[+] GetPopupSize method. Returns the size/dimension (width or height)
    of the specified popup menu.

    Syntax:     GetPopupSize( toPopup, tnSizeID)

    Parameters:
                toPopup - popup;


                tnSizeID - specifies which size/dimension is returned:

                          0 - width;
                          1 - height.


[*] RestoreStateFromXml method receives additional parameter tlRestoreVisualTheme.
    Optional, default is False.

    Syntax:     ThisForm.CBM.RestoreStateFromXml( tcFileName [, tlRestoreVisualTheme])


CommandBarButton, CommandBarMenuPad and CommandBarMenuItem classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] OnInitPopup event. Occurs just before the child popup is displayed.
    Allows to modify, hide/show etc. popup items.


CommandBarComboBox class
~~~~~~~~~~~~~~~~~~~~~~~~

[-][298] List property returns boolean .T. instead of a string.

[-][299] DisplayValue property doesn't contain actual display value.


Popup class
~~~~~~~~~~~

[+] OnInitPopup event. Occurs just before the popup is displayed.
    Allows to modify, hide/show etc. popup items.


---------------------------------------------------------------------------
Version 6 - 2008-12-04
---------------------------------------------------------------------------

General
~~~~~~~
[!!!] Intermediate version between versions 5 and 7. Includes the latest
    fixes and corrections.
    It will not contain any update till version 7 launched.
    

    Version 7 announces:
       
      Office Fluent UI, including the Ribbon control etc...


[!][-] Controls from Common Controls library added at run-time after the
    InitCommandBars method may cause forms to not release properly and
    generate errors (GPF, in common) when VFP or compiled EXE application
    closes.

    Note:

      If you add and use controls from Common Controls library after the
    InitCommandBars method, it is a good idea to dispose those controls
    (call their Dispose method) in form's Destroy event, or Destroy event
    of containers/controls that use controls from Common Controls library.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] ShowKeyboardCues property. Gets or sets a value indicating how keyboard
    cues (hot key underlines) appear. 

    Values:  0 - Show keyboard cues always, default;
             1 - Never show keyboard cues;
             2 - System defined.


---------------------------------------------------------------------------
Version 5.2.005 - 2008-11-28
---------------------------------------------------------------------------

General
~~~~~~~

[-] Each interaction (scrolling, thumb dragging, etc.) with the ScrollBar
    control from Common Controls library causes the command bars colors
    refresh (OnSystemColorChanged and OnVisualThemeChanged events of the
    CommandBarsManager object fire).

---------------------------------------------------------------------------
Version 5.2.004 - 2008-11-27
---------------------------------------------------------------------------

General
~~~~~~~

[-][284] The library causes the ScrollBar control from Common Controls
    library to stop working when command bars and scroll bars are placed
    on non top-level form, or (in case of top-level form) when AttachToFrame
    property of CommandBarsManager object is set to .F.


CommandBar controls
~~~~~~~~~~~~~~~~~~~

[!][*] Fixed potential fatal problem (memory leaks and, as result,
    "Not enough memory to complete the operation" errors) that may happen
    if expression of MarkFor or SkipFor property evaluates to object
    reference instead of a boolean value.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 5.2.003 - 2008-11-26
---------------------------------------------------------------------------

General
~~~~~~~
[!][-] Reworked (in version 5.2.002) internal image manager messes icons,
    causes GDI resources leaks and other potential problems.

[!][-] The frame of the form with enabled "Office 2007 Frame" changes to
    standard (classic) window frame when another application activates.

[-] Keyboard shortcuts containing a string that is not capitalized as
    appropriate for proper names (i.e.: "Ctrl+C") are not recognized as valid.
    For example, these shortcuts do not work: "CTRL+C", "ctrl+c" or "Ctrl+c"

---------------------------------------------------------------------------
Version 5.2.002 - 2008-11-23
---------------------------------------------------------------------------

General
~~~~~~~
[*] Office 2007 frame is available in all visual themes.

[+] Right To Left (RTL) language support added.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] RightToLeftLayout property. Gets or sets a value indicating whether
    right-to-left (RTL) mirror placement is turned on. Default is .F.


CommandBarsManager.ToolTipOptions object
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] ShowImage property. Specifies whether the ToolTip contains the image
    of the control. Default is .F.


CommandBar controls
~~~~~~~~~~~~~~~~~~~

[+] KeyTip property. A string that represents the keyboard shortcut of the
    control.


[+] ShowImageInToolTip property. Specifies whether the image of the control
    appears in the tool tip. Makes sence only if the ShowImage property of
    CommandBarsManager.ToolTipOptions object is set to .T.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 5.2.001 - 2008-11-14
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 5.2.000 - 2008-11-10
---------------------------------------------------------------------------

General
~~~~~~~
[!][+] Office 2007 frame.

[!][+] ToolTips for native VFP controls.
       This feature also fixes VFP bug: tool tips of grid headers do not appear.

[!][+] Keyboard shortcuts allow double key combinations (for example,
       "Ctrl+K, Ctrl+V").

[!][-] Alt+Space key combination does not work, the System menu of the form
       doesn't appear.

[!][*] ARGRibbonResource.dll file is updated. Make sure you use the latest
       release.

[!][*] Object model has been changed:

       - _controlButton class renamed to CommandBarButton;

       - _controlCheckBox class renamed to CommandBarCheckBox;

       - _controlComboBox class renamed to CommandBarComboBox;

       - _controlCustom class renamed to CommandBarCustomControl;

       - _controlOptionButton class renamed to CommandBarOptionButton;

       - _controlLabel class renamed to CommandBarLabel;

       - _controlTextBox class renamed to CommandBarTextBox;

       - _menuItem class renamed to CommandBarMenuItem;

       - _menuBarItem class renamed to CommandBarMenuPad.

    Use conversion utility (Utils\ConvertTo52.fxp) to convert existing forms
    and libraries that use the Command Bars Library.

    Note: Make sure you have created backup copies of your libraries and forms
    before using conversion utility.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] EnableOffice2007Frame property. Specifies whether the form has Office 2007
    frame enabled, or not. Default is .F.

[+] ShowFormTips property. Replace standard tool tips for native VFP controls
    with tool tips specified in the ToolTipOptions object.

[*] GetFont method. Returns the Label object with the FontName, FontSize,
    FontBold and FontItalic properties set according to the requested font.
    See _ACB_FONT_* constants in the ARGCommandBars.h file.


DialogBar class
~~~~~~~~~~~~~~~

[+] ShowBorders property. Specifies whether the DialogBar has borders, or not.

[+] HalfHeightCaption property. Specifies whether the caption of the DialogBar
    is half the normal height.


CommandBarComboBox and CommandBarTextBox classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] TextAlignment property. Specifies the horizontal alignment of the contents
    of the text box.

    For CommandBarComboBox class, makes sense only when the DropDownStyle
    property is set to 0 - Drop-down combo box, which includes a list box and
    an edit box. (Default).

[*] DisplayCaption property is obsolete. Use the ButtonStyle property instead.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 5.1.002 - 2008-09-20
---------------------------------------------------------------------------

General
~~~~~~~
[-] Windows Vista. Non-client areas (caption, borders) of Top-level forms
    are rendered opaque, do not have the transparent glass effect.


[-][274] Command bars with the DockingFlags property set to 0 cannot be
    docked to the right of other command bar.


Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 5.1.001 - 2008-08-18
---------------------------------------------------------------------------

General
~~~~~~~

[-] Objects (instances of user-defined classes of EXTARNAL libraries/programs
    with Hidden or Protected common properties such as CLASS, BASECLASS etc.)
    added to the main screen (_SCREEN object) cause error: "Property ... is
    not found".


---------------------------------------------------------------------------
Version 5.1.000 - 2008-06-15
---------------------------------------------------------------------------

General
~~~~~~~

[-] Alt+F10 key combination does not work.


DialogBar class
~~~~~~~~~~~~~~~

[-][254] Delete method causes API exception.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[-][250] Controls hidden by the user (unchecked in 'Add/Remove Buttons' popup)
    become unavailable (do not appear in the 'Add/Remove Buttons' popup)
    after the current state saved and then restored.

[-][253] ColorScheme gets reset to 0 when new form with command bars is
    opening.

[-][254] RemoveCommandBar method causes API exception in case of removing
    a dialog bar.



Button and MenuItem classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] GetTearOffBarProperties method. Allows to determine whether the child
    "tear-off" popup is torn off programmatically or by the user.

    Syntax:     GetTearOffBarProperties()

    Returns:    Reference to custom "tear-off" bar object, or .NULL. in case
                of the button/menu item doesn't have "tear-off" popup, or
                "tear-off" popup is not torn off.


    "tear-off" bar object properties:  DockPosition, Left, Top.


MenuItem class
~~~~~~~~~~~~~~

[*] Custom lists. The code stored to 3-rd column (for Click event) of custom
    list executes in context of MenuItem. So, "This" and "ThisForm" keywords
    may be used in the code.



Other internal fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 5.0.001 - 2008-04-15
---------------------------------------------------------------------------

General
~~~~~~~

[-] WindowState property of minimized Top-level form changes to 2 (Maximized)
    when a change is made to a system color setting.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[-] GetColor method returns wrong (cached) color value when a change is made
    to the system color setting.


Minor changes and corrections

---------------------------------------------------------------------------
Version 5.0.000 - 2008-04-11
---------------------------------------------------------------------------

General
~~~~~~~
[+] Office 2007 Ribbon visual theme.

[+] Four built-in Office 2007 color schemes: Blue, Black, Aqua and Silver.

[+] Office 2007 style tool tips.

[+] Tool tips customization.

[+] Keyboard tips.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[-][243] Access keys of VFP controls do not work.

[+] AccessKeyPreview property. Specifies whether menu/command bar access
    key intercepts the access key of a control. Default is .T.


[+] ColorScheme property. Returns the current color scheme. Applicable to
    Office 2007 (6) and Ribbon (7) visual themes.

    Values:  0 - Blue;
             1 - Black;
             2 - Aqua;
             3 - Silver.

[+] SetColorScheme method. Sets the current visual theme and built-in color scheme.

    Syntax:     SetColorScheme( tnVisualTheme, tnColorScheme)

    Parameters:
                tnVisualTheme - specifies the base visual theme:

                          6 - Office 2007;
                          7 - Ribbon.

                tnColorScheme - specifies the color scheme:

                          0 - Blue;
                          1 - Black;
                          2 - Aqua;
                          3 - Silver.

[+] SetRibbonThemeResourceDLL method. Sets the resource (DLL) file that will
    be used as the resource DLL by the Ribbon visual theme.

    The Ribbon resource "ARGRibbonResource.DLL" is shipped with the library
    and can be found in the "Redistr" folder.

    Note: The Ribbon visual theme will not be available until you set the
          resource file.


    Syntax:     SetRibbonThemeResourceDLL( tcResourceDLL)

    Parameters:
                tcResourceDLL - specifies the resource file name.


[+] ShowKeyboardTips property. Specifies whether the keyboard tips appear
    when the user clicks the ALT key.

[+] ToolTipOptions object. Contains the options for the tool tips.


CommandBarsManager.ToolTipOptions object
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[+] Style property. Specifies the style of the ToolTip.

    Values:  0 - Standard style, default;
             1 - Balloon style;
             2 - Office style;
             3 - Luna style;
             4 - Office 2007 style.

[+] ShowTitleAndDescription property. Specifies whether the ToolTip contains
    the title and description of a control. Default is .F., ToolTip contains
    the title only.

[+] StripAmpersands property. When set to true, any ampersands (&) in the
    ToolTip are not displayed.

[+] AutomaticDelay property. Sets the values of AutoPopDelay, InitialDelay,
    and ReshowDelay to the appropriate values.

[+] AutoPopDelay property. Determines the length of time the ToolTip remains
    visible if the pointer is stationary inside a ToolTip region.

[+] InitialDelay property. Determines the length of time the pointer must
    remain stationary within a ToolTip region before the ToolTip appears.

[+] ReshowDelay property. Determines the length of time it takes for subsequent
    ToolTips to appear as the pointer moves from one ToolTip region to another.

[+] MaxWidth property. Specifies the maximum width of the ToolTip.


TextBox and ComboBox controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Tool tip doesn't appear when the mouse pointer is over the control.


Button and MenuItem classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] IsParent property. Gets a value indicating whether the button/menu item
    contains child menu items.

[+] PerformClick method. Simulating a click by a user and executing the code
    stored in the OnAction/OnClick property.


[*] CreateControl method. Creates a new control within the child popup menu
    with the specified control type and name.

    Syntax:     CreateControl( [ tnControlType [, tcObjectName]])

    Parameters:
                tnControlType - control type:

                          0 - Button, default;
                          1 - ComboBox;
                          2 - TextBox;
                          3 - Custom;
                          4 - Label;
                          5 - CheckBox;
                          6 - OptionButton.

                tcObjectName - control name.

    Returns:
                Reference to created control.


[+] TearOffAndDock method. Allows to "tear-off" and dock the child popup
    programmatically.

    Syntax:     TearOffAndDock( tnDockPosition [, tnX, tnY])

    Parameters:
                tnDockPosition - specifies the docking position:

                          -1 - not docked (floating);
                          0 - top;
                          1 - left;
                          2 - right;
                          3 - bottom.

                tnX, tnY - specifies the horizontal and vertical coordinates.



Other fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 4.4.002 - 2008-02-20
---------------------------------------------------------------------------

Minor changes and corrections


---------------------------------------------------------------------------
Version 4.4.001 - 2008-02-14
---------------------------------------------------------------------------

General
~~~~~~~

[+] Icon files with "ICON" extension support.


CommandBar/MenuBar Controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] OnAction property. Gets or sets the name of a procedure/function that
    will run when the user clicks or changes the value of a control.


[+] Parameter property. Stores any extra data that can be used to hold
    information about the control (similar to a second Tag property value).


Minor changes and corrections

---------------------------------------------------------------------------
Version 4.4.000 - 2008-02-10
---------------------------------------------------------------------------

General
~~~~~~~

[-] The library does not load True Color (32 bpp) images from ICO files.

[+] Alpha images support.

[*] Improved images handling and drawing.

[+] _controlLabel class.

[+] _controlCheckBox class.

[+] _controlOptionButton class.


MenuItem class
~~~~~~~~~~~~~~~

[*] OnBuildCustomList method. New custom item flags (options):
        
        8	- the item is hidden;
        16	- Most Recently Used (MRU) item. The item is initially hidden
              and appears only when the popup is expanded.
              The popup displays vertical chevrons indicating a MRU type menu.

[+] New menu item style (value of the ButtonStyle property):

        5 - Icon, Caption and Description. Menu item has the picture (if
            specified). The Description appears below the Caption.


CommandBar class
~~~~~~~~~~~~~~~~

[+] SmartLayout property. Specifies whether a "smart" layout for the command
    bar is enabled. Smart layout allows each item to have multiple image sizes.
    The largest images will be displayed when enough room is available and
    automatically display the smaller icons when space is tight. Not only are
    images swapped when the form is resized, but the items will be re-arranged
    so that they are always visible in the toolbar. When toolbar space is
    abundant, large images with item captions are displayed, if space is
    limited, then only small icons with no captions are displayed.


CommandBar and Popup classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] LargeIcons property. Specifies whether the buttons (popup items) have
    large pictures (32x32 pixels).


Button class
~~~~~~~~~~~~

[+] LargeIcon property. Specifies whether the button has large picture
    (32x32 pixels).

[+] New button style (value of the ButtonStyle property):

        4 - Icon and Caption below. The picture appears above the caption.
            The picture is centered above the caption.


Button and MenuItem classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] Popup_LargeIcons property. Specifies whether the child popup items have
    large pictures (32x32 pixels).


[*] SetPicture method receives additional optional parameter specifying
    the size of image to load.

    Syntax:     SetPicture( tcImageFile [, tnImageSize])

    Parameters:
                tcImageFile - image file to load;

                tnImageSize - image size, optional. Possible values:
                              
                              16 - load small image (16x16 pixels), default;
                              32 - load large image (32x32 pixels).


---------------------------------------------------------------------------
Version 4.3.009 - 2008-01-21
---------------------------------------------------------------------------


General
~~~~~~~
[-][234] All redefined colors of Custom theme gets reset to their original
    values (colors of the 'Office 2007 (Blue)' visual theme) when a new
    form containing CommandBarsManager object launches.


TextBox and ComboBox controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-][234] The font of TextBox and ComboBox controls changes to the "System"
    font when visual theme changes.


---------------------------------------------------------------------------
Version 4.3.008 - 2008-01-09
---------------------------------------------------------------------------

General
~~~~~~~
[-] Commands to cascade or arrange windows:
    SYS(1500,'_MWI_CASCADE','_MWINDOW') or SYS(1500,'_MWI_ARRAN','_MWINDOW')
    display "additional" empty form.
    The form appears only within the parent form that uses dialog bar(s).


---------------------------------------------------------------------------
Version 4.3.007 - 2008-01-06
---------------------------------------------------------------------------

General
~~~~~~~

[+] PNG images support.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[-] User can activate menu bar by pressing ALT or F10 key even if the CBM
    object is disabled (Enabled=.F.).

[+] HideSysMenu property. Specifies whether the Visual FoxPro system menu
    bar is visible.


CommandBar and MenuBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Dock method docks a command/menu bar to wrong position, adds new row in
    the docking area and shifts other bars down or right (depending on the
    DockPosition).


Minor changes and corrections

---------------------------------------------------------------------------
Version 4.3.006 - 2007-12-29
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[-] Large buttons have small icons (16x16 pixels) when the LargeButtons
    property is set to .T.

[+] KeepAlive property. Specifies whether the library files should be
    released and unloaded when the last form that uses the library is closing.
    When it is set to .T. the library keeps images and other resources open,
    this allows new forms that use the library to initialize and start faster.

Minor changes and corrections

---------------------------------------------------------------------------
Version 4.3.005 - 2007-12-28
---------------------------------------------------------------------------

General
~~~~~~~
[-] [230] Keyboard shortcuts of menu/command bars attached to the main VFP
    screen cease working after a child form is open until menu/command bar
    is cliecked/activated.


MenuItem class
~~~~~~~~~~~~~~

[+] Default property. Specifies whether the menu item is the default item.



Other fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 4.3.004 - 2007-11-27
---------------------------------------------------------------------------

General
~~~~~~~
[-] Keyboard shortcuts defined for menu items do not work when a child form
    is active.


Minor changes and corrections

---------------------------------------------------------------------------
Version 4.3.003 - 2007-11-16
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] GetFont method. Returns information about the font.

    Syntax:     GetFont( tnFontIndex)

    Parameters:
                tnFontIndex - the font index.

    For more information, see _ACB_FONT_* constants in the ARGCommandBars.h
    file.



Minor changes and corrections

---------------------------------------------------------------------------
Version 4.3.002 - 2007-11-02
---------------------------------------------------------------------------

CommandBar, MenuBar and DialogBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] FreezePainting property. Locks/unlocks repainting of the bar.
    .T. if repainting of the bar is locked; otherwise, .F. Default is .F.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[*] FreezePainting property. Locks/unlocks repainting of the form and bars
    on the form.
    .T. if repainting of the form is locked; otherwise, .F. Default is .F.


CommandBar/MenuBar Controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] ActivatePopup method. Activates a popup menu associated with the control.

    Syntax:     control.ActivatePopup( [ tnItemIndex])

    Parameters:
                tnItemIndex - Optional. Specifies the item in the menu that
                              is selected when the popup is activated.

    Example:
                ThisForm.MainMenu.mnuEdit.ActivatePopup( 1)

         Activates the Edit popup of the main menu and selects first item.


MenuItem class
~~~~~~~~~~~~~~

[+] OnBuildCustomListDelegate property. Specifies the method that will
    handle the OnBuildCustomList event/method.
    Default value is "This.OnBuildCustomList".
    The delegate method receives two parameters: reference to the menu item
    and reference to the array that contains the results of delegate method.
    For more information, see OnBuildCustomList method.


Other fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 4.3.001 - 2007-10-10
---------------------------------------------------------------------------

General
~~~~~~~
[-] Form hosting the active (focused) ActiveX control flashes when another
    form or main VFP window activates.


[-] Form hosting the active (focused) ActiveX control remains active when
    menu, command bar or dock bar on another form is clicked. Another form
    flashes shortly but doesn't activate.


---------------------------------------------------------------------------
Version 4.3.000 - 2007-10-02
---------------------------------------------------------------------------

General
~~~~~~~

[-] Disabled command/menu bars (CBM.Enabled=.F.) attached to the main
    Top-Level form become available (enabled) after MESSAGEBOX(), GETFILE()
    etc. functions called from a child modal form.


[*] Controls do not update if there is Debug or Trace window open.
    All controls now update once per second, this allows to see changes in
    command bars and controls while debugging.


MenuBar class
~~~~~~~~~~~~~

[+] Support of MDI child forms.

[+] HideMDIButtons property. Specifies whether the MDI buttons (Minimize,
    Restore, Close and MDI system popup) appear on the menu bar if a child
    MDI form is active and maximized. Default value is False (.F.).

[+] HideWrappedControls property. Specifies whether wrapped controls should
    be hidden. Default is .F.


CommandBar class
~~~~~~~~~~~~~~~~

[+] HideWrappedControls property. Specifies whether wrapped controls should
    be hidden. Default is .T.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[-] AutoDisable property affects the value returned from a modal form. When
    the AutoDisable property set to .T. the value returned to the parent
    form is always logical .F.


[-] GetColor method returns wrong value for the _ACB_COLOR_MenuBarText (211)
    color index in Office 2000, Office XP and Windows XP visual themes.


MenuItem class
~~~~~~~~~~~~~~

[-] Menu item representing a custom list (SpecialControl=3) with BeginGroup
    property set to .T. doesn't have a separator when the list contains
    only one item.


[-] SkipFor expression not evaluated and the keyboard shortcut assigned to
    the item doesn't work until the parent popup is displayed.


DialogBar class
~~~~~~~~~~~~~~~

[-] The shape of the mouse pointer doesn't change to the "Size" (four-pointed
    arrow pointing up, down, left, and right) when the mouse pointer passes
    over the DialogBar gripper.


---------------------------------------------------------------------------
Version 4.2.003 - 2007-09-03
---------------------------------------------------------------------------

Minor changes and corrections


---------------------------------------------------------------------------
Version 4.2.002 - 2007-08-31
---------------------------------------------------------------------------

CommandBar and DialogBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[*] HideCloseButton property is obsolete and will be removed in future
    versions, use the Closable property instead.


CommandBar class
~~~~~~~~~~~~~~~~

[-] Closable property doesn't work as expected. The "Close" button appears
    even if the Closable property is set to .F.


DialogBar class
~~~~~~~~~~~~~~~

[-] Controls on the Child form don't display correctly until the child form
    activated (by Show() method or the mouse click).


---------------------------------------------------------------------------
Version 4.2.001 - 2007-07-27
---------------------------------------------------------------------------


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[+] SaveStateToXmlFile method. Saves the current state of command bars to
    the specified XML file.

    Syntax:     ThisForm.CBM.SaveStateToXmlFile( "C:\CBState.xml")

    Tip:   You can save the state of command bars in the Destroy event of
           the form.

    Example:

                ThisForm.CBM.SaveStateToXmlFile( "C:\CBState.xml")
                DoDefault()

[+] RestoreStateFromXml method. Restores the state of command bars from
    the specified XML file or XML string containing previously saved state.

    Syntax:     ThisForm.CBM.RestoreStateFromXml( "C:\CBState.xml")
                or
                ThisForm.CBM.RestoreStateFromXml( m.lcState)

    Tip:   You can restore the state of command bars in the Init event of
           the form after the InitCommandBars method is called.

    Example:

                ThisForm.CBM.InitCommandBars()
                ThisForm.CBM.RestoreStateFromXml( "C:\CBState.xml")


[+] GetCurrentState method. Returns the XML string containing the information
    about the current state of command bars.

    Syntax:     lcCurState = ThisForm.CBM.GetCurrentState()


CommandBar, MenuBar and DialogBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] DockRightOf method. Redocks the command/menu/dialog bar to the right of
    the specified docked command/menu/dialog bar.

    Syntax:     ThisForm.barToDock.DockRightOf( ThisForm.barOnLeft)


[+] Temporary property. Specifies whether the command/menu/dialog bar is
    temporary. The state of temporary command/menu/dialog bars will not
    be saved/restored.


---------------------------------------------------------------------------
Version 4.2.000 - 2007-07-21
---------------------------------------------------------------------------

General
~~~~~~~
[-] Form loses the keyboard focus when command bar button is clicked or
    popup is activated.


CommandBar, MenuBar and DialogBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] Delete method. Removes the command bar.

    Syntax:     ThisForm.commandBar1.Delete()


Popup class
~~~~~~~~~~~

[+] ShowPopup method. Displays the popup menu at the current mouse position,
    or at the specified position relative to the screen.


    Syntax:     ThisForm.popup1.ShowPopup( [tnLeft, tnTop])


CommandBar, MenuBar and Popup classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] CBControls property. Represents the collection of child controls.


ControlButton, MenuBarItem, MenuItem classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] CBControls property. Represents the collection of child controls.


[+] InitControl method. Initializes specified child control.


[+] ShowPopup method. Displays the popup menu associated with button, menu
    item at the current mouse position, or at the specified position
    relative to the screen.


    Syntax:     ThisForm.MainMenu.miEdit.ShowPopup( [tnLeft, tnTop])


---------------------------------------------------------------------------
Version 4.1.009 - 2007-07-11
---------------------------------------------------------------------------

General
~~~~~~~

[-] Tooltips of VFP controls appear when menu popup is active and the mouse
    pointer moves over the VFP control.


CommandBar, MenuBar and DialogBar classes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] DockPosition contains -1 (undocked) and doesn't change to correct value
    if command/menu/dialog bar was undocked and/or docked to another
    (or original) dock bar.

---------------------------------------------------------------------------
Version 4.1.008 - 2007-07-10
---------------------------------------------------------------------------

General
~~~~~~~

[-] WindowState property of a maximized form changes from 2 (Maximized) to
    0 (Normal) when a command/menu/dialog bar is moved, docked, undocked,
    hidden or displayed.


Minor changes and corrections

---------------------------------------------------------------------------
Version 4.1.007 - 2007-05-30
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 4.1.006 - 2007-05-15
---------------------------------------------------------------------------

ComboBox and TextBox controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Setting the ToolTip or ToolTipText propertiy in the InteractiveChange
    event doesn't change the tooltip text of a control.

[-] Setting the Caption propertiy in the InteractiveChange event doesn't
    change the caption of a control.


---------------------------------------------------------------------------
Version 4.1.005 - 2007-05-15
---------------------------------------------------------------------------

General
~~~~~~~
[*] Visual appearance of command bars/menu and "themed" controls changes
    synchronously when the VisualTheme property changes.


---------------------------------------------------------------------------
Version 4.1.004 - 2007-05-14
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[*] Before the InitCommandBars method is called you can specify the following
    in the ClientArea property:

    - character value containing the name of a container on the form:

      ThisForm.CBM.ClientArea = "cntClientArea"

    - reference to the object (Container, Shape) on the form:

      ThisForm.CBM.ClientArea = ThisForm.cntClientArea

    - reference to the container object located on another form, screen etc.:

      ThisForm.CBM.ClientArea = _Screen.cntClientArea

    After the InitCommandBars method is called the ClientArea property
    contains reference to the specified object, that object will be resized
    and moved when command bars/menu docked or undocked.


---------------------------------------------------------------------------
Version 4.1.003 - 2007-04-30
---------------------------------------------------------------------------

General
~~~~~~~

[*] Office 2007 visual theme: appearance of the StatusBar has been corrected.


DialogBar class
~~~~~~~~~~~~~~~

[!][-] Child form doesn't size properly until DialogBar resized manually.
       The problem appears to be if a child form was added to the DialogBar
       before the main form is shown (in the Init event for sample).


[+] SetSize method. Sets the width and height of the dialog bar child window.

    Syntax:     ThisForm.dialogBar1.SetSize( tnWidth, tnHeight)

    Parameters:
                tnWidth - the width of child window;

                tnHeight - the height of child window.

    Note:  Both the specified width and height are used when the DialogBar
           is floating.
           If the bar is docked on the left or right, only the width is used,
           the height will depend on how much of the client area the dialog
           bar can occupy.
           If the bar is docked on the top or bottom, then only the height
           is used to size the child window.


[+] CaptionFlags property. Specifies the caption style.


    Values:  0 - no flags, default;
             1 - hide caption when DialogBar is docked.



Controls in the Extensions library
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[*] OnColorsChanged event. Occurs after the Visual Theme has been changed.
    Allows to change the colors of a control: _backColor, _borderColor etc.


---------------------------------------------------------------------------
Version 4.1.002 - 2007-04-24
---------------------------------------------------------------------------

General
~~~~~~~

[*] Panes of the StatusBar control have incorrect size and position.


---------------------------------------------------------------------------
Version 4.1.001 - 2007-04-23
---------------------------------------------------------------------------

Popup class
~~~~~~~~~~~

[!][-] CreateControl method causes "Data type is invalid for this property."
       error.


---------------------------------------------------------------------------
Version 4.1.000 - 2007-04-20
---------------------------------------------------------------------------

General
~~~~~~~

[+] The StatusBar control from the Common Controls library appears themed
    according selected Visual Theme.

[+] DialogBar class.

    Represents dockable container for child windows (VFP forms).

[+] Extensions library (ARGCommandBarsExt) containing standard control such
    as textbox, editbox etc. that appears themed according selected
    Visual Theme.

DialogBar class
~~~~~~~~~~~~~~~
[+] SetChildForm method. Call this method to specify the child window
    displayed under the dialog bar.

[+] Resizable property. Specifies whether the dialog bar will be re-sizable.

[+] ReleaseChildFormOnDestroy property. Specifies whether the child form will
    be released when the dialog bar releases.


CommandBar class
~~~~~~~~~~~~~~~~
[+] LockRedraw property. Determines whether a command bar batches all changes
    to property settings for its contained controls.

    Set LockRedraw to True (.T.) to reduce annoying command bar refreshes
    when its properties or contained controls (state, visibility, and so on)
    are changed during run time.

[+] Closable property. Specifies whether the Close button appears and the
    command bar can be closed by clicking the Close button.


Other fixes, corrections and improvements.


---------------------------------------------------------------------------
Version 4.0.014 - 2007-03-27
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 4.0.013 - 2007-03-26
---------------------------------------------------------------------------

General
~~~~~~~

[*] Colors of Office 2007 theme have been corrected.


---------------------------------------------------------------------------
Version 4.0.012 - 2007-03-23
---------------------------------------------------------------------------

CommandBar controls
~~~~~~~~~~~~~~~~~~~

[!][-] SetPopup function causes API exception.


Other fixes, corrections and improvements.


---------------------------------------------------------------------------
Version 4.0.011 - 2007-03-15
---------------------------------------------------------------------------

General
~~~~~~~

[*] Colors of Office 2003 on WinXP Blue theme have been corrected.


Other fixes, corrections and improvements.


---------------------------------------------------------------------------
Version 4.0.010 - 2007-02-20
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[+] AutoDisable property. Specifies whether the commadnbars/menu and the main
    form will be automatically disabled when a child modal form activates.
    Default is .F.

[!] To disable automatic handling of modal forms activation, put dummy code
    (NODEFAULT, empty line etc.) to the OnFormActivate, OnFormDeactivate
    methods of the CBM object on your form. Or, set the AutoDisable property
    to .F.

---------------------------------------------------------------------------
Version 4.0.009 - 2007-01-30
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[*] Improved handling of modal forms activation. The library disables the
    command bars/menu when a modal form is displayed, and then enables them
    when a modal form closes.

[+] ShowModalForm method. Disables command bars/menu, displays a modal form,
    and then enables command bars/menu when modal form closes.

    Syntax:     ThisForm.CBM.ShowModalForm( toForm)

    Parameters:
                toForm - reference to the form to be displayed;


[+] BeforeShowModalForm method.
    Call this memeber function to disable command bars/menu before
    displaying modal form.

[+] AfterShowModalForm method.
    Call this memeber function to enable command bars/menu after
    displaying modal form.

    Example:

        ThisForm.CBM.BeforeShowModalForm()
        DO FORM <SomeModalForm>
        ThisForm.CBM.AfterShowModalForm()

---------------------------------------------------------------------------
Version 4.0.008 - 2007-01-12
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[-] RefreshCommandBars method doesn't refresh command bars.

CommandBar controls
~~~~~~~~~~~~~~~~~~~

[-] Keyboard shortcuts execute associated command even when the Command Bars
    disabled (ThisForm.CBM.Enabled = .F.).

[-] After the InitCommandBars the HideFlags property doesn't work as expected.


Other fixes, corrections and improvements.


---------------------------------------------------------------------------
Version 4.0.007 - 2006-12-29
---------------------------------------------------------------------------

ComboBox and TextBox controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[+] CueBunner property.
    
    Specifies the text that is displayed as the text cue, or tip, in an edit
    control when the control is empty and does not have focus.
    Requires Windows XP or later.


ControlCustom control
~~~~~~~~~~~~~~~~~~~~~

[+] VerticalPositionOptions property.

    Specifies whether the control is shown (and how) when the parent toolbar
    vertically docked.


Other fixes, corrections and improvements.


---------------------------------------------------------------------------
Version 4.0.006 - 2006-12-21
---------------------------------------------------------------------------

General
~~~~~~~
[-] Some colors do not consist with MS Office/Visual Studio colors.

Other fixes, corrections and improvements.

---------------------------------------------------------------------------
Version 4.0.005 - 2006-12-18
---------------------------------------------------------------------------

CommandBar controls
~~~~~~~~~~~~~~~~~~~

[!][-] Setting the ShortcutText property of a control at run-time causes
       API exception.

[-] Assigning equal shortcuts for two different controls with the same
    functionality ("Ctrl+S" for "Save" button and "Save" menu item,
    for sample) doesn't work.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[*] OnCommand method receives additional parameter - the reference to a control.

    Syntax:     ThisForm.CBM.OnCommand( tnCommandID, toControl)

    Parameters:
                tnCommandID - command identifier;

                toControl - the reference to a control.


---------------------------------------------------------------------------
Version 4.0.004 - 2006-11-22
---------------------------------------------------------------------------

Minor changes and corrections


---------------------------------------------------------------------------
Version 4.0.003 - 2006-11-17
---------------------------------------------------------------------------

Minor changes and corrections


---------------------------------------------------------------------------
Version 4.0.002 - 2006-11-07
---------------------------------------------------------------------------

CommandBar controls
~~~~~~~~~~~~~~~~~~~

[-] Setting the Visible property of a control to .F. (before InitCommandBars)
    makes a control completely unavailable to the user: hides and removes
    control from the "Add or Remove Buttons" popup.

    Tip:

       To hide control and remove it from the "Add or Remove Buttons" popup,
       set the HideFlags property to 1.


---------------------------------------------------------------------------
Version 4.0.001 - 2006-11-03
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[*] SetColor method now works for all themes except for Windows XP theme.

[-] RefreshCommandBars method doesn't refresh undocked commandbars/menus


---------------------------------------------------------------------------
Version 4.0.000 - 2006-11-02
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] SetColor method. Allows to change standard colors and create custom themes.

    Syntax:     ThisForm.CBM.SetColor( tnColorIdx, tnColor)

    Parameters:
                tnColorIdx - the index of a color;
                tnColor    - new color value;

    For more information, see new _ACB_COLOR_* definitions in the
    ARGCommandBars.h file.

[+] RemoveCommandBar method. Removes a command/menu bar, popup at run-time.

    Syntax:     ThisForm.CBM.RemoveCommandBar( toBar)

    Parameters:
                toBar - the reference to a command/menu bar, popup


CommandBar controls
~~~~~~~~~~~~~~~~~~~

[+] Alignment property.

[+] DisableCustomize property.

[+] Index property. Changes the order of the control in a command/menu bar
    or popup at run-time.

[+] IsVisible method.

    Syntax:     lVisible = ThisForm.cmdBar1.button1.IsVisible()

[+] Delete method. Removes a control from a command/menu bar, popup
    at run-time.

    Syntax:     ThisForm.cmdBar1.button1.Delete()

[-] Setting the Visible property of a control to .F. (after InitCommandBars)
    hides a control and removes it from the "Add or Remove Buttons" popup.

[-] Setting the HideFlags property after InitCommandBars doesn't work.


---------------------------------------------------------------------------
Version 3.6.024 - 2006-09-22
---------------------------------------------------------------------------

General
~~~~~~~

[+] Support for Office 2007 theme.


TextBox control
~~~~~~~~~~~~~~~

[+] ReadOnly property. Default .F.


Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.023 - 2006-09-13
---------------------------------------------------------------------------

[-] Command assigned to the CTRL+F10 key combination with ON KEY LABEL
    does not execute.

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.022 - 2006-09-07
---------------------------------------------------------------------------

[-] Sometimes forms do not activate when selected from the menu containing
    the list of open forms (SpecialControl = 2 - WindowList)

[-] Keyboard shortcuts fire the Click event of disabled menu items.

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.021
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.020
---------------------------------------------------------------------------

[-] Minimize, restore, maximize and close buttons of maximized MDI form
    do not work when AttachToScreen property is set to .T.

---------------------------------------------------------------------------
Version 3.6.019
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.018
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.017
---------------------------------------------------------------------------

TextBox control
~~~~~~~~~~~~~~~

[+] SelectOnEntry property. Default .F.

---------------------------------------------------------------------------
Version 3.6.016
---------------------------------------------------------------------------

ComboBox and TextBox controls
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[-] Control doesn't receive keyboard focus when the SetFocus method is
    called in code.


---------------------------------------------------------------------------
Version 3.6.015
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.014
---------------------------------------------------------------------------

CommandBar controls
~~~~~~~~~~~~~~~~~~~

[-] SetPicture method doesn't change picture at run-time.


---------------------------------------------------------------------------
Version 3.6.013
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.012
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.011
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[*] Released properties:

    - DisplayTooltips;
    - DisplayKeysInTooltips;
    - DisableCustomize;
    - MenuAnimationStyle

---------------------------------------------------------------------------
Version 3.6.010
---------------------------------------------------------------------------

CommandBar controls
~~~~~~~~~~~~~~~~~~~
[-] The SplitButton's caption gets a dark gray background if a control
    is the first visible control on a command bar.

---------------------------------------------------------------------------
Version 3.6.009
---------------------------------------------------------------------------

General
~~~~~~~
[+] Added support for GIF and JPG images.

---------------------------------------------------------------------------
Version 3.6.008
---------------------------------------------------------------------------

General
~~~~~~~
[-] Keyboard shortcuts and menu do not work if a form contains ActiveX
    controls.


CommandBar class
~~~~~~~~~~~~~~~~
[+] Activate method.

    Syntax:     ThisForm.cmdBar1.Activate( [tnControlIndex])

    Parameters:
                tnControlIndex - Specifies the index of a control that is
                automatically selected when the menu/command bar is activated.

---------------------------------------------------------------------------
Version 3.6.007
---------------------------------------------------------------------------

CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[*] CreateGradientBitmap method generates incompatible bitmap if the system
    display is set to low resolution (<= 16 bits per pixel).


---------------------------------------------------------------------------
Version 3.6.006
---------------------------------------------------------------------------

CommandBar class
~~~~~~~~~~~~~~~~
[+] ShowTextBelowIcons property.

---------------------------------------------------------------------------
Version 3.6.005
---------------------------------------------------------------------------

General
~~~~~~~
[+] Added support for the NavigationPane control (Outlook UI Library)


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~
[*] GetColor method.

    For more information, see new _ACB_COLOR_* definitions in the
    ARGCommandBars.h file.

---------------------------------------------------------------------------
Version 3.6.004
---------------------------------------------------------------------------

General
~~~~~~~

[+] You can handle errors that occur in the library objects at run time.
    Define public variable "__ACBDEBUG__" and set its value to .T.:

    Public __ACBDEBUG__
    __ACBDEBUG__ = .T.


CommandBar controls
~~~~~~~~~~~~~~~~~~~

[-] Setting the Tooltip property at run-time doesn't change the tooltip
    text of a control


---------------------------------------------------------------------------
Version 3.6.003
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.002
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.001
---------------------------------------------------------------------------

Minor changes and corrections

---------------------------------------------------------------------------
Version 3.6.000
---------------------------------------------------------------------------

General
~~~~~~~

[-] Wait cursor appears sometime when the mouse pointer moves outside of
    the docking area

[-] "Reset Toolbar" option does not re-hide buttons that were hidden by
    default, but checked for display by a user.


CommandBarsManager class
~~~~~~~~~~~~~~~~~~~~~~~~

[+] OnSystemColorsChanged event

[+] OnVisualThemeChanged event

[+] AttachToFrame property

[+] GetFormSize method. Returns real size (Width and Height) of the form.
    
    Maybe useful if AttachToFrame property set to .T. the Width and Height
    properties of the form contain the width and height of client area (inside
    dock bars), and not real width and height of the form.

    Syntax:     ThisForm.CBM.GetFormSize( @lnWidth, @lnHeight)

[+] SetFormSize method.

    Syntax:     ThisForm.CBM.SetFormSize( tnWidth, tnHeight)

[*] GetColor method.

    Syntax:     ThisForm.CBM.GetColor( tnColorIndex)

    Parameters:
                tnColorIndex   - the index of a color to retrieve.
                                 For more information, see _ACB_COLOR_* definitions in
                                 the ARGCommandBars.h file.

[+] CreateGradientBitmap method. 

    Syntax:     ThisForm.CBM.CreateGradientBitmap( tcFileName, tnColor1, tnColor2, tnSize, tlVertical)

    Parameters:
                tcFileName     - BMP file name to create;
                tnColor1       - top/left color;
                tnColor2       - bottom/right color;
                tnSize         - width or height of the image. Depends on value of the tlVertical parameter;
                tlVertical     - gradient fill mode:
                                 .T. - vertical;
                                 .F. - horizontal.

CommandBar class
~~~~~~~~~~~~~~~~

[+] DockingFlags property

[+] DisableCustomize property

CommandBar controls
~~~~~~~~~~~~~~~~~~~

[-] BeginGroup doesn't change at run-time


---------------------------------------------------------------------------
Version 3.5.001
---------------------------------------------------------------------------

N/A

---------------------------------------------------------------------------
Version 3.5.000
---------------------------------------------------------------------------

N/A