Note: A parameterless constructor is required for all derived classes.
For control style '0 - ExplorerBar' the setting defaults to '2 - XPExplorerBar'
For control style '1 - Listbar' the setting defaults to '1 - XP'
For control style '2 - Toolbox' the setting defaults to '1 - XP'
For control style '3 - OutlookNavigationPane' the setting defaults to '4 - Office2003'
For control style '4 - VisualStudio2005Toolbox' the setting defaults to '5 - VisualStudio2005'
When the
The NavigationPaneExpansionMode enumeration is marked with the [Flags] attribute, which means that some of the values can be combined.
The following table outlines the significance of each individual setting as it relates to whether the expansion button is displayed, and also
under which circumstances the value of the
| Constant | Button displayed? | Expanded state changed |
| None | No | Never; the expanded state is always "Expanded'. |
| OnButtonClick | Yes | Only when the navigation pane expansion button is clicked by the end user. |
| OnSizeChanged | No | Only when the control's width crosses the expansion threshold. |
| OnButtonClickOrSizeChanged | Yes | When the navigation pane expansion button is clicked by the end user, or when the control's width crosses the expansion threshold. |
Use this method to determine whether the code of an event is currently being executed. You may want to know whether an event is occurring before disabling it.
The "in progress" count is used to account for recursive calls to events. You can use it to determine how many nested calls to an event have been made and which level of recursion is now executing.
Disabling an event will not affect the internal operation of the control. Disabling simply instructs the control not to call the event handler so that code the programmer entered is not fired.
For example, disabling the Click will not stop the control from changing the Active Node when it is clicked. It will only cause the Click Event not to fire when the control is clicked.
Disabling an event will not affect the internal operation of the control. Disabling simply instructs the control not to call the event handler so that code the programmer entered is not fired.
For example, disabling the CLick will not stop the control from changing the Active Node when it is clicked. It will only cause the Click Event not to fire when the control is clicked.
This property is initialized upon exit from the editor (as a result of the user pressing ‘Enter’ or ‘Escape’) with the text from the editor. This text can be changed.
The EditedText will only be applied to the
This property is initialized upon exit from the editor (as a result of the user pressing ‘Enter’ or ‘Escape’) with the text from the editor. This text can be changed.
The EditedText will only be applied to the
Values include ‘GroupHeader’, ‘GroupItemArea’, ‘Item’ and ‘Other’.
A built-in default context menu is automatically supplied based on
The built-in default menu can be modified. If modified, the modifications will be preserved so that subsequent firings of the
This property can be set to a developer supplied menu or null. In either case, the (modified) default context menu is not affected and will be supplied the next time the event fires.
If the event is not canceled (i.e., the Cancel parameter is not set to True), the ContextMenu specified is used to set the control’s ContextMenu property.
Note: when an
A built-in default context menu is automatically supplied based on
The built-in default menu can be modified. If modified, the modifications will be preserved so that subsequent firings of the
This property can be set to a developer supplied menu or null. In either case, the (modified) default context menu is not affected and will be supplied the next time the event fires.
If the event is not canceled (i.e., the Cancel parameter is not set to True), the NavigationContextMenu specified is used to set the control’s NavigationContextMenu property.
The dialog will be automatically displayed after the event returns if the Cancel parameter is set to false – you do not need to call the Show method off this reference to display the dialog.
This property is provided primarily to allow you to access the ResetButton property of the dialog so that you can make it visible and listen in to its Click event to provide reset processing.
The UltraExplorerBarGroup object represents a sliding group in the UltraExplorerBar interface. Each UltraWinExplorerBar contains one or more groups. They are used to organize the interface elements that make up the primary UI of the control.
Each group can contain either
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
For
For
If the group's
In cases where the group's height exceeds the height of the control, as much of the group is brought into view as is possible.
Note: When the control's
For
Note: in order for an
Note: the control’s
Note: in order for an
In the case where an
Note: The IsInView property returns true if any part of the group is contained within the viewable area of the control. The group's
Note: Keys are not required for
Each property on the
The actual value that is ultimately used for each property is determined by resolving the value of the property in each
If all values up the chain are set to their default settings, then the control provides a suitable default.
Each property on the
The actual value that is ultimately used for each property is determined by resolving the value of the property in each
If all values up the chain are set to their default settings, then the control provides a suitable default.
Whether the tooltip is displayed can be controlled by setting the
Note: If the ToolTipText property is explicitly set, the tooltip is displayed even when the
Otherwise, the tooltip is displayed only when the Group's text is not fully displayed by its header.
Note: 'Selectable' in the ISelectableItem sense of the word refers to whether the Group can be the source of a drag and drop operation. It is not in any way related to the Group's
The ISelectableItem interface applies to 'items' in the generic sense of the word. Both the
The ISelectableItem interface applies to 'items' in the generic sense of the word. Both the
The ISelectableItem interface applies to 'items' in the generic sense of the word. Both the
The ISelectableItem interface applies to 'items' in the generic sense of the word. Both the
The UltraExplorerBarGroupAppearances object encapsulates the appearance settings for a particular
Note that since all group-related appearance properties are encapsulated by the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
The Appearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinExplorerBar, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
This appearance is only applicable when the
Use this property to determine if an
This appearance is only applicable when the
Use this property to determine if an
This appearance is only applicable when the
Use this property to determine if an
This appearance is only applicable when the
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
The ScrollButtonAppearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinExplorerBar, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Use this property to determine if an
The ScrollButtonHotTrackAppearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinExplorerBar, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Use this property to determine if an
Use this property to determine if an
This element appears within the
This element contains all the remaining elements except the ScrollBarUIElement.
This element directly contains one or more of the following elements:
This element appears within the
This element appears within the
This element directly contains the following elements: various Image and Text UIElements depending on property settings.
The State property is not specifically related to Application Styling; it uses the constants from the
Note: Specifying false for the value of the
Note: Specifying false for the value of the
By default, the ordinal position of each
When the Text property is not explicitly set, the value of the group's Key property is used.
Specifying a value of SortOrder.None has no effect.
The
Note: The
Returns True if the collection allows two or more items to have the same key; otherwise, False.
This property is read only.
Returns True if the collection allows items wihtout keys to be added; otherwise, False.
This property is read only.
The UltraExplorerBarGroupSettings object is used to encapsulate all of the appearance and behavior settings that are applied to an
The settings of this object include
The owner parameter can be set to either an
If this
A value of zero means ‘use default’. A value greater than 1 will cause the Group/Item text to be wrapped onto additional lines when the text cannot fit on a single line.
If True, ampersands in the text will be converted to an underline and when the mnemonic is entered by the user the Group/Item will be activated and clicked.
If False, ampersands in the text are not converted and the Group/Item does not respond to mnemonics.
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Note: An individual property's value can be restored to its default by calling the corresponding Reset method, i.e., Reset[Property Name].
Note: Group Dragging is not supported if the control's
Note: If set to True (the default) and the user unchecks an item this will result in a situation where no items are checked.
If large images are being displayed then the
If small images are being displayed then the
This value is only used when the
A value of -1 indicates that the control should try to resolve the value at a higher level. The ultimate default if all levels return -1 is 150
Refer to the
Refer to the
By default, the same localizable string is displayed in the collapsed group area for all groups. If your application requires the customization of the string that is displayed, the NavigationPaneCollapsedGroupAreaText can be set for all groups by setting the property at the control level (see
Note: This property is only applicable when the
The Style property determines whether items are displayed within the item area of the Group or if a container control occupies the entire item area. If items are displayed, it determines how they are arranged and whether they include images and/or text.
Note: When the Style property is set to LargeImages or LargeImagesWithText, the image alignment settings of the resolved appearance are not applicable.
Note: When the Style property is set to LargeImagesWithTextBelow, the vertical alignment settings of the resolved appearance are not applicable for text or images.
Note: The ShowExpansionIndicator property is only applicable when the control's
The GroupSettingsResolved object contains the same properties as the
If you need to examine property settings at the Group level and take action based on the setting in effect for the Group, access the properties via the GroupSettingsResolved object to make sure you will always have a valid value for comparison purposes.
Note: For
This element appears within the
This element directly contains the following elements:
The UltraExplorerBarItem object represents an Item within an UltraWinExplorerBar Group. Items are interface elements similar to menu items that invoke an action in the program when clicked. An Item consists of an icon and a text string that describes the function of the item. Items an be set to take on one of several pre-defined appearances, such as state (toggle) button or separator, in addition to the standard icon plus label appearance.
Many of the details of an Item's appearance are determined by the settings of the Group that contains the item. (Usually, these settings are derived from the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
For
For
For
For
Note: The
Note: The IsInView property returns true if any part of the item is contained within the viewable area of the control. The item's
Each property on the
The actual value that is ultimately used for each property is determined by resolving the value of the property in each
If all values up the chain are set to their default settings, then the control provides a suitable default.
Whether the tooltip is displayed can be controlled by setting the
Note: If the ToolTipText property is explicitly set, the tooltip is displayed even when the
Otherwise, the tooltip is displayed only when the Item's text is not fully displayed.
The UltraExplorerBarItemAppearances object encapsulates the appearance settings for a particular
Note that since all item-related appearance properties are encapsulated by the
Appearance settings applied at the Item level will override the same settings applied at the Group level. Any Item that does not have a specific Appearance property set explicitly will inherit its setting for that property from the Group.
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
The Appearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinExplorerBar, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
Use this property to determine if an
This element appears within the
This element directly contains the following elements:
This element appears within the
This element directly contains the following elements:
This element appears within the
This element appears within the
This element directly contains the following elements:
Returns True if the collection allows two or more items to have the same key; otherwise, False.
This property is read only.
Returns True if the collection allows items wihtout keys to be added; otherwise, False.
This property is read only.
The UltraExplorerBarItemSettings object is used to encapsulate all of the appearance and behavior settings that are applied to an
The settings of this object include
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
If not explicitly set, the AllowDragMove property resolves to false for items of Style 'Label' and 'Separator', and true for all other styles.
If not explicitly set, the AllowDragCopy property resolves to false for items of Style 'Label' and 'Separator', and true for all other styles.
If large images are being displayed then the
If small images are being displayed then the
A value of 0 indicates that the default height of the item will be used.
A value of -1 indicates that the default indentation will be used.
The default indentation is 0 pixels.
If this property is set to default all the way up the resolution hierarchy, the Item style will be set based on the control style.
Control styles ‘0 – ExplorerBar’ and ‘1 – Listbar’ will default to ItemStyle ‘1 – Button’, and control style ‘2 – Toolbox’ will default to ‘2 – StateButton’.
When set to 'Default', the property resolves to a value that is appropriate based on the current value of the group's
Note: The SeparatorStyle property is only applicable when the item's
By default, space is reserved for the
When set to false, the ReserveImageSpace property prevents the additional space from being reserved, provided that the appearance resolves a null image and the
Note: The ReserveImageSpace property does not apply to items that belong to an
Note: The ReserveImageSpace property defaults to true for all item and control styles, except for the following exclusion:
The ItemSettingsResolved object contains the same properties as the
If you need to examine property settings at the Item level and take action based on the setting in effect for the Item, access the properties via the ItemSettingsResolved object to make sure you will always have a valid value for comparison purposes.
The UseDefaultImage property resolves to false for
The ReserveImageSpace property resolves to false for
Note: For
This element appears within the
This element directly contains the following elements: various Image and Text UIElements depending on property settings.
This element appears within the
This element directly contains the following elements: ImageUIElement
This element appears within the
This element contains the following child elements: EmbeddableUIElementBase
This element appears within the
This element contains no child elements.
This element appears within the
This element contains no child elements.
This class maps keyboard keys with UltraExplorerBar actions.
This element appears within the
This element directly contains the following elements: one
This element appears within the
This element directly contains the following elements: one or more
This element appears within the
This element directly contains the following elements: one or more
This element appears within the
This element directly contains the following elements:
This element appears within the
This element directly contains the following elements: None
This element appears within the
This element directly contains the following elements: NavigationOverflowButtonImageUIElement
This element appears within the
This element contains no child elements, unless an Image is specified in its resolved appearance, in which case it contains one ImageUIElement.
The State property is not specifically related to Application Styling; it uses the constants from the
By default, a 'chevron' is displayed in the foreground for this element. If an image is specified in its appearance, that image is displayed instead; this property determines the size at which that image is displayed.
This element appears within the
This element directly contains the following elements: None
The UltraWinExplorerBar builds on the metaphor introduced in the Outlook Bar of Microsoft Outlook, and later expanded by the Folder and Favorites bars found in Internet Explorer and Windows XP Explorer. The UltraWinExplorerBar is a more advanced version of the Infragistics UltraListBar control. It provides five user interface styles: Listbar, Explorer Bar, Toolbox, Outlook Navigation Pane, and Visual Studio 2005 Toolbox.
It provides a series of sliding groups that contain navigation items. These items can act as buttons, labels, state (toggle) buttons or separators. The UltraWinExplorerBar can also host WinForms controls inside of groups, giving you the flexibility to design a completely customized interface.
Initializes a new instance of the
OnPropertyChanged will also be called.
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Invoke this method to reset the
Once this method is invoked, the
Use this method to determine if the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Use this method to determine if an Appearance object has been created and contains data that needs to be serialized.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Use this method to determine if the
Invoke this method to reset the
Once this method is invoked, the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Use this method to determine if the
Invoke this method to reset the
Once this method is invoked, the
Use this method to determine if the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns a Boolean value that determines whether the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Only valid when the control style is ‘3 – Outlook Navigation Pane’.
When this method is called for other control styles, no dialog is displayed.
For
For
If the group which contains the active control has its
In cases where the active control's height exceeds the height of the control, the top edge of the active control will be brought into view.
For
For
If the group which contains the active control has its
In cases where the active control's height exceeds the height of the control, the top edge of the active control will be brought into view.
If the 'fullyInView' parameter is true, then the active control will be scrolled as much into view as possible. If that parameter is false and the active control is already in view (partially or fully) then this method does nothing.
This method searches each
This method searches each
This method is used to obtain the "logical height" of the
A common use of this information is to set the control's Height to the logical control height so that a
scrollbar is never needed. For example, if the control's
This method can be used to perform a hit test for determining which, if any,
This method can be used to perform a hit test for determining which, if any,
This method can be used to perform a hit test for determining which, if any,
This method can be used to perform a hit test for determining which, if any,
This method loads the data emitted by the
This method loads the data emitted by the
This method loads the data emitted by the
This method loads the data emitted by the
Invoke this method to simulate an action the user can perform.
Many actions are only appropriate in certain situations; if an action is inappropriate, it will not be performed. For example, an attempt to edit the ActiveGroup when there is no Active Group will fail..
You can use the
Invoke this method to simulate an action the user can perform.
You can use the
The
The default Group header context menu can be modified in the
Note: the
The
The default Group item area context menu can be modified in the
Note: the
The
The default Item context menu can be modified in the
Note: the
The navigation context menu is displayed when the user right-clicks on a Group header when the control style is '3 - OutlookNavigationPane'.
The default navigation context menu can be modified in the
Note: the
The 'Other' context menu is displayed when the user right-clicks on an an area of the control that does not represent a Group header, Group item area or Item.
The default 'Other' context menu can be modified in the
Note: the
This method saves the data which can be loaded by the
This method saves the data which can be loaded by the
This method saves the data which can be loaded by the
This method saves the data which can be loaded by the
This method sets the requested properties on the 'appearance' argument to the values used while rendering the control's main UIElement.
This method sets the requested properties on the 'appearance' argument to the values used while rendering the control's
This method sets the requested properties on the 'appearance' argument to the values used while rendering the control's
This method sets the requested properties on the 'appearance' argument to the values used while rendering the control's
When a group's
When a group's
Note: The location where the settings are stored varies depending on the configuration of the system running the application. Information about where these locations are is currently unavailable in Microsoft's MSDN Library.
Note: The location where the settings are stored varies depending on the configuration of the system running the application. Information about where these locations are is currently unavailable in Microsoft's MSDN Library.
Note: The location where the settings are stored varies depending on the configuration of the system running the application. Information about where these locations are is currently unavailable in Microsoft's MSDN Library.
This method must be called after
Note: Calling this method passing in false should only be done when it is known that the changes made between
the
This event fires before the process of changing the active group has begun.
This event fires after the process of changing the active group has completed.
This event fires before the process of changing the active item has begun.
This event fires after the process of changing the active item has completed.
This event can be used to either suppress or modify the context menu displayed by the
Note: When the control's
Note: The ItemClick event is not fired for items whose
If a StateButton style
If a StateButton style
Note: The NavigationContextMenuInitializing event is fired when an element that is specific to the 'OutlookNavigationPane' setting (of the control's
The ContextMenuInitializing event fires under the 'OutlookNavigationPane' style setting, when the clicked element is not specific to the navigation pane functionality; for example, when an
Important note: When the ExplorerBar's
The end developer can prevent the navigation pane from being collapsed by canceling the NavigationPaneCollapsing event (i.e., setting the Cancel property of the event arguments to true).
Important note: When the ExplorerBar's
The end developer can prevent the navigation pane from being expanded by canceling the NavigationPaneExpanding event (i.e., setting the Cancel property of the event arguments to true).
The end developer can programmatically close the navigation pane flyout by calling the
The end developer can prevent the navigation pane flyout from being displayed by canceling the NavigationPaneFlyoutDisplayed event (i.e., setting the Cancel property of the event arguments to true).
Returns the ControlUIElement that contains all the visible graphics of the control.
When set to ‘0 – Default’, control styles ‘1 – Listbar’, ‘2 – Toolbox’, and '3 - OutlookNavigationPane' will resolve to False. Control styles ‘0 – Explorer Bar’ and '4 - VisualStudio2005Toolbox' will resolve to True.
Note that the control’s TabStop property is also honored with regard to accepting focus. If the TabStop property is set to False, the control cannot be tabbed to and therefore will not accept focus via the keyboard.
If the TabStop property is set to true or if the control is clicked on, then the
When set to ‘0 – Default’, control styles ‘1 – Listbar’, ‘2 – Toolbox’, and '3 - OutlookNavigationPane' will resolve to False. Control styles ‘0 – Explorer Bar’ and '4 - VisualStudio2005Toolbox' will resolve to True.
Note that the control’s TabStop property is also honored with regard to accepting focus. If the TabStop property is set to False, the control cannot be tabbed to and therefore will not accept focus via the keyboard.
If the TabStop property is set to true or if the control is clicked on, then the
If the control cannot accept focus because its TabStop property has been set to False, or if no Group currently has the focus, this property returns null.
When this property is set the Group becomes the active Group, and for
If the control cannot accept focus because its TabStop property has been set to False, or if no Item currently has the focus, this property returns null.
When this property is set, the Item becomes the active Item and the active focus rect is shown around the item.
The control styles which support animation are '0 - ExplorerBar', ‘1 – Listbar’, and ‘2 – Toolbox’.
Setting this property to True or False when the
This property controls the duration of an animation sequences performed by the
The Appearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraExplorerBar, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Returns True when the Appearance object for the
Use this property to determine whether an
The Appearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinExplorerBar, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
This property is used to hold a collection of Appearance objects.
Auto-scrolling in the UltraExplorerBar is similar to auto-scrolling seen in a Panel. When a child control
is activated, either via the mouse or keyboard, it is scrolled into view. This functionality can only be used when one or more groups
have their
The active control can be scrolled into view programmatically by calling the UltraExplorerBar's
Set the BackColor property on the control's
Set the ImageBackground property on the control's
Note that not all styles are available on all operating systems. If the version of the OS that your program is running on does not support a particular border style, borders formatted with that style will be drawn using solid lines.
If the
If the control’s
If the control’s
Note: in order for an Item to be checked its
Note: the control’s
When the control's
This property only has an effect when the
Use this property to determine if the control is currently in edit mode, whether an active
Refer to the documentation for the
The EventManager provides a high degree of control over how the control invokes event procedures. You can use it to selectively enable and disable event procedures depending on the context of your application. You can also use the event manager to return information about the state of the control's events.
The event manager's methods are used to determine the enabled state of an event (
Set the ForeColor property on the control's
This property exposes the control's collection of
Each property on the
The actual value that is ultimately used for each property is determined by resolving the value of the property in each
If all values up the chain are set to their default settings, then the control provides a suitable default.
Note: When an
Large
The
The
Small
The
The
Images that are smaller than this size (whether via an index from the ImageListLarge or directly from an appearance’s Image property) will be centered, larger images will be stretched.
Images that are smaller than this size (whether via an index from the ImageListLarge or directly from an appearance’s Image property) will be centered, larger images will be stretched.
When set to a color other than Color.Transparent (the default), all occurrences of the color in the image will be made transparent.
If an image is supplied by setting an Appearance.Image property to an Imagelist index, the ImageLists TransparentColor property is looked at first. If the property is set to Color.TransparentColor, then the control's ImageTransparentColor is used. If it is set to Color.TransparentColor, then no color masking is done.
If an image is supplied by setting the Appearance.Image property to an image, the control's ImageTransparentColor is used. If it is set to Color.TransparentColor, then no color masking is done.
Each property on the
The actual value that is ultimately used for each property is determined by resolving the value of the property in each
If all values up the chain are set to their default settings, then the control provides a suitable default.
This property provides access to the
For example, if you wanted users to be able to navigate between
The following table lists the default key mappings for the
| KeyCode | ActionCode | StateRequired | StateDisallowed | SpecialKeysRequired | SpecialKeysDisallowed |
|---|---|---|---|---|---|
| Up | ActivatePreviousGroupOrItem | ActiveGroupOrItemExists | InEditMode, VisualStudio2005ToolboxMode | ||
| Up | ActivateAndCheckPreviousGroupOrItem | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode | Ctrl | |
| Up | ActivateAndCheckLastItemInPreviousGroup | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode | Ctrl | |
| Up | ActivatePreviousGroup | OutlookNavigationPaneMode, QuickCustomizeButtonActive | InEditMode | ||
| Down | ActivateNextGroupOrItem | ActiveGroupOrItemExists | InEditMode, VisualStudio2005ToolboxMode | ||
| Down | ActivateAndCheckNextGroupOrItem | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode | Ctrl | |
| Down | ActivateAndCheckFirstItemInNextGroup | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode | Ctrl | |
| Down | ActivateQuickCustomizeButton | ActiveGroupExists, OutlookNavigationPaneMode, ActiveGroupIsLastActivateableGroup | InEditMode | ||
| Down | DoNothing | OutlookNavigationPaneMode, QuickCustomizeButtonActive | InEditMode | ||
| Prior | ScrollPageUp | ActiveItemExists, ListbarMode, ActiveItemIsFirstCurrentlyVisibleItemInGroup | InEditMode | ||
| Prior | ScrollPageUp | ActiveGroupOrItemExists, ExplorerBarMode, ActiveGroupOrItemIsFirstCurrentlyVisibleGroupOrItem | InEditMode | ||
| Prior | ScrollPageUpThenActivateAndCheckFirstVisibleGroupOrItem | ActiveGroupOrItemExists, ActiveGroupOrItemIsFirstCurrentlyVisibleGroupOrItem, VisualStudio2005ToolboxMode | InEditMode | ||
| Prior | ActivateAndCheckFirstCurrentlyVisibleGroupOrItem | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode, ActiveGroupOrItemIsFirstCurrentlyVisibleGroupOrItem | ||
| Prior | ActivateFirstCurrentlyVisibleItem | ActiveItemExists, ListbarMode, OutlookNavigationPaneMode | InEditMode | ||
| Prior | ActivateFirstCurrentlyVisibleGroupOrItem | ActiveGroupOrItemExists, ExplorerBarMode | InEditMode, ActiveGroupOrItemIsFirstCurrentlyVisibleGroupOrItem | ||
| Next | ScrollPageDown | ActiveItemExists, ListbarMode, ActiveItemIsLastCurrentlyVisibleItemInGroup | InEditMode | ||
| Next | ScrollPageDown | ActiveGroupOrItemExists, ExplorerBarMode, ActiveGroupOrItemIsLastCurrentlyVisibleGroupOrItem | InEditMode | ||
| Next | ScrollPageDownThenActivateAndCheckLastVisibleGroupOrItem | ActiveGroupOrItemExists, ActiveGroupOrItemIsLastCurrentlyVisibleGroupOrItem, VisualStudio2005ToolboxMode | InEditMode | ||
| Next | ActivateLastCurrentlyVisibleItem | ActiveItemExists | InEditMode, VisualStudio2005ToolboxMode | ||
| Next | ActivateLastCurrentlyVisibleGroupOrItem | ActiveGroupOrItemExists, ExplorerBarMode | InEditMode, ActiveGroupOrItemIsLastCurrentlyVisibleGroupOrItem | ||
| Next | ActivateAndCheckLastCurrentlyVisibleGroupOrItem | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode, ActiveGroupOrItemIsLastCurrentlyVisibleGroupOrItem | ||
| Enter | ClickActiveGroup | ActiveGroupExists, ListbarMode | InEditMode, ActiveGroupIsSelected | ||
| Enter | ClickActiveGroup | ActiveGroupExists, OutlookNavigationPaneMode | InEditMode, ActiveGroupIsSelected | ||
| Enter | ClickActiveGroup | ActiveGroupExists, ExplorerBarMode | InEditMode | ||
| Enter | ClickActiveGroup | ActiveGroupExists, VisualStudio2005ToolboxMode | InEditMode | ||
| Enter | ClickActiveItem | ActiveItemExists | InEditMode | ||
| Space | ClickActiveItem | ActiveItemExists | InEditMode | ||
| Enter | ExitEditMode | InEditMode | |||
| Enter | DisplayQuickCustomizeMenu | OutlookNavigationPaneMode, QuickCustomizeButtonActive | InEditMode | ||
| Space | ClickActiveGroup | ActiveGroupExists, ListbarMode | InEditMode, ActiveGroupIsSelected | ||
| Space | ClickActiveGroup | ActiveGroupExists, OutlookNavigationPaneMode | InEditMode, ActiveGroupIsSelected | ||
| Space | ClickActiveGroup | ActiveGroupExists, ExplorerBarMode | InEditMode | ||
| Space | DisplayQuickCustomizeMenu | OutlookNavigationPaneMode, QuickCustomizeButtonActive | InEditMode | ||
| Escape | ExitEditMode | InEditMode | |||
| Home | ActivateFirstGroup | ActiveGroupExists | InEditMode, VisualStudio2005ToolboxMode | ||
| Home | ActivateFirstGroup | InEditMode, VisualStudio2005ToolboxMode | Shift | ||
| Home | ActivateFirstItemInSameGroup | ActiveItemExists | ActiveItemIsFirstItemInGroup, InEditMode, VisualStudio2005ToolboxMode | ||
| Home | ActivateAndCheckFirstItemInSameGroup | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | ActiveItemIsFirstItemInGroup, InEditMode | Ctrl | |
| Home | ActivateAndCheckFirstGroup | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode | Ctrl | |
| Home | ActivateGroupContainingActiveItem | ActiveItemExists, ActiveItemIsFirstItemInGroup | InEditMode, VisualStudio2005ToolboxMode | ||
| Tab | ActivateFirstGroupOrItem | ActivateableGroupOrItemExists | ActiveGroupOrItemExists, InEditMode, VisualStudio2005ToolboxMode | Shift | |
| Tab | TabNextFromActiveGroupOrItem | CanTabNextFromActiveGroupOrItem | InEditMode, VisualStudio2005ToolboxMode | Shift | |
| Tab | TabPreviousFromActiveGroupOrItem | CanTabPreviousFromActiveGroupOrItem | InEditMode, VisualStudio2005ToolboxMode | Shift | |
| Tab | ActivateLastGroupOrItem | ActivateableGroupOrItemExists | ActiveGroupOrItemExists, InEditMode, VisualStudio2005ToolboxMode | Shift | |
| Tab | ActivateAndCheckNextGroupOrItem | ActiveItemExists, VisualStudio2005ToolboxMode | ActiveItemIsLastItemInGroup, InEditMode | Shift | |
| Tab | ActivateAndCheckFirstItemInSameGroup | ActiveItemExists, ActiveItemIsLastItemInGroup, VisualStudio2005ToolboxMode | InEditMode | Shift | |
| Tab | ActivateAndCheckFirstItemInSameGroup | ActiveGroupExists, VisualStudio2005ToolboxMode | InEditMode | Shift | |
| Tab | ActivateAndCheckPreviousGroupOrItem | ActiveItemExists, VisualStudio2005ToolboxMode | ActiveItemIsFirstItemInGroup, InEditMode | Shift | |
| Tab | ActivateAndCheckLastItemInSameGroup | ActiveItemExists, ActiveItemIsFirstItemInGroup, VisualStudio2005ToolboxMode | InEditMode | Shift | |
| Tab | ActivateAndCheckLastItemInSameGroup | ActiveGroupExists, VisualStudio2005ToolboxMode | InEditMode | Shift | |
| End | ActivateLastGroup | ActiveItemIsLastItemInGroup, ListbarMode | InEditMode, LastGroupIsSelected | ||
| End | ActivateLastItemInLastGroup | ActiveItemExists, ActiveItemIsLastItemInGroup, ExplorerBarMode | InEditMode | Shift | |
| End | ActivateLastItemInLastGroup | ExplorerBarMode | InEditMode | Shift | |
| End | ActivateLastItemInLastGroup | ActiveGroupExists, ExplorerBarMode | ActiveGroupExpanded, InEditMode | ||
| End | ActivateLastItemInLastGroup | ListbarMode, LastGroupIsSelected | InEditMode | ||
| End | ActivateLastItemInSameGroup | ActiveGroupOrItemExists | ActiveItemIsLastItemInGroup, InEditMode, VisualStudio2005ToolboxMode | Shift | |
| End | ActivateAndCheckLastItemInSameGroup | ActiveGroupOrItemExists, VisualStudio2005ToolboxMode | ActiveItemIsLastItemInGroup, InEditMode | Ctrl | |
| End | ActivateAndCheckLastGroup | ActivateableGroupOrItemExists, VisualStudio2005ToolboxMode | InEditMode, LastGroupIsSelected | Ctrl | |
| F2 | EditActiveGroup | ActiveGroupExists, ActiveGroupOrItemIsEditable | |||
| F2 | EditActiveItem | ActiveItemExists, ActiveGroupOrItemIsEditable | |||
| Right | ActivateNextGroup | ActiveGroupExists, ExplorerBarMode, IsMultiColumn | ActiveGroupIsLastGroup, InEditMode | ||
| Right | ActivateNextGroup | ActiveItemExists, ExplorerBarMode, IsMultiColumn | ActiveItemIsInLastGroup, GroupFollowingActiveItemGroupExpanded, InEditMode | ||
| Right | ActivateNextGroup | ActiveGroupExists, OutlookNavigationPaneMode | InEditMode, ActiveGroupIsLastActivateableGroup | ||
| Right | ActivateFirstItemInNextGroup | ActiveItemExists, GroupFollowingActiveItemGroupExpanded, ExplorerBarMode, IsMultiColumn | ActiveItemIsInLastGroup, InEditMode | ||
| Right | ActivateQuickCustomizeButton | ActiveGroupExists, OutlookNavigationPaneMode, ActiveGroupIsLastActivateableGroup | InEditMode | ||
| Right | DisplayQuickCustomizeMenu | OutlookNavigationPaneMode, QuickCustomizeButtonActive | InEditMode | ||
| Right | ClickActiveGroup | ActiveGroupExists, VisualStudio2005ToolboxMode | ActiveGroupExpanded, InEditMode | ||
| Left | ActivatePreviousGroup | ActiveGroupExists, ExplorerBarMode, IsMultiColumn | ActiveGroupIsFirstGroup, InEditMode | ||
| Left | ActivatePreviousGroup | ActiveItemExists, ExplorerBarMode, IsMultiColumn | ActiveItemIsInFirstGroup, GroupPreceedingActiveItemGroupExpanded, InEditMode | ||
| Left | ActivatePreviousGroup | ActiveGroupExists, OutlookNavigationPaneMode | InEditMode | ||
| Left | ActivatePreviousGroup | OutlookNavigationPaneMode, QuickCustomizeButtonActive | InEditMode | ||
| Left | ActivateFirstItemInPreviousGroup | ActiveItemExists, GroupPreceedingActiveItemGroupExpanded, ExplorerBarMode, IsMultiColumn | ActiveItemIsInFirstGroup, InEditMode | ||
| Left | ClickActiveGroup | ActiveGroupExists, ActiveGroupExpanded, VisualStudio2005ToolboxMode | InEditMode |
Specify -1 for any of the 4 properties on the Margins object to force the
The default margins for
The default margins for all other
Refer to the
The default value of this property is True. If the order of the groups should not be customizable by the end-user then set this property to False.
Defaults to True
This setting is ignored for control styles except ‘3 – OutlookNavigationPane’.
Returns null if the
For other styles the value is maintained but not used. A value of -1 displays as many headers as will fit after taking into account the
Note: The NavigationMaxGroupHeaders property limits the number of group headers that are displayed at the time the property is set, but does not prevent the user from resizing the
The Appearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinToolbars, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Returns True when the Appearance object for the
Use this property to determine whether an
Returns null if the
Returns null if the
The Appearance property of an object is used to associate the object with an Appearance object that will determine its appearance. The Appearance object has properties that control settings such as color, borders, font, transparency, etc. For many of the objects in UltraWinToolbars, you do not set formatting properties directly. Instead, you set the properties of an Appearance object, which controls the formatting of the object it is attached to.
Note that the properties of an Appearance object can also operate in a hierarchical fashion. Certain properties can be set to a "use default" value, which indicates to the control that the property should take its setting from the object's parent. This functionality is enabled by default, so that unless you specify otherwise, child objects resemble their parents, and formatting set at higher levels of the control hierarchy is inherited by objects lower in the hierarchy.
Returns True when the Appearance object for the
Use this property to determine whether an
Note that this property only has meaning for control Style ‘0 – Explorer’.
The
For control style ‘0 – ExplorerBar’ this property always returns null and if the property is set an exception is raised.
For control styles ‘1 – Listbar’ and ‘2 – Toolbox’ returns/sets the Group that is currently displaying its Items
If set to True, then the
This property determines whether StateButton type Items are checked exclusively within Groups or the entire control.
The style of the
The '0 - ExplorerBar' style emulates the behavior of the Explorer Bar in Windows XP which allows zero or more
The '1 - Listbar' style emulates the behavior of the Listbar in Outlook which allows 1 and only 1
The '2 - Toolbox' style is essentially the same as the '1 - Listbar' style with the exception that, when scrollbuttons are required to scroll items within a
The '3 - OutlookNavigationPane' style emulates the behavior of the navigation pane seen in Microsoft Outlook. One
The '4 - VisualStudio2005Toolbox' style emulates the behavior of the Toolbox in Microsoft Visual Studio 2005. This style is similar to the '0 - ExplorerBar' style in that zero or more
The
Returns the UIElement that contains all the visible graphics of the control.
If set to ‘0 – Default’, the property will resolve to True for control style ‘0 – ExplorerBar’ and False for other control styles.
If
Only used if the
The ViewStyle property determines the visual scheme used by the
| Style | Default ViewStyle |
| ExplorerBar | XPExplorerBar |
| Listbar | XP |
| OutlookNavigationPane | Office2003 |
| Toolbox | XP |
| VisualStudio2005Toolbox | VisualStudio2005 |
Important note: When the ExplorerBar's
The NavigationPaneExpansionMode determines whether the
Note: The NavigationPaneExpansionMode property is only applicable when the control's
Note: When the NavigationPaneExpansionMode is set to 'None', the value of the
Note: You can determine whether each of the individual bits is set by using the logical 'OR' operator; for example, the expression "NavigationPaneExpansionMode | NavigationPaneExpansionMode.OnButtonClick" ("NavigationPaneExpansionMode Or NavigationPaneExpansionMode.OnButtonClick" in Visual Basic) will return true when the property is set to either 'OnButtonClick' or 'OnButtonClickOrSizeChanged'.
Important note: When the ExplorerBar's
When the
Note: The NavigationPaneExpandedState property is only applicable when the control's
Note: Changing the value of the
Note: Changing the value of the
The NavigationPaneExpansionThreshold property defines the value to which the control's width must be set to trigger a change in the navigation pane's expanded state, expressed in pixels.
For example, if the property's value is set to 50, and the control's width is changed (either programmatically or by the end user) to less than 50, the value of the
Note: The NavigationPaneExpansionThreshold property is only applicable when the control's
Note: In the absence of a specific setting, the NavigationPaneExpansionThreshold property resolves to a "best fit" value; the
When the
Note: The NavigationPaneFlyoutMinimumSize property is only applicable when the control's
When either component of the
Note: The NavigationPaneFlyoutMaximumSize property is only applicable when the control's
When either component of the
This property is only used at design-time.
This property is part of the
This property is part of the
This property is part of the
Note: The location where the settings are stored varies depending on the configuration of the system running the application. Information about where these locations are is currently unavailable in Microsoft's MSDN Library.
Note: The location where the settings are stored varies depending on the configuration of the system running the application. Information about where these locations are is currently unavailable in Microsoft's MSDN Library.
The UltraWinExplorerBar automatically provides several types of items that can be used to populate the control's sliding groups. However, if these item types are insufficient to meet the needs of your application, you can place WinForms control inside of a group to create a custom interface. The UltraExplorerBarContainerControl is used to facilitate this process.
In order to host WinForms controls, an UltraExplorerBarContainerControl is automatically created inside of a group when its
Because the UltraWinExplorerBarContainerControl is created automatically as needed, you will only need to interact with it directly under limited circumstances.
The UltraExplorerBarUIElement occupies the entire area of the control.