<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
Readme file for C1Command for .NET, .NET 2.x version.
<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>

Thank you for your interest in the ComponentOne Command (menus,
toolbars and more) offering.

ComponentOne Command for .Net (C1Command), is an integral part of
ComponentOne Studio for .Net.

Please direct your feedback for to the following newsgroup:

  news://news.componentone.com/Component1.public.net.command

For the C1Command for .NET 1.x version's maintenance log, please see
the readme-dotnet_1.txt file also included in the release.

<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
Differences from the .NET 1.x version:
<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>

* All changes in the version of C1Command for .NET 2.x are source
  compatible with the versions of C1Command for .NET 1.x.
* C1Command 2.x does not reference or need the C1Common assembly.
* Most C1Command controls provide better design-time experience via
  the new design time features of the Visual Studio 2005 designer.

<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
C1Command for .NET (.NET 2.x version) maintenance log:
<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>

========================================================================
C1Command for .NET Build 2.0.20071.19105, 08-Feb-2007
========================================================================

Bug fixes
---------

* Miscellaneous design time fixes.

* The Text property of C1NavBar buttons was not localizable. Fixed.

* Fixed a problem with painting anchored C1OutBar when the form is 
  resized.

* Fixed side menu caption painting issues when it did not fit in the 
  menu.
  
* Multiple ampersands in a command text all appeared underlined. Fixed.

* Fixed a painting problem when expanding a topic page using XP look.

* Fixed an issue with image layout when using C1DockingTab's sloping 
  style when there was not enough space for the tab.

========================================================================
C1Command for .NET Build 2.0.20071.19104, 26-Jan-2007
========================================================================

Object model changes
--------------------

