If the object of the requested type cannot be returned, this method returns null. Typically you will use this method to return a MenuItem tool that corresponds to the UIElement.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

This element appears within the . One of these elements is created for each in the associated with this element.

This element directly contains the following elements: ImageUIElement, TextUIElement

This property returns the borders required to draw the UIElement. Depending on the placement of the popup menu and other settings, borders may not be needed on all edges. This property takes into account the style of the toolbar.

The border style returned is determined by the style of the toolbar.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Invoke the method to reset this property to its default value.

Invoke the method to reset this property to its default value.

Invoke the method to reset this property to its default value.

Use this property to determine if an object has been created. ApplicationMenuFooterToolbar objects in general are not created until the properties associated with them are accessed.

Key tips are displayed when the ribbon is showing and the Alt key is pressed.

If the key tip for the application menu conflicts with another tool in the same container, this key tip may be changed.

By default, if the key tip is not set for the application menu, a unique key tip will be auto-generated for the application menu. and must be False for key tips to not auto-generate.

Use this property to determine if an object has been created. ApplicationMenuArea objects in general are not created until the properties associated with them are accessed.

Use this property to determine if an object has been created. ApplicationMenuArea objects in general are not created until the properties associated with them are accessed.

If this property returns True, the popup portion of the control is currently being displayed to the user.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke the method to reset this property to its default value.

Use this property to determine if an object has been created. ApplicationMenuAreaSettings objects in general are not created until the properties associated with them are accessed.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

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.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

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.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

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.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

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.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

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.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

This property returns a reference to the UltraToolbarsManager object associated with this SettingsBase object.

This property is read only.

The DefaultForToolType setting indicates tools are displayed based on the default for the tool's type and location. The TextOnlyAlways setting specifies tools are always displayed as text. The TextOnlyInMenus setting indicates tools are displayed as their assigned images when located on an , but displayed as text when on a . The ImageAndText setting specifies tools are displayed as both their assigned image and text. The ImageOnlyOnToolbars setting indicates tools are displayed as their assigned images when located on an UltraToolbar, but as both image and text when located on a PopupMenuTool.

Note: This enumeration does not affect tools that are placed on a . The contents of a tool on a ribbon group are based upon the and .

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Note: When overriding this method, it is recommended the base implementation is called before the derived implementation returns.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

The accessible description is used by accessibility client applications and normally read to the user.

The accessible name is used by accessibility client applications and normally read to the user.

These are all tools explicitly defined on the toolbar in the current Form or UserControl being designed.

These tools actually serialize into the InitializeComponent method instead of all tools in the collection, which contains declared tools and inherited tools.

Note: This property only applies to the and will return null for all other toolbars.

When an MDI merge occurs, a toolbar from the child will be merged into a toolbar on the parent if they have the same key or both have IsMainMenuBar set to True. In this case, the toolbar on the parent will return the toolbar on the child from its UnderlyingToolbar property.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

The , , and properties control the left, right, and bottom padding respectively.

The , , and properties control the left, right, and top padding respectively.

The , , and properties control the right, top, and bottom padding respectively.

The , , and properties control the left, top, and top bottom respectively.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

There are several levels at which the property can be set. These levels exist in an inheritance hierarchy. Use this property to walk up the hierarchy to determine to what value the property resolves.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Note: A parameterless constructor is required for all derived classes.

To be notified when an instance of the ButtonTool is clicked, handle the ToolClick event of the ButtonTool. To be notified when any instance of all ButtonTools with the same Key are clicked, handle the event and check the Key of the tool passed into the event arguments.

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Note: When overriding this method, it is recommended the base implementation is called before the derived implementation returns.

Note: When overriding this method, it is recommended the base implementation is called before the derived implementation returns.

Invoke the method to reset this property to its default value.

This method resets all of the modifiable properties of the InstanceProps object to their default values. Any properties that default to their "use default" setting then take on the settings found in the associated SharedProps object. Invoking this method is the equivalent of invoking the method of the InstanceProps object.

Invoke the method to reset this property to its default value.

Invoke the method to reset this property to its default value.

This method resets all of the modifiable properties of the SharedProps object to their default values. Note that invoking this method on a single instance of a tool resets SharedProps for all instances of the tool; all instances descended from the same root tool (and the root tool itself) share the same SharedProps object. Invoking this method is the equivalent of invoking the method of the InstanceProps object.

This applies only to tools that share a contained control, e.g. and .

This method should not be called directly.

This is necessary since it is possible to have multiple parent tools referencing a single from the mdi child.

This method is called internally before certain operations to ensure that the has a proper context.

Note: This method currently only affects a tool that is sited on a .

You can invoke this method to remove any end-user customizations to the tool and return it to the state it was in when the application started. Specifically, this method will reset the caption, display style, grouping, visibility and recently-used status of the tool. For PopupMenu tool, invoking this method also resets any customizations that have been performed on the tools of the menu.

