==================================================================== C1Ribbon ComponentOne, LLC - www.componentone.com ==================================================================== Welcome to ComponentOne Ribbon. ComponentOne Ribbon is an integral part of Studio Enterprise, the largest and most complete toolset for developing Win, Web, Mobile and ASP.NET AJAX enabled applications. Please direct feedback for Ribbon to the following forum: http://helpcentral.componentone.com/CS/forums/65/ShowForum.aspx news://newsforums.componentone.com/net.ribbon_for_.net - Support and Feedback Options ComponentOne is dedicated to providing reliable best-of-breed components. If you have any issues using our products, we want to know about it. Please use the following pages for information to get support. Online Support: http://helpcentral.componentone.com Support Center: http://www.componentone.com/Support To submit a support request, report a bug, or request a feature, please use our online Incident Submission Form. Note that we ask you to be logged into your ComponentOne Account to submit an incident. Login or Create an Account: http://www.componentone.com/c1account/pages/MyAccountMain.aspx - Installed Files ComponentOne Ribbon installs the following files and components. Files: C1.Win.C1Ribbon.2.dll, C1.Win.C1Ribbon.2.XML, C1.Win.C1Ribbon.Design.2.dll Components: C1Ribbon, C1StatusBar, C1RibbonForm ==================================================================== Ribbon Build Number [2.0.20082.89] Released: [May 2, 2008] ==================================================================== - Steps to reproduce the issue: populated the ribbon gallery, move down one row. Press the popdown key to see full list. Click off to the side, choose not to pick any of the images. The up arrow on the gallery is disabled even though there is still one row above it. - When the user moves the mouse cursor over top of a ribbon group this group may draw itself for half a second on top of a non-modal form that overlays the ribbon group. ==================================================================== Ribbon Build Number [2.0.20082.88] Released: [April 30, 2008] ==================================================================== - C1RibbonForms disappeared from the Application.OpenForms collection when the windows theme is changed, for example, from Windows Classic to Windows XP. (VNRIB000387) - The C1Ribbon control threw an error when adding items to a group through the property grid at runtime. (VNRIB000425) - MDIParent C1RibbonForm showed incorrect backcolor at runtime. (VNRIB000426) - The default value for the C1Ribbon.MinimumWidth and MinimumHeight properties has been changed from 200 to 0. (VNRIB000423 and VNRIB000424) ==================================================================== Ribbon Build Number [2.0.20082.87] Released: [April 24, 2008] ==================================================================== - C1RibbonForm with C1Ribbon present on it did not resize properly when Form.AutoSize = True and Form.AutoSizeMode = GrowAndShrink. (VNRIB000388) - C1RibbonForm returned incorrect height at runtime. (VNRIB000394) - Form flickered across the right margin in the C1RibbonForm, if padding of the form is set. (VNRIB000395) - Child C1RibbonForm shown incorrect theme when MDIParent has a C1Ribbon control. (VNRIB000396) - Ribbon tab caption being cut off at ends at runtime. (VNRIB000398) - Controls overlap with the Ribbon in C1RibbonForm when Control's Dock is set to Top. (VNRIB000399) - When a C1Ribbon control is placed on a C1RibbonForm, the title bar of the C1RibbonForm was overlapped by the Ribbon control at run time. Thus the title and Minimize/ Maximize/Close buttons did not appear. (VNRIB000415) - Tab area became black if the only available tab is made invisible. (VNRIB000416) - Fixed an issue with control scrollbars on a C1RibbonForm. ==================================================================== Ribbon Build Number [2.0.20082.86] Released: [April 2, 2008] ==================================================================== - When the user places the mouse cursor over the gallery element and uses the scroll wheel it moved the gallery to the next row and also switched the ribbon to the next tab. Now the scroll wheel only switches the ribbon to the next tab without scrolling the gallery element. ==================================================================== Ribbon Build Number [2.0.20082.85] Released: [March 27, 2008] ==================================================================== - A NullReferenceException occured when disposing a form with the C1Ribbon control after clicking the "close" item in a ribbon drop-down (such as a RibbonMenu). ==================================================================== Ribbon Build Number [2.0.20082.84] Released: [March 25, 2008] ==================================================================== - Tooltip did not appear for the RibbonEditBox and RibbonComboBox elements when the mouse pointer hovers text part of the element. - Added the RibbonControlHost element. It allows to embed an arbitrary control into the C1Ribbon. For example, let's add the TextBox control to a ribbon group. We have to define the following class: VB: Public Class TextBoxHost Inherits C1.Win.C1Ribbon.RibbonControlHost Public Sub New() MyBase.New(New System.Windows.Forms.TextBox()) End Sub End Class C#: public class TextBoxHost : C1.Win.C1Ribbon.RibbonControlHost { public TextBoxHost() : base(new System.Windows.Forms.TextBox()) { } } Now we should build the project and open a form with the C1Ribbon control in the designer. Open the action floatie for the RibbonGroup, then select "Add ControlHost". This will open a dialog box where you should type the class name of our control host, such as "RibbonApplication1.TextBoxHost". When you click the OK button the control will be added to the ribbon group. Next time, when you want to add the TextBoxHost element you don't have to type its name. The name of this class can be selected from the drop-down list in the "Adding RibbonControlHost" dialog box. The RibbonControlHost class publishes the standard properties and events of the hosted control. To access other properties, methods, and events of the hosted control use the RibbonControlHost.Control property. It is also possible to override methods such as RibbonControlHost.OnSubscribeControlEvents to handle events raised by the hosted control. You can put custom functionality into properties to enhance the hosted control. ==================================================================== Ribbon Build Number [2.0.20081.83] Released: [March 15, 2008] ==================================================================== - Incorrect header appeared above the C1RibbonForm if this form is shown from its Load event handler behind a splash screen and the value of the Localizable property is True for that form. - An issue was introduced in the previous build (82). The standard window caption and buttons appeared sometimes on a C1RibbonForm under Windows XP. ==================================================================== Ribbon Build Number [2.0.20081.82] Released: [March 14, 2008] ==================================================================== - A white horizontal bar appeared on a C1RibbonForm under Vista when this form is resized to small size and the C1Ribbon control on this form should be hidden. - If the C1Ribbon control doesn't appear because the parent C1RibbonForm has too small size there was a problem when the user maximizes then restores that C1RibbonForm. - The Form.LayoutMdi() method did nothing if the MDI child forms are based on C1RibbonForm. ==================================================================== Ribbon Build Number [2.0.20081.81] Released: [February 5, 2008] ==================================================================== - Added new properties to the RibbonEditBox element: PasswordChar and UseSystemPasswordChar. These are counterparts of the same properties of the standard TextBox control. - Added some French strings for runtime localization. ==================================================================== Ribbon Build Number [2.0.20081.80] Released: [January 15, 2008] ==================================================================== - Minimizing the Ribbon and then maximizing it always returned to the first tab. - The Tag property of the RibbonGroup and RibbonTab elements is now visible in the property grid and can be assigned at design time. The type of this property is Object. We can't preserve its value in the Ribbon XML Template. - The FormBorderStyle property of the C1RibbonForm can now be set to None. - The RibbonToggleButton element with the Pressed property set to True at design time did not appear correctly in the RibbonApplicationMenu at run time. - There were some problems with a C1RibbonForm which has FixedSingle or FixedDialog border style. Each attempt to open this form without recreating it caused a loss of 10 pixels in width and height. - A double click in the caption of a C1RibbonForm is ignored and doesn't maximize the form if the Maximize window button is hidden or not enabled. ==================================================================== Ribbon Build Number [2.0.20073.79] Released: [December 27, 2007] ==================================================================== - Several localization strings were updated. ==================================================================== Ribbon Build Number [2.0.20073.78] Released: [December 26, 2007] ==================================================================== - If RibbonProgressBar.Minimum >= RibbonProgressBar.Maximum the value of "Maximum" and "Value" didn't become equal to "Minimum" (the issue was not fixed correctly in build 76). - Added several missing localization strings. ==================================================================== Ribbon Build Number [2.0.20073.77] Released: [December 21, 2007] ==================================================================== - Instances of the C1RibbonForm class were excluded from the Application.OpenForms collection when windows theme is changed, for example, from Windows Classic to Windows XP. - The Size, Location, and Padding properties of the C1Ribbon and C1StatusBar controls have been hidden because these controls are autosized and can't contain nested controls. - Refixed a problem with RibbonMenu/RibbonSplitButton items present in the MenuItems collection of a RibbonComboBox (VNRIB000374). - Added Project and Item Templates for Visual Studio 2008. ==================================================================== Ribbon Build Number [2.0.20073.76] Released: [December 14, 2007] ==================================================================== - The RibbonSeparator.HiddenMode property was not working on QAT. - The RibbonSeparator.ShowInQATMenu property has been hidden. - Added default context menu having an option to remove the RibbonSeparator item from QAT. - Fixed a problem with RibbonMenu/RibbonSplitButton items present in the MenuItems collection of a RibbonComboBox. - It was not possible to select a RibbonToggleButton in RibbonToggleGroup when added to the MenuItems collection of RibbonComboBox/RibbonFontComboBox. - Added the navigation through Keyboard feature for Items and MenuItems in the RibbonGallery element. - If RibbonProgressBar.Minimum >= RibbonProgressBar.Maximum the value of "Maximum" and "Value" didn't become equal to "Minimum". - No error occured on setting 'Value' property of RibbonProgressBar/RibbonTrackBar to a value lying outside the range specified by "Minimum" and "Maximum". - Black area appeared and C1StatusBar control appeared on top of this black area when the C1StatusBar control is resized from top at design time. The same issue occured for the C1Ribbon control when it is resized from bottom at design time. - Hotkeys for the RibbonColorPicker and RibbonSplitButton components did not work as expected. - Hotkeys and shortcuts for the Ribbon components added in the C1StatusBar control did not work. - The RibbonItem.Tag property is now visible in the property grid and can be assigned at design time. The type of this property is Object. We can't preserve its value in the Ribbon XML Template. - GotFocus/LostFocus for RibbonItems with text area fired multiple times on placing focus on them then shifting to some other and back to these controls. - MouseEnter/MouseLeave for all the items added in RibbonMenu/RibbonSplitButton items collection fired even on navigating through keyboard. ==================================================================== Ribbon Build Number [2.0.20073.75] Released: [December 4, 2007] ==================================================================== - The Ribbon changes the selected tab when the mouse wheel moves while the mouse pointer is within the Ribbon. - Added the HiddenMode boolean property to the RibbonSeparator class (false by default). When this property is True the separator doesn't appear in a RibbonGroup but it works still as usual. ==================================================================== Ribbon Build Number [2.0.20073.74] Released: [November 30, 2007] ==================================================================== - Incorrect height retrieved after the Form_Load of a run time instance of C1RibbonForm containing C1Ribbon control. ==================================================================== Ribbon Build Number [2.0.20073.73] Released: [November 28, 2007] ==================================================================== - InvalidOperationException observed when multiple instances of C1Ribbon involved in a multithreaded application. - Some unexpected key combinations (such as 'Ctrl+Ins', 'Ctrl+Y', 'Ctrl+]', and so on) were captured by the Ribbon and selected the next ribbon tab. - ArgumentOutOfRange exception was thrown in the RibbonMenu and RibbonSplitButton drop-downs when they have a RibbonToggleGroup element and the user presses the arrow keys to navigate through the menu. - Added setters for the RibbonComboBox.SelectedIndex and the RibbonComboBox.SelectedItem properties. Both of these properties were readonly in previous builds. - Added the ShowContextMenu event to the RibbonGalleryItem component. There is no standard context menu for this element. The user can display his own context menu from the handler for the ShowContextMenu event. ==================================================================== Ribbon Build Number [2.0.20073.72] Released: [November 19, 2007] ==================================================================== - Fixed a problem that caused SLE to crash on exit. ==================================================================== Ribbon Build Number [2.0.20073.71] Released: [November 15, 2007] ==================================================================== - Trapped an InvalidOperationException that may occur in a C1RibbonForm if the application has multiple GUI threads. - Fixed some issues in C1RibbonForm under Vista when the FormBorderStyle property is FixedDialog. - The caption of a C1RibbonForm was not updated in the Task Bar when the user assigns a new value to the Text property of the C1RibbonForm from code. ==================================================================== Ribbon Build Number [2.0.20073.70] Released: [November 1, 2007] ==================================================================== - The title of C1RibbonForm was incorrect if such a form contains a maximized childform. It was not fixed correctly in build 69. - If the C1Ribbon control placed on a C1RibbonForm is disabled, then the window buttons(min,max,close) did not inherit VisualStyle of the form and showed the standard theme buttons when clicked. - ApplicationMenu button properties showed 'Object Reference Not Set' on an existing RibbonForm when a new Windows Form with StatusBar added to the Project. - The next properties inherited from the Control class have been hidden in C1Ribbon and C1StatusBar classes: Anchor, MaximumSize, MinimumSize. - The tab area turned black when the 'Visible' property of the only present tab is set to 'False'. - The BackColor of the C1RibbonForm didn't get changed if VisualStyle of C1Ribbon is changed while the layout logic for the form is suspended. - When the WindowState property of a C1RibbonForm is set to 'Maximized' at design time the form appeared at the wrong location at runtime. - Hightlighting on a ribbon button existed after disabling and enabling the button if the button was disabled in the Click event handler. - Added the AllowMinimize property to the C1Ribbon control. The property specifies whether the ribbon can be minimized when the user double-clicks on tab header. ==================================================================== Ribbon Build Number [2.0.20073.69] Released: [October 29, 2007] ==================================================================== - The default tooltips appeared for all items on the QAT if the user adds any other item to QAT. - A number of exceptions were thrown on trying to add the C1Ribbon or C1StatusBar controls on a Windows form added in a Ribbon application. - On toggling the properties "ShowInQat","ShowInQatMenu" from the property grid, the ribbon items were removed from the property grid. - The title of C1RibbonForm was incorrect when such a form containing a maximized childform. - The Visible property of the RibbonApplicationMenu object has been hidden. - Fixed a couple of issues when the Quick Access Toolbar is hidden: removed unnecessary item from RibbonItem's context menu, removed the selection glyph for a hidden QAT. - A big black rectangle displayed in the content area of the C1Ribbon control that was in minimized state when the user unchecked the "Minimize the Ribbon" option in the context menu for a RibbonItem on a popped up RibbonTab. - Added the IsDisposed runtime property to the following classes: RibbonItem, RibbonGroup, and RibbonTab. The property returns a boolean value indicating whether the corresponding object has been disposed of. - Fixed a one-pixel misalignment problem under Vista that occured when the QAT is above the Ribbon and has no items. - After defining the MinimumSize property in a form that inherits from C1RibbonForm, there were very strange behaviors: 1) the StartPosition property were not respected 2) when the application looses the focus and you use Alt+Tab or click on the application's icon in the task bar, the calling form of the C1RibbonForm was displayed instead of the C1RibbonForm itself. ==================================================================== Ribbon Build Number [2.0.20073.68] Released: [October 21, 2007] ==================================================================== - Added the TabPopupWidth property that specifies the maximum width of the tab popup window when the Ribbon is minimized. The default value is -1. This stretches the popup window to the whole width of the owner window. - The RibbonComboBox.Text property returned wrong (old) value in the handler for the SelectedIndexChanged event of this RibbonComboBox. ==================================================================== Ribbon Build Number [2.0.20073.67] Released: [October 15, 2007] ==================================================================== - Fixed artefacts with the larger scale (120DPI) mode under Vista. - Fixed a misalignment in the ribbon caption when the C1Ribbon control is placed on an arbitrary Form (not C1RibbonForm) and QAT is below the ribbon. ==================================================================== Ribbon Build Number [2.0.20073.66] Released: [October 10, 2007] ==================================================================== - When a user control was created by using C1Ribbon or C1StatusBar, a license popup appeared for the control at runtime when it is used in a new project. - When the RibbonProgressBar control is added in the RightPaneItems collection of C1StatusBar control and its Width property is set to some large value (say 200), the RightPane does not resize itself and results in the clipping of RibbonProgressBar control. - The DoubleClick event shouldn't be fired and processed after double-clicking the right mouse button. - Added the GetHostRibbonItem static method to the C1Ribbon class. This method allows to find out the owner RibbonItem for the specified control, such as a TextBox, that is used internally in the RibbonItem (e.g. in the RibbonEditBox). - The RibbonGroup.MouseLeave event was not fired when the user moves the mouse pointer slowly out of the group. - Tooltips may appear off the screen. - Values of 'MinimumWidth' and 'MinimumHeight' properties of C1Ribbon control not retained on saving and loading the Ribbon template XML. - 'ObjectDisposedException' observed when 'MinimumWidth'/ 'MinimumHeight' property is set inside any event handler of any C1RibbonItem. ==================================================================== Ribbon Build Number [2.0.20073.65] Released: [October 5, 2007] ==================================================================== - When the user adds the C1StatusBar control to the form there was a one-pixel displacement of the status bar. - When the user adds an item to the left pane of the newly added C1StatusBar control the right pane shrinked. It was then impossible to click the right pane to enable the smart designer for the right pane. - When the user removes the C1StatusBar control the owner C1RibbonForm was not redrawn. ==================================================================== Ribbon Build Number [2.0.20073.64] Released: [September 27, 2007] ==================================================================== - Added several missing localization strings. ==================================================================== Ribbon Build Number [2.0.20073.63] Released: [September 24, 2007] ==================================================================== - When the form is minimized from bottom to top, still the C1Ribbon remains visible unlike the MS Word 2007. - Added the MinimumHeight property to the C1Ribbon control. This property sets the minimum height of the parent container. The C1Ribbon will disappear if the container height become less than the specified value. - Provided an upper limit for the GapBeforeTextArea property of RibbonComboBox/RibbonEditBox. The maximum allowable value for this property has been set to 80. - Setting C1Ribbon.Enabled or C1RibbonForm.Enabled to False also disabled the window buttons (min, max, close) on the C1RibbonForm. - Copying then pasting the RibbonComboBox/RibbonEditBox elements at design time did not retain their value of the GapBeforeTextArea property. ==================================================================== Ribbon Build Number [2.0.20073.62] Released: [September 19, 2007] ==================================================================== - The menus, comboboxes, and split buttons did not always drop open if they are clicked on when the Form is not currently active. The user had to click off and back on to get them to open. - The SetTooltip() method of the C1Ribbon control has been renamed to SetToolTip(). ==================================================================== Ribbon Build Number [2.0.20073.61] Released: [September 4, 2007] ==================================================================== - Added several missed Japanese resource strings. ==================================================================== Ribbon Build Number [2.0.20073.60] Released: [August 31, 2007] ==================================================================== - Items on the C1StatusBar used black (invisible) text color when the C1StatusBar has black visual style. - Added support for the FixedSingle and FixedDialog border styles to the C1RibbonForm under Windows Vista. - The ControlBox, MaximizeBox, and MinimizeBox properties of the child MDI form were not honored when the child form is maximized in the C1RibbonForm with the C1Ribbon on it. ==================================================================== Ribbon Build Number [2.0.20073.59] Released: [August 29, 2007] ==================================================================== - Removed a one-pixel displacement of the C1StatusBar under Windows Vista with Aero (Glass) interface. - The standard context menu appears now on a right button click in the tab area and app menu button of the C1Ribbon. - The ribbon items can now serialize their strings into the .resx file. So, if the Localizable property of the owner form is True it is possible to localize the strings in ribbon items using the resource file. - Updated several localized strings on the C1Ribbon. - Adjusted styles for some elements (such as RibbonButton, RibbonMenu, and others) on the C1StatusBar. - Added the Width property to the RibbonProgressBar. It was impossible to change width of this element. ==================================================================== Ribbon Build Number [2.0.20073.58] Released: [August 23, 2007] ==================================================================== - The MouseEnter and MouseLeave events were not fired for collapsed groups on the ribbon. These events are fired now as though this is a regular group, not a drop-down button that shows the group. - Added the group context menu to collapsed ribbon groups. - Added a couple of new methods to C1Ribbon and C1StatusBar: public void BeginUpdate() public void EndUpdate() These methods maintain performance while items are being added or removed. When adding a large number of items, you should use the BeginUpdate method to prevent item collections from updating their internal state each time an item is added. Once you have completed the task of adding items, call the EndUpdate method to resume regular processing. - Added a new property to RibbonComboBox and RibbonEditBox: public int GapBeforeTextArea { get; set; } This property specifies the gap (in pixels) between the "label" and "textbox" parts of the element. This allows to line up "textbox" parts of several combo/editboxes vertically on a ribbon group. ==================================================================== Ribbon Build Number [2.0.20073.57] Released: [August 22, 2007] ==================================================================== - There were major problems in C1RibbonForm when the user switched the current desktop theme from Aero (Glass) to Vista Basic/Standard and vice versa. - When the user dropped down a menu (app menu, qat menu, or a ribbon menu) and clicked on some other window, the Deactivate event did not fire for the C1RibbonForm. - Added a new run-time property to the C1Ribbon control: public string QatItemIDs { get; set; } This property allows to preserve QAT items added by the user at run-time. It gets or sets the string that specifies the list of item IDs on the QAT. - Added a new public method to C1Ribbon and C1StatusBar: public Component GetItemByID(string ID) The method searches for the first item with the specified ID through the whole C1Ribbon or C1StatusBar. The returned value can be either RibbonItem or RibbonGroup (or null). ==================================================================== Ribbon Build Number [2.0.20073.56] Released: [August 21, 2007] ==================================================================== - An unpredictable runtime exception occured sometimes during interaction with the ribbon if the HotTransitionEffect property of that control is True. - Changing the VisualStyle property of the C1RibbonForm also updates the BackColor property of this form. - Fixed a number of issues under Windows Vista including some fixes in the title bar of C1RibbonForm and the problem that caused C1RibbonForm to grow in height each time when the user restores the form from minimized or maximized state. ==================================================================== Ribbon Build Number [2.0.20072.55] Released: [July 27, 2007] ==================================================================== - When the ribbon is hidden (minimized), the topmost ribbon form continued to remain on top of other windows even after the code sets the TopMost property to False from the RibbonCheckBox.CheckedChanged event handler. - Added the OwnerControl property to RibbonItem instead of the RibbonItem.Ribbon property that was removed by accident from the previous build of the product. The OwnerControl property returns either C1Ribbon or C1StatusBar that this RibbonItem belongs to. - The RibbonDropDownBase.DropDown event fired after the popup window has already appeared. There was no way to modify the drop-down menu from the event handler. Now the DropDown event occurs before laying out the popup window. ==================================================================== Ribbon Build Number [2.0.20072.53] Released: [July 24, 2007] ==================================================================== - The Activated/Deactivate events of the C1RibbonForm were fired when the user clicked on a ribbon menu item or the ribbon application menu. - The ribbon theme font has been changed from "Tahoma" to "Segoe UI" when the control works under Windows Vista. - There was a problem with updating the title bar of a narrow ribbon form under Windows Vista. ==================================================================== Ribbon Build Number [2.0.20072.52] Released: [July 11, 2007] ==================================================================== - It was not possible to move the C1RibbonForm on the second monitor if it was on the left of the primary monitor. The C1RibbonForm seemed to be frozen on the second monitor. ==================================================================== Ribbon Build Number [2.0.20072.51] Released: [July 11, 2007] ==================================================================== - An unhandled NullReferenceException occured when the user removed an item from ribbon's QAT at runtime if the TopMost property of the owner form was True. - A small change applied to the ribbon templates - the status bar in the templates now uses dynamic width for the right pane. ==================================================================== Ribbon Build Number [2.0.20072.50] Released: [July 10, 2007] ==================================================================== - Added a smart designer (with drag&drop, copy&paste, etc.) to the C1StatusBar control. - Fixed a problem with disposing of the ribbon designer. - The default value for the C1StatusBar.RightPaneWidth property has been set to -1. This allows to update the width of status bar's right pane automatically. ====================================================================