* C1NavBar object model was changed in a backwards-INCOMPATIBLE way. In 
  the previous versions of C1Command, the C1NavBar contained two 
  separate editable collections: Panels and Buttons. Each panel had to 
  have a corresponding button, the correspondence between the two was 
  established via the ID property set on the panel and the corresponding 
  button. Buttons were explicitly created and added to the Buttons 
  collection. Starting with this build, this was changed. The Buttons 
  colleciton is no longer editable. A button is automatically created on 
  the panel when that panel is created, and can NOT be created 
  standalone. The Buttons collection can no longer be edited at design 
  time, the buttons' properties can be set via the Button property of 
  the panel (panels are accessible at design time via the Panels 
  collection, as before). (The Buttons collection can be accessed for 
  enumerating and editing the buttons' properties at run time though.)
  Buttons' properties are now persisted as panel.Button.<property-name> 
  in the InitializeComponent code. The IndexOf method on both 
  collections (Panels and Buttons) was changed - it now accepts an 
  object, and returns the index of the specified panel or button. The 
  old IndexOf (which accepted int ID as the parameter) was renamed to 
  IndexOfID.
  
  Because the changes are backwards-incompatible, existing code using 
  C1NavBar will have to be changed. The following steps should allow you 
  to convert existing InitializeComponent code to work with the new 
  version of C1NavBar:

  (1) In InitializeComponent(), remove explicit construction of 
  C1NavBarButton objects:

  C1.Win.C1Command.C1NavBarButton c1NavBarButton1 = new C1.Win.C1Command.C1NavBarButton();

  (2) Locate the lines assigning buttons' and panels' ID, such as:

  c1NavBarButton1.ID = 1;
  ...
  this.c1NavBarPanel4.Button.ID = 1;

  In the old model, correspondence between panels and buttons was 
  established via IDs, so note which button corresponds to which panel, 
  you will need this info when changing the lines assigning properties 
  to buttons.

  (3) Locate the line or lines adding buttons to the C1NavBar, those 
  should look similar to this: 

  this.c1NavBar1.Buttons.AddRange(new C1.Win.C1Command.C1NavBarButton[]{
    c1NavBarButton1,
    c1NavBarButton2,
    c1NavBarButton3,
    c1NavBarButton4});

  Delete this line or lines (buttons always exist on panels, and need 
  not be explicitly added).

  (4) Change the way buttons are referenced in the properties' 
  assignments. For each button, whenever it is referenced in a property 
  assignment, instead of direct referencing the button variable (those 
  were deleted in step 1 above), reference the button via its panel 
  instead. (Which panel corresponds to which button was determined by 
  IDs, you should have this info from step 2 above.) So e.g. if 
  c1NavBarButton1 corresponded to c1NavBarPanel1, replace all 
  occurrences of "this.c1NavBarButton1" with 
  "this.c1NavBarPanel1.Button", e.g. instead of 

  c1NavBarButton1.Image = ((System.Drawing.Image)(resources.GetObject("c1NavBarButton1.Image")));

  you will have
     
  c1NavBarPanel.Button.Image = ((System.Drawing.Image)(resources.GetObject("c1NavBarButton1.Image")));

  Repeat this for all button properties' assignments EXCEPT assignments 
  of IDs - just delete those lines, as buttons' IDs are determined by 
  the panels they belong to.
        
  (5) Finally, remove lines adding panels to the C1NavBar's Controls 
  collection - this is no longer needed as adding panels to the Panels 
  collection automatically adds them to the Controls collection as well. 
  I.e. lines like the following:

  this.c1NavBar1.Controls.Add(this.c1NavBarPanel4);

  should be deleted.
   
  This completes the process, now the project should build and run with 
  the new version of C1Command.
  
* The method C1NavBarPanel C1NavBarPanel.PanelCollection.FindID(int id) 
  threw an exception when the specified panel was not found. Now it 
  returns null.
  
* The C1NavBar.ButtonClick event was raised whenever the panel selected 
  in the C1NavBar changed. Now this event only fires on actual button 
  clicks. A new public event C1NavBar.SelectedPanelChanged was added 
  inseted, it fires whenever the selected panel changes.

Bug fixes
---------

* Japanese localization fixes.

* Miscellaneous design time fixes.

* Miscellaneous C1NavBar issues fixed due to the object model change.

* Fixed incorrect layout of C1DockingTab with only one page, TabSizeMode 
  set to FillToEnd, and not enough space for the tab.

* Fixed: floating toolbars were not hidden when the corresponding MDI 
  child form was minimized.
  
========================================================================
C1Command for .NET Build 2.0.20071.19008, 04-Jan-2007
========================================================================

* 2007 T1 release.

* New intuitive designers provided for all controls in the suite.

* Miscellaneous bug fixes.

========================================================================
C1Command for .NET Build 1.0.20063.18008, 27-Oct-2006
========================================================================

Bug fixes
---------

* Miscellaneous bug fixes.

========================================================================
C1Command for .NET Build 1.0.20063.18007, 08-Sep-2006
========================================================================

Bug fixes
---------

* Fixed a C1NavBar repainting issue when the control is docked and its 
  parent is resized.

* Fixed issue: KeyUp event of the TextBox did not get fired when placed 
  in a C1ToolBar.

========================================================================
C1Command for .NET Build 2.0.20063.18006, 05-Sep-2006
========================================================================

New features
------------

* Added accessibility features to C1Command components.

* New controls added to the suite: C1NavBar, C1TopicBar.

* C1DockingTab: if focus is inside the docking tab, pages can be 
  switched by pressing hot key combinations Alt+<letter>, where letter 
  is a letter of the tab caption prefixed by an ampersand.

* New public property:
    bool C1DockingTab.ShowTabList {get;set;}
  Gets or sets the value indicating whether to show a button with 
  dropdown list of all tabs (ignored in multiline mode).
  
  New event: C1DockingTab.ShowTabListChanged.

* New public property:
    C1ContextMenu C1Command.C1ContextMenu {get;set;}
  Gets or sets the C1ContextMenu component associated with this command.

* New public method:
    C1DockingTab[] C1DockingTab.GetCreatedDockingTabs();

  Returns the collection of all C1DockingTab components that were 
  automatically created as the result of user interaction with the 
  current C1DockingTab (e.g. when a page is teared off and dropped to 
  float outside of the form).
  
  Return value: The array of automatically created C1DockingTab 
  controls.

* New public property:
    bool C1CommandMenu.CloseOnItemClick {get;set;}
  Gets or sets the value indicating whether to close the menu when an 
  item is clicked.
  The default is true. This property allows to created menus with the 
  functionality of check lists, where multiple items can be checked or 
  unchecked as needed, without the menu closing.

Bug fixes
---------

* Miscellaneous bug fixes.

========================================================================
C1Command for .NET Build 2.0.20062.17012, 17-Apr-2006
========================================================================

New features
------------

* New public indexer added to C1Commands, C1DockingTabPages, C1OutPages 
  collections:
    C1Command C1Commands.this[string key] {get;}
    C1DockingTabPage C1DockingTabPages.this[string key] {get;}
    C1OutPage C1OutPages.this[string key] {get;}
  where the key parameter corresponds to the Name property of the 
  component (command, docking tab or out page).

Bug fixes
---------

* Multiple bug fixes (see the list of fixes for build 1.0.20062.172 in
  the readme-dotnet_1.txt file).

========================================================================
C1Command for .NET Build 2.0.20062.17011, 21-Mar-2006
========================================================================

* 2006 T2 build.

* At design time, menu/toolbar items' texts can be edited in-place.
  For this, highlight the item (either with the mouse or with the
  keyboard), and press Enter to activate the in-place editor. Press
  Enter again to finish editing and accept changes, or Esc to cancel
  changes.

* Please see the readme-dotnet_1.txt file for details on new features
  common to .NET 1.* and 2.0 versions.

========================================================================
C1Command for .NET Build 2.0.20061.15050, 15-Dec-2005
========================================================================

* 2006 T1 build.

========================================================================
C1Command for .NET Build 2.0.20053.15030, 15-Dec-2005
========================================================================

* Multiple bug fixes (see the list of fixes for build 1.0.20053.149 in
  the readme-dotnet_1.txt file).

========================================================================
C1Command for .NET Build 2.0.20053.139, 3-Nov-2005
========================================================================

* First public .NET 2.x release.

<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
The End.
<><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>