Note: It is recommended that derived tool types override Clone and . The Clone override should create a new instance of the derived tool type and call InitializeFrom on the new tool instance, passing in the current tool and .

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

Note: It is recommended that derived tool types override and InitializeFrom. The InitializeFrom override should call the base implementation of InitializeFrom and copy all members defined on the derived type from the to this tool.

Once a tool is activated it becomes the active tool. You can use the property to determine whether a tool is currently the active one.

Once a tool is deactivated it is no longer the active tool. You can use the property to determine whether a tool is currently the active one.

The default implementation simply calls the method. A tool must be activatable for the mnemonic key to work.

This method is invoked in response to changes in the underlying editor. It will only apply to certain tools, such as the combo box.

The default implementation calls fires the event.

The event is fired whenever a tool is clicked.

This method applies only to tools that have an editable value that can be changed, such as the combo box. Note that a tool's text its value may be different.

The property returns the current value of the tool.

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

The should be taken from the base implementation's which should be overridden and incremented in each tool type providing its own extra shared props.

Override in derived classes to return the correct image rect. This will only be called for instance tools and is used to determine the location of key tips. Return to have the key tip use the entire tool rect to determine its location.

The tool parameter will be either the tool itself or an instance of a that wraps the tool.

The default implement calls .

One use of this method is to notify of changes to any properties of the SharedProps and InstanceProps objects that will affect the current tool.

This property has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this method.

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

The should be taken from the base implementation's which should be overridden and incremented in each tool type providing its own extra shared props.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

When you have a tool on a child MDI form, that tool can be merged with the toolbar on the parent MDI form when the child form is maximized. To accomplish this, an invisible placeholder tool is added to the parent form's toolbar for any tool found on a child MDI form's toolbar. The placeholder tool is merely a pointer to the tool on the MDI child form, which is the underlying tool. Properties that have context in the parent form's toolbar, such as position, are handled by the placeholder tool; any other properties set or read at run-time are simply passed through to or from the child form's tool.

The AttachedParentTool property is necessary because it is possible to have multiple parent tools referencing a single .

The method is called internally before certain operations to ensure that the has a proper context.

There are several levels at which the Caption property may be set. At run-time, an end user may set the caption of a control using the run-time customizer. Caption may be set through code on the InstanceProps object, which will affect only the single instance of the tool for which it is set. The caption may also be set on the SharedProps object, which will affect all the instances of the tool that occur in the application. Finally, it can be set at the tool level which will be the default setting for all tools of the same type that are added to the application.

These settings exist in an inheritance hierarchy. The end-user defined settings are applied first. If there is no end-user customization, the InstanceProps setting is used. If the InstanceProps property is set ot its "use default" value, the SharedProps setting is used. The default values of the SharedProps object always provide a value that can be used by the control.

The property of the SharedProps object determines the text that will appear in the run-time customizer next to the icon for this tool. This property returns the value that will be applied to this tool.

The property of the SharedProps object determines the text that will appear in the run-time customizer in the descriptive text area for this tool. This property returns the value that will be applied to this tool.

There are several levels at which the DisplayStyle property may be set. At run-time, an end user may set the display style of a control using the run-time customizer. DisplayStyle may be set through code on the InstanceProps object, which will affect only the single instance of the tool for which it is set. The display style may also be set on the SharedProps object, which will affect all the instances of the tool that occur in the application. Finally, it can be set at the tool level which will be the default setting for all tools of the same type that are added to the application.

These settings exist in an inheritance hierarchy. The end-user defined settings are applied first. If there is no end-user customization, the InstanceProps setting is used. If the InstanceProps property is set ot its "use default" value, the SharedProps setting is used. The default values of the SharedProps object always provide a value that can be used by the control.

Note: This enumeration does not affect tools that are placed on a . The contents of a tool on a ribbon group are based upon the and .

UltraWinToolbars represents a tool in two ways, as a root tool and an instance tool. Root tools are the tools that appear in the run-time customizer; their purpose is to create the tools that will appear on a toolbar or menu. Instance tools are the tools that the user actually interacts with; they appear on toolbars and/or menus. Each instance tool is related to exactly one root tool. Each root tool may have multiple instance tools derived from it. For example, a "FileSave" root tool may have two instance tools in an application - one displaying only text and appearing on the File menu, and one displaying only an image and appearing on the Standard toolbar.

Although functionally treated as distinct objects, root and instance tools share a close relationship. Changes made to a root tool will affect all instance tools derived from that root. Changes to an instance tool may affect only the one instance, or they may affect the root tool and by extension other instances of that root.

Because root and instance tools have some features that are shared and some that are unique, UltraWinToolbars splits some of each tool's properties between two objects. Properties that apply to the root tool and all instances of that tool are found on the SharedProps object, which is accessed via the tool's property. As the name suggests, the properties of the SharedProps object are shared across all instances of the tool. A change to one of these properties will affect the root tool and all other instances of the tool.

Properties that affect only a single instance of the tool are found on the InstanceProps object, which is accessed via the tool's property. Although root tools have an InstanceProps property, this property returns Null, as there are no instance properties associated with a root tool.

These properties exist in an inheritance hierarchy, with common properties supporting a "use default" setting to indicate that the value of that property should be inherited. When resolving the property setting for a particular tool instance, the InstanceProps value for a property is applied first. If the InstanceProps property is set to its "use default" value (i.e. there is not InstanceProps value for the property) then the SharedProps setting for the property is used. The default values of the SharedProps object always provide a value that can be used by the control. If for some reason the SharedProps value is set to "use default", the intrinsic value of the root tool is used.

For a complete discussion of the difference between root and instance tools, see the following section of the help: Developer’s Guide > The Toolset > Controls and Components > WinToolbarsManager > Understanding WinToolbarsManager.

The active tool is the tool that currently has the input focus.

This property returns True if the tool is the first tool in a tool group. Otherwise, it returns False. This property applies only to the current instance of the tool. This property always returns False for a root tool.

UltraWinToolbars represents a tool in two ways, as a root tool and an instance tool. Root tools are the tools that appear in the run-time customizer; their purpose is to create the tools that will appear on a toolbar or menu. Instance tools are the tools that the user actually interacts with; they appear on toolbars and/or menus. Each instance tool is related to exactly one root tool. Each root tool may have multiple instance tools derived from it. For example, a "FileSave" root tool may have two instance tools in an application - one displaying only text and appearing on the File menu, and one displaying only an image and appearing on the Standard toolbar.

Although functionally treated as distinct objects, root and instance tools share a close relationship. Changes made to a root tool will affect all instance tools derived from that root. Changes to an instance tool may affect only the one instance, or they may affect the root tool and by extension other instances of that root.

For a complete discussion of the difference between root and instance tools, see the following section of the help: Developer’s Guide > The Toolset > Controls and Components > WinToolbarsManager > Understanding WinToolbarsManager.

This property will return True for a root tool, False for an instance tool.

The Key property is a unique, user-defined object identification string that can be used interchangeably with the Index of an object when accessing it through code. If you attempt to assign a value to the Key property is not unique in the collection, an error will occur.

The value of the Index property of an object can change when objects in the collection are reordered, such as when you add or remove objects. If you expect the Index property to change dynamically, refer to objects in a collection using the Key property. In addition, you can use the Key property to make your program "self-documenting" by assigning meaningful names to the objects in a collection.

You can set the Key property when you use the Add method to add an object to a collection. In some instances, the Key property of an object may be blank if that object does not appear in a collection.

Also, note that the uniqueness of keys is only enforced when the Key property is set to a value. If a collection supports objects with blank keys, that collection may contain multiple objects that whose Key property is empty. In that case, you must use Index property to differentiate between the objects that have blank keys.

The MaxWidth property determines the maximum width the tool can occupy. This property can be set on the SharedProps object to affect all instances of the tool, or on the InstanceProps object to affect only a single instance tool. The InstanceProps setting will take precedence over the SharedProps setting.

This property will return the value that is in effect for the current tool regardless of whether it is the InstanceProps or the SharedProps setting.

The MinWidth property determines the minimum width the tool can occupy. This property can be set on the SharedProps object to affect all instances of the tool, or on the InstanceProps object to affect only a single instance tool. The InstanceProps setting will take precedence over the SharedProps setting.

This property will return the value that is in effect for the current tool regardless of whether it is the InstanceProps or the SharedProps setting.

Derived classes can override this property. This property returns a System.Drawing.Size object containing the default height and width of the tool.

This returns true for root tools only (those added to 's collection. This property is read-only.

Use this property to access the collection containing this object.

This property is used by the control when determining how to construct customized menus.

UltraWinToolbars represents a tool in two ways, as a root tool and an instance tool. Root tools are the tools that appear in the run-time customizer; their purpose is to create the tools that will appear on a toolbar or menu. Instance tools are the tools that the user actually interacts with; they appear on toolbars and/or menus. Each instance tool is related to exactly one root tool. Each root tool may have multiple instance tools derived from it. For example, a "FileSave" root tool may have two instance tools in an application - one displaying only text and appearing on the File menu, and one displaying only an image and appearing on the Standard toolbar.

Although functionally treated as distinct objects, root and instance tools share a close relationship. Changes made to a root tool will affect all instance tools derived from that root. Changes to an instance tool may affect only the one instance, or they may affect the root tool and by extension other instances of that root.

Because root and instance tools have some features that are shared and some that are unique, UltraWinToolbars splits some of each tool's properties between two objects. Properties that apply to the root tool and all instances of that tool are found on the SharedProps object, which is accessed via the tool's property. As the name suggests, the properties of the SharedProps object are shared across all instances of the tool. A change to one of these properties will affect the root tool and all other instances of the tool.

Properties that affect only a single instance of the tool are found on the InstanceProps object, which is accessed via the tool's property. Although root tools have an InstanceProps property, this property returns Null, as there are no instance properties associated with a root tool.

These properties exist in an inheritance hierarchy, with common properties supporting a "use default" setting to indicate that the value of that property should be inherited. When resolving the property setting for a particular tool instance, the InstanceProps value for a property is applied first. If the InstanceProps property is set to its "use default" value (i.e. there is not InstanceProps value for the property) then the SharedProps setting for the property is used. The default values of the SharedProps object always provide a value that can be used by the control. If for some reason the SharedProps value is set to "use default", the intrinsic value of the root tool is used.

For a complete discussion of the difference between root and instance tools, see the following section of the help: Developer’s Guide > The Toolset > Controls and Components > WinToolbarsManager > Understanding WinToolbarsManager.

This property determines the shortcut key value that will be used for the control.

At run-time, an end user may set the shortcut key of a control using the run-time customizer. Shortcut may also be set on the SharedProps object, which will affect all the instances of the tool that occur in the application. These settings exist in an inheritance hierarchy. The end-user defined settings are applied first. If there is no end-user customization, the SharedProps setting is used. The ShortcutResolved property returns the value that is being used by the tool.

The property specifies whether a tool should alter its width to fill available space on a toolbar (provided the toolbar has this feature enabled.) This property returns the value of Spring that is in effect for the tool, taking into consideration a variety of factors, such as whether the tool has a width than be set and whether the toolbar is currently being customized.

The default implementation returns null. Tools that have editors should override this property to return an appropriate role for the edit area.

There are several levels at which the Visible property may be set. At run-time, an end user may set the visibility of a control using the run-time customizer. Visible may be set through code on the InstanceProps object, which will affect only the single instance of the tool for which it is set. Visibility may also be set on the SharedProps object, which will affect all the instances of the tool that occur in the application.

These settings exist in an inheritance hierarchy. The end-user defined settings are applied first. If there is no end-user customization, the InstanceProps setting is used. If the InstanceProps property is set ot its "use default" value, the SharedProps setting is used. The default values of the SharedProps object always provide a value that can be used by the control.

There are several levels at which the Width property may be set. At run-time, an end user may set the width of a control using the run-time customizer. Width may be set through code on the InstanceProps object, which will affect only the single instance of the tool for which it is set. Width may also be set on the SharedProps object, which will affect all the instances of the tool that occur in the application.

These settings exist in an inheritance hierarchy. The end-user defined settings are applied first. If there is no end-user customization, the InstanceProps setting is used. If the InstanceProps property is set ot its "use default" value, the SharedProps setting is used. The default values of the SharedProps object always provide a value that can be used by the control.

Note: This enumeration does not affect tools that are placed on a . The contents of a tool on a ribbon group are based upon the and .

Generally, any tool that is active will be drawn as active. However, System Menu tools will not display as active unless they are located on a menu.

During MDI merge, tools from toolbars on child MDI forms are merged with their placeholders in the toolbar of the parent MDI form. If there is a tool that you do not want to display in the toolbar of the parent MDI form when the child MDI form is maximized, you can set this property to True.

The property determines whether a tool should display an image, text or both when placed on a toolbar or menu. Different types of tools have different default settings, and the settings for some tools may be changed by either the developer or the end user.

This property provides a quick way for you to determine whether a particular instance of a tool is displaying an image. This property takes into account the instance's tool type, its DisplayStyle setting and whether it is positioned on a toolbar or menu.

The property determines whether a tool should display an image, text or both when placed on a toolbar or menu. Different types of tools have different default settings, and the settings for some tools may be changed by either the developer or the end user.

This property provides a quick way for you to determine whether a particular instance of a tool is displaying text. This property takes into account the instance's tool type, its DisplayStyle setting and whether it is positioned on a toolbar or menu.

This property returns the top-level object that owns the tool. This will always be a toolbar or a menu control. If a tool is positioned directly on a toolbar or menu, that is the object returned. If a tool is positioned on a sub-menu (i.e. on a PopupMenu tool) this property will determine which menu the sub-menu descends from and return that object. This is true even if the sub-menu is nested within one or more sub-menus; the top level menu is always returned.

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

Each tool type that wants to store another extra shared props object should override ExtraSharedPropsCount, and in the get accessor, call the base implementation, add one, and return that new number. When accessing the custom extra shared props object, the tool type should use the value of ExtraSharedPropsCount from the base implementation and pass that as the index parameter into either or .

DisplayStyle determines how the tool appears on the toolbar: whether it shows only an icon, only text or an icon and text. The CanSetDisplayStyle property specifies whether the display style may be set for a tool.

DisplayStyle may be set through code on the object, which will affect the display of only the single instance of the tool for which it is set. DisplayStyle may also be set on the object, which will affect the display of all the instances of the tool that occur in the application.

You can use this property to determine whether the width of the control may be set. If False, the control has a fixed width.

Width may be set through code on the object, which will affect the width of only the single instance of the tool for which it is set. Width may also be set on the object, which will affect the width of all the instances of the tool that occur in the application.

This will return null except for tools that contain controls, e.g. and .

This property returns the default value setting for AllowMultipleInstances. This is the value the property is set to if its setting is not modified at design-time or through code.

This property always returns True, the default setting for AllowMultipleInstances.

This property returns the default value setting for BackColor. This is the value the property is set to if it is not modified at design-time, through code or at run-time by end-user customization.

This property is used if none of the caption properties has been specified and defaults to an empty string.

This property returns the default value setting for ForeColor. This is the value the property is set to if it is not modified at design-time, through code or at run-time by end-user customization.

This property returns the default value setting for Image. This is the value the property is set to if it is not modified at design-time, through code or at run-time by end-user customization.

The property determines whether a tool should display an image, text or both when placed on a toolbar or menu. However, different tools have different capabilities for displaying an image. This property determines whether the control can display an image when it is placed on a toolbar. To quickly determine whether an instance of a tool is actually displaying an image, you can use the property.

The property determines whether a tool should display an image, text or both when placed on a toolbar or menu. However, different tools have different capabilities for displaying an image. This property determines whether the control can display an image when it is placed on a toolbar. To quickly determine whether an instance of a tool is actually displaying an image, you can use the property.

The property determines whether a tool should display an image, text or both when placed on a toolbar or menu. However, different tools have different capabilities for displaying an image. This property determines whether the control can display text when it is placed on a menu. To quickly determine whether an instance of a tool is actually displaying text, you can use the property.

The property determines whether a tool should display an image, text or both when placed on a toolbar or menu. However, different tools have different capabilities for displaying text. This property determines whether the control can display text when it is placed on a toolbar. To quickly determine whether an instance of a tool is actually displaying text, you can use the property.

This property always returns false.

This property returns the default value setting for MergeType. This is the value the property is set to if its setting is not modified at design-time or through code.

This default implementation for this property always returns Replace, the default setting for MergeType.

This property returns the default value setting for ShowInCustomizer. This is the value the property is set to if its setting is not modified at design-time or through code.

This property always returns True, the default setting for ShowInCustomizer.

This property returns the default value setting for TextHAlign. This is the value the property is set to if its setting is not modified at design-time or through code.

This property always returns HAlign.Center, the default setting for TextHAlign.

This property has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this property.

Internally, the control uses embeddable editors supplied by the Win assembly to provide standard types of data display and input.

This property has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this property.

This property has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this property.

This property will return True only for tools that can contain controls, such as the and tools. For most controls (button, combo box, etc.) this property will return False.

This property applies only to container tools that host other controls. Use this property to determine whether the control contained by the tool is shared among all instances of the tool or is unique to this instance of the tool.

This property returns True if the control is shared, False if it is unique to the instance.

This property returns whether the underlying embeddable editor used by the tool will return null (DBNULL) or an empty string in response to the deletion of the contents of the editor.

This is a future expansion property. In the current version of UltraWinToolbars, this property always returns True.

Tools may be displayed on either menus or toolbars. Some tools will change their appearance depending on whether they are on a menu or a toolbar.

This property returns True if the tool will be displayed when located on a menu. If False, the tool will be visible only on toolbars or not at all.

Tools may be displayed on either menus or toolbars. Some tools will change their appearance depending on whether they are on a menu or a toolbar.

This property returns True if the tool will be displayed when located on a toolbar. If False, the tool will be visible only on menus or not at all.

Certain tools (such as the combo box tool) are better suited to appearing in the horizontal layout that is found on a toolbar or menu that is docked at the top or bottom of a form. It is often difficult to display these tools in a vertical toolbar that is docked to the left or right edge of the form. To do so either requires reducing the size of the control enough to impede usability, or increasing the width of the toolbar area enough to interfere with the main body of the application. For this reason, it is easier to simply prevent certain tools from appearing on a vertically-oriented toolbar.

Use this property to determine whether a tool will be visible on a vertically-oriented toolbar. This property returns True if the tool will be visible, False if it will not.

This will return null except for tools that contain controls, e.g. and .

This event is generated after a tool becomes the active tool, meaning it received focus.

The event is generated before a tool becomes the active tool.

The event is generated after a tool becomes inactive.

The property can be used to set or return the active tool.

This event is generated after a -derived tool closes.

The event is generated after a tool is dropped down.

This event is generated after a -derived tool opens.

The event is generated after a tool closes.

This event is generated after a tool enters edit mode.

The event is generated before a tool enters edit mode.

The event is generated after a tool has entered edit mode.

The event is generated before a tool leaves edit mode.

The event is generated after a tool has exited edit mode.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

This event is generated after a tool exits edit mode.

The event is generated before a tool enters edit mode.

The event is generated after a tool has entered edit mode.

The event is generated before a tool leaves edit mode.

The event is generated after a tool has exited edit mode.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

This event is generated before a tool becomes the active tool, meaning it received focus.

The event is generated after a tool becomes the active tool.

The event is generated after a tool becomes inactive.

The property can be used to set or return the active tool.

This event is generated before a -derived tool closes.

The event is generated after a tool is dropped down.

The event is generated after a tool is closed.

This event is generated before a tool enters edit mode.

The event is generated before a tool enters edit mode.

The event is generated after a tool has entered edit mode.

The event is generated before a tool leaves edit mode.

The event is generated after a tool has exited edit mode.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

This event is generated before a tool exits edit mode.

The event is generated before a tool enters edit mode.

The event is generated after a tool has entered edit mode.

The event is generated before a tool leaves edit mode.

The event is generated after a tool has exited edit mode.

Note: This event has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this event.

This event is generated when the user clicks a tool.

This event is generated when the user double-clicks a tool.

The event is generated when the user clicks a tool.

This event is generated after the event if the value that the user has entered is invalid.

This event is generated when the user presses down a key when a tool has the input focus.

The event is generated when the user presses down and releases a key when a tool has the input focus.

The event is generated when the user releases a key when a tool has the input focus.

This event is generated when the user presses down and then releases a key when a tool has the input focus.

The event is generated when the user presses down a key when a tool has the input focus.

The event is generated when the user releases a key when a tool has the input focus.

This event is generated when the user releases a key when a tool has the input focus.

The event is generated when the user presses down and releases a key when a tool has the input focus.

The event is generated when the user releases a key when a tool has the input focus.

This event is generated when the value of a tool changes, either programmatically or by user interaction.

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Note: It is recommended that derived tool types override Clone and . The Clone override should create a new instance of the derived tool type and call InitializeFrom on the new tool instance, passing in the current tool and .

Return to have the key tip use the entire tool rect to determine its location.

The tool parameter will be either the tool itself or an instance of a that wraps the tool.

Note: It is recommended that derived tool types override and InitializeFrom. The InitializeFrom override should call the base implementation of InitializeFrom and copy all members defined on the derived type from the to this tool.

To force the of the ComboBoxTool to be one of the items in its list, set the to DropDownList. Otherwise, to let custom input to be entered into the combo box with the keyboard, set DropDownStyle to DropDown.

To be notified when an instance of the ComboBoxTool has its Value changed, handle the ToolValueChanged event of the ComboBoxTool. To be notified when any instance of all ComboBoxTools with the same Key has its Value changed, handle the event and check the Key of the tool passed into the event arguments.

To be notified when an instance of the TextBoxTool has its changed, handle the ToolValueChanged event of the TextBoxTool. To be notified when any instance of all TextBoxTools with the same Key has its Text changed, handle the event and check the Key of the tool passed into the event arguments.

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Note: It is recommended that derived tool types override Clone and . The Clone override should create a new instance of the derived tool type and call InitializeFrom on the new tool instance, passing in the current tool and .

Return to have the key tip use the entire tool rect to determine its location.

This property returns True when the tool is currently in edit mode. A tool that is placed into edit mode automatically becomes the active tool. The tool remains in edit mode until the control loses focus or edit mode is terminated through code by setting this property to False.

An editor tool that cannot enter edit mode cannot be activated and as such will return false in that case. For an editor tool that can enter edit mode, true is returned.

You can use this property to determine whether the width of the control may be set. If False, the control has a fixed width.

Width may be set through code on the object, which will affect the width of only the single instance of the tool for which it is set. Width may also be set on the object, which will affect the width of all the instances of the tool that occur in the application.

This property takes into account several factors, such as whether the tool is on a vertical toolbar and the size of the control's caption. Derived classes can override this property.

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Note: It is recommended that derived tool types override and InitializeFrom. The InitializeFrom override should call the base implementation of InitializeFrom and copy all members defined on the derived type from the to this tool.

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.

Use this property to determine if an object has been created. Appearance objects in general are not created until the properties associated with them are accessed.

To prevent the user from modifying the contents of the TextEditorToolBase, set this property to True. The text of the tool is still available for other operations (such as copying to the clipboard) when Locked is True. The text of the tool may be modified through code whether this property is set to True or False.

This property returns an integer value that indicates the length of the text selection (in characters). You can also use it to change the length of the selection. Used in combination with you can set the selection to any text that exists in the control.

This property returns an integer value that indicates the position within the TextEditorToolBase's text where the selection begins. Used in combination with you can set the selection to any text that exists in the control.

This property returns only the text that is currently selected in the TextEditorToolBase. You can also use this property to replace selected text with a text string that you specify.

Because there is not enough room to display a text entry area on a vertical toolbar, you have the option of either displaying a button for the TextEditorToolBase when it is on a vertical toolbar, or hiding it altogether. This property specifies which method will be used when the TextEditorToolBase is sited on a vertical toolbar.

This property will always return HAlign.Left, the default value for the TextEditorToolBase.

Because there is not enough room to display a text entry area on a vertical toolbar, you have the option of either displaying a button for the TextEditorToolBase when it is on a vertical toolbar, or hiding it altogether. If the tool is visible on a vertical toolbar as a button, this property will return True. If it is hidden, this property will return False.

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Note: It is recommended that derived tool types override Clone and . The Clone override should create a new instance of the derived tool type and call InitializeFrom on the new tool instance, passing in the current tool and .

Note: It is recommended that derived tool types override and InitializeFrom. The InitializeFrom override should call the base implementation of InitializeFrom and copy all members defined on the derived type from the to this tool.

The PasswordChar property is used when you want the TextBoxTool to obscure the text entered by the end-user. The character specified for this property will be displayed in place of the alphanumeric characters typed by the user. Common password characters are the asterisk ("*") and the bullet symbol ("•", ASCII character 149).

For the TextBoxTool, the EditValue of the tool is identical to the text of the tool as returned by the property.

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke this method to reset the property to its default value.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Note: It is recommended that derived tool types override Clone and . The Clone override should create a new instance of the derived tool type and call InitializeFrom on the new tool instance, passing in the current tool and .

Note: It is recommended that derived tool types override and InitializeFrom. The InitializeFrom override should call the base implementation of InitializeFrom and copy all members defined on the derived type from the to this tool.

When the AutoComplete property is set to true, as characters are typed, the contents of the edit portion is evaluated to determine whether the characters it contains matches the text of any of the items in the dropdown list.

If it does match, the item whose display text it matches becomes the new , and the text in the edit portion is set to that item's display text.

Furthermore, the additional characters that were appended become selected, so that as new characters are typed, the ones added as a result of the item match are removed.

Note: the AutoComplete property is not applicable when the property is DropDownList

This property returns a Drawing.Size object containing the default size for the tool. This property is useful when resetting end-user modifications made to the tool.

When an item is selected from the drop-down portion of the combo, that item's index in the ValueList is assigned to the SelectedIndex property.

When an item is selected from the dropdown list portion of a ComboBox tool, this property will return the ValueListItem object associated with the selected item.

The Value of the control is determined by the item that has been selected from the dropdown list.

The ValueList object is used to store the items that appear in the dropdown portion of the combo. Each ValueList contains a series of that correspond to the individual items on the list.

The ComboBox tool defaults to a dropdown list style.

This property has meaning for only certain tools such as the , , and so on. Tools that do not provide an interface for editing a value will not need to use this property.

This property will return a value based on the setting used for the EditType property of the underlying tool associated with the MDI Placeholder.

This property returns a Drawing.Size object that indicates the minimum possible dimensions of the control. This property takes into account the width of the dropdown arrow (when displayed). Derived classes can override this property.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

Invoke the method to reset this property to its default value.

Resets the property values of the to their default values.

Invoke the method to reset this property to its default value.

Invoke the method to reset this property to its default value.

Invoke the method to reset this property to its default value.

Note: When overriding this method, it is recommended the base implementation is called before the derived implementation returns.

The CaptionAppearance is an that is used to render the caption of the contextual tab group that is displayed within the caption area of the ribbon.

This is a read-only property that returns a boolean indicating if the of the has been created. The appearance is lazily created only when requested to reduce overhead.

Use this property to determine if an object has been created. RibbonGroupSettings objects in general are not created until the properties associated with them are accessed.

Use this property to determine if an object has been created. RibbonTabSettings objects in general are not created until the properties associated with them are accessed.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

When using this Microsoft Office 2007 UI capability, be aware that the NetAdvantage license grants you no rights to the Microsoft Office 2007 UI. For more information, contact officeui@microsoft.com, and see Installing Microsoft Office 2007 UI Capabilities for more information.

If the Control contained by the tool is disposed, the property will automatically be set to null.

Note: By default, only one instance of a ControlContainerTool with a certain Key can exist on the . To allow multiple instances of ControlContainerTools with the same Key to be displayed, set one of their properties to True (setting the property on the of one ControlContainerTool with a Key will change the property on the SharedProps of all ControlContainerTools with the same Key because they have a common SharedProps instance).

Note: The ControlContainerTool cannot be added to the Tools collection of a menu ( and ).

If two tools have the same key, they are considered the same logical tool and have a common instance. However, they will each have their own instance.

Invoke the method to reset this property to its default value.

Invoke this method to reset the to its default value.

Once this method is invoked, the method will return False until the property is set again.

Invoke the method to reset this property to its default value.

Invoke this method to reset the to its default value.

Once this method is invoked, the method will return False until the property is set again.

After the ResetControl method has been invoked, the property of the ControlContainer will return null.

Invoke the method to reset this property to its default value.

Invoke this method to reset the property to its default value.

Once this method is invoked, the method will return False until the property is set again.

Note: It is recommended that derived tool types override Clone and . The Clone override should create a new instance of the derived tool type and call InitializeFrom on the new tool instance, passing in the current tool and .

Return to have the key tip use the entire tool rect to determine its location.

The tool parameter will be either the tool itself or an instance of a that wraps the tool.

Note: It is recommended that derived tool types override and InitializeFrom. The InitializeFrom override should call the base implementation of InitializeFrom and copy all members defined on the derived type from the to this tool.

This applies only to tools that share a contained control, e.g. and .

This method should not be called directly.

Once a tool is activated it becomes the active tool. You can use the property to determine whether a tool is currently the active one.

Once a tool is deactivated it is no longer the active tool. You can use the property to determine whether a tool is currently the active one.

This property specifies whether the control container can be resized horizontally or not. To keep the container at a fixed width, set this to False. To allow the user or the ToolbarManager to resize the container's width, set this property to True.

This property returns a reference to the control inside the ControlContainer. You can use this property to access any of the properties or methods of the control contained by the ControlContainer tool.

Because there is not enough room to display a text entry area on a vertical toolbar, you have the option of either displaying a button for the ControlContainerTool when it is on a vertical toolbar, or hiding it altogether. This property specifies which method will be used when the ControlContainerTool is sited on a vertical toolbar.

Depending on the type of control found in the control container, you may want to specify that only a specific display style is available. If you set this property to False, the user will not be able to change the display style of the control container using the run-time customizer.

You can use this property to determine whether the width of the control may be set. If False, the control has a fixed width.

Width may be set through code on the object, which will affect the width of only the single instance of the tool for which it is set. Width may also be set on the object, which will affect the width of all the instances of the tool that occur in the application.

This property will return False except for tools that contain controls, e.g. and .

This property will return True if the contained control is shared among all instances of a particular ControlContainer tool.

Tools may be displayed on either menus or toolbars. Some tools will change their appearance depending on whether they are on a menu or a toolbar.

This property returns True if the tool will be displayed when located on a menu. If False, the tool will be visible only on toolbars or not at all.

Tools may be displayed on either menus or toolbars. Some tools will change their appearance depending on whether they are on a menu or a toolbar.

This property returns True if the tool will be displayed when located on a toolbar. If False, the tool will be visible only on menus or not at all.

At runtime, s whose property is set to null will return False.

Certain tools (such as the combo box tool) are better suited to appearing in the horizontal layout that is found on a toolbar or menu that is docked at the top or bottom of a form. It is often difficult to display these tools in a vertical toolbar that is docked to the left or right edge of the form. To do so either requires reducing the size of the control enough to impede usability, or increasing the width of the toolbar area enough to interfere with the main body of the application. For this reason, it is easier to simply prevent certain tools from appearing on a vertically-oriented toolbar.

Use this property to determine whether a tool will be visible on a vertically-oriented toolbar. This property returns True if the tool will be visible, False if it will not.

At runtime, s whose property is set to null will return False.

This property returns a Drawing.Size object that indicates the minimum possible dimensions of the control. Minimum sized is based on the several factors, including the orientation of toolbar that holds the tool and the size of the control the tool contains.

Derived classes can override this property.

This will return null except for tools that contain controls, such as the and the .

ExtraSharedProps is an internal mechanism used to support extra properties that may be shared among tools derived from the existing tool classes. The operation of ExtraSharedProps does not change the properties of the SharedProps object. ExtraSharedProps is only useful for developers who are deriving their own tools from this class; its operation is transparent to the developer who is simply using the existing features of the control in their application.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

If is True, both managed and unmanaged resources should be cleaned up, otherwise only unmanaged resources should be cleaned up.

This property returns the borders required to draw the UIElement. Depending on the placement of the menu item and other settings, borders may not be needed on all edges. This property takes into account the style of the toolbar.

The border style returned is determined by the style of the toolbar.

This setting takes effect when an MDI child form is maximized and both the child and MDI parent form have menus.

Note: This enumeration does not affect tools that are placed on a . The contents of a tool on a ribbon group are based upon the and .

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.

Before setting an event to disabled, you should use to check whether the event is currently occurring.

This will be null except when used as a context menu thru the ContextMenuUltra extender property.

This property is read-only.

CancelingEditMode is true when the user has canceled the editing the cell, for example by pressing the Escape key.