System.Windows.Forms
1.0.5000.0
2.0.0.0
System.Windows.Forms.Control
System.ComponentModel.Designer("System.Windows.Forms.Design.ToolBarDesigner, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner")
System.ComponentModel.DefaultProperty("Buttons")
System.ComponentModel.DefaultEvent("ButtonClick")
System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)
System.Runtime.InteropServices.ComVisible(true)
controls are used to display controls that can appear as a standard button, a toggle-style button, or a drop-down style button. You can assign images to the buttons by creating an , assigning it to the property of the toolbar, and assigning the image index value to the property each . You can then assign text to be displayed underneath or to the right of the image by setting the property of the .
Set the property of the toolbar to to give the toolbar and its buttons a flat appearance. As the mouse pointer moves over the buttons, their appearance changes to three-dimensional. Toolbar buttons can be divided into logical groups by using separators. A separator is a toolbar button with the property set to ToolBarButtonStyle.Separator. Button separators appear as lines rather than spaces between the buttons when the toolbar has a flat appearance. If the property is set to , the toolbar buttons appear raised and three-dimensional.
If you specify a value for the property, all buttons in the tool bar are restricted to the specified size. Otherwise, the buttons adjust their size depending on their content, and the property returns the initial size of the largest button.
To create a collection of controls to display on the , add the buttons individually by using the or methods of the property.
Represents a Windows toolbar. Although replaces and adds functionality to the control of previous versions, is retained for both backward compatibility and future use if you choose.
Constructor
A newly created toolbar control is empty; add controls by setting the property.
Initializes a new instance of the class.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(System.Windows.Forms.ToolBarAppearance.Normal)
System.Windows.Forms.ToolBarAppearance
To be added.
The property affects the appearance of the buttons assigned to the toolbar. When the appearance is set to ToolBarAppearance.Normal, the toolbar's buttons appear three-dimensional and raised. Set the property of the toolbar to ToolBarAppearance.Flat to give the toolbar's buttons a flat appearance. As the mouse pointer moves over the flat buttons, they appear raised and three-dimensional. Separators on a with the property set to appear as etched lines rather than spaces between the raised buttons. The flat style buttons give your application a more Web-like look.
Gets or set the value that determines the appearance of a toolbar control and its buttons.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(true)
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Always)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Visible)
System.ComponentModel.Browsable(true)
System.Boolean
To be added.
When is set to true, the control sizes itself to accommodate the toolbar buttons, based upon the button size, the number of objects it contains, and the of the toolbar.
Gets or sets a value indicating whether the toolbar adjusts its size automatically, based on the size of the buttons and the dock style.
1.0.5000.0
2.0.0.0
Event
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Always)
System.ComponentModel.Browsable(true)
System.EventHandler
For more information about handling events, see Consuming Events.
Occurs when the value of the property has changed.
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Drawing.Color
To be added.
To be added.
Gets or sets the background color.
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Drawing.Image
To be added.
To be added.
Gets or sets the background image.
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
1.0.5000.0
2.0.0.0
Property
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.ImageLayout
To be added.
To be added.
Gets or sets the layout for background image.
Event
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
Property
System.Runtime.InteropServices.DispId(-504)
System.ComponentModel.DefaultValue(System.Windows.Forms.BorderStyle.None)
System.Windows.Forms.BorderStyle
To be added.
The can take on a sunken, three-dimensional appearance when the property is set to BorderStyle.Fixed3D. To display a flat thin border around the toolbar control, set the property to BorderStyle.FixedSingle.
Gets or sets the border style of the toolbar control.
1.0.5000.0
2.0.0.0
Event
System.Windows.Forms.ToolBarButtonClickEventHandler
For more information about handling events, see [<topic://cpconEventsOverview>].
Occurs when a on the is clicked.
1.0.5000.0
2.0.0.0
Event
System.Windows.Forms.ToolBarButtonClickEventHandler
For more information about handling events, see [<topic://cpconEventsOverview>].
Occurs when a drop-down style or its down arrow is clicked.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.MergableProperty(false)
System.ComponentModel.Localizable(true)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Content)
System.Windows.Forms.ToolBar+ToolBarButtonCollection
To be added.
The property is a zero-based indexed collection used to hold all the controls assigned to the toolbar. Because the property is read-only, it can not be assigned a collection of toolbar buttons directly. Toolbar buttons can be added or removed by using the methods inherited from the class. Use the method to add individual buttons and the method to delete a button. Call the method to remove all the buttons from the collection.
Gets the collection of controls assigned to the toolbar control.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.All)
System.ComponentModel.Localizable(true)
System.Drawing.Size
To be added.
If the is not set, it is set to its default. Alternatively, a is computed to accommodate the largest and text assigned to the controls.
Gets or sets the size of the buttons on the toolbar control.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Creates a handle for the control.
1.0.5000.0
2.0.0.0
Property
System.Windows.Forms.CreateParams
To be added.
To be added.
Gets the required creation parameters when the control handle is created.
1.0.5000.0
2.0.0.0
Property
System.Windows.Forms.ImeMode
To be added.
As implemented in the class, this property always returns the value.
Gets the default Input Method Editor (IME) mode supported by this control.
1.0.5000.0
2.0.0.0
Property
System.Drawing.Size
To be added.
To be added.
Gets the default size of the control.
1.0.5000.0
2.0.0.0
Method
System.Void
This method is called by the public Dispose method and the method. Dispose invokes the protected Dispose(Boolean) method with the parameter set to true. invokes Dispose with set to false.
When the parameter is true, this method releases all resources held by any managed objects that this references. This method invokes the Dispose method of each referenced object.
Releases the unmanaged resources used by the and optionally releases the managed resources.
true to release both managed and unmanaged resources; false to release only unmanaged resources.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DefaultValue(true)
System.Boolean
To be added.
Dividers are displayed to help distinguish the toolbar from adjacent controls, such as menus. A divider is displayed as a raised edge along the top of the control.
Gets or sets a value indicating whether the toolbar displays a divider.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(System.Windows.Forms.DockStyle.Top)
System.Windows.Forms.DockStyle
To be added.
To be added.
Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.
1.0.5000.0
2.0.0.0
Property
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.Boolean
To be added.
To be added.
This member is not meaningful for this control.
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(false)
System.Boolean
To be added.
When is set to false, no down arrows display on drop-down style toolbar buttons. When the user clicks the drop-down button on the toolbar, the menu drops down for selection. When the drop-down arrow is displayed, the user must press the down arrow to display the menu.
Gets or sets a value indicating whether drop-down buttons on a toolbar display down arrows.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Drawing.Color
To be added.
To be added.
Gets or sets the forecolor .
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DefaultValue(null)
System.Windows.Forms.ImageList
To be added.
If you create an and assign it to the property, you can assign an image from the collection to the controls by assigning the image's index value to the property of the toolbar button.
Gets or sets the collection of images available to the toolbar button controls.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Advanced)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Drawing.Size
To be added.
To be added.
Gets the size of the images in the image list assigned to the toolbar.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.ImeMode
To be added.
To be added.
This member is not meaningful for this control.
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see [<topic://cpconProvidingEventFunctionality>].
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see [<topic://cpconProvidingEventFunctionality>].
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
The method resizes the toolbar buttons to fit the size of the new font.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.PaintEventHandler
To be added.
This member is not meaningful for this control.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.RightToLeft
To be added.
To be added.
This member is not meaningful for this control.
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
1.0.5000.0
2.0.0.0
Method
2.0.0.0
System.Void
To be added.
Scales a control's location, size, padding and margin.
The factor by which the height and width of the control will be scaled.
A value that specifies the bounds of the control to use when defining its size and position.
Method
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.Void
To be added.
This method is not relevant for this class.
The horizontal scaling factor.
The vertical scaling factor.
Method
System.Void
The method ignores width if the property is set to or and the property is set to true. ignores height if the property is set to or and the property is set to true.
Sets the specified bounds of the control.
The new Left property value of the control.
The new Top property value of the control.
The new Width property value of the control.
Not used.
A bitwise combination of the values.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(false)
System.Boolean
To be added.
To set the text displayed by the ToolTip, set the property of each on the . To cause the ToolTip to display as the user moves the mouse pointer over the toolbar button, set the property to true.
Gets or sets a value indicating whether the toolbar displays a ToolTip for each button.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DefaultValue(false)
System.Boolean
To be added.
To be added.
This property is not meaningful for this control.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.ComponentModel.Bindable(false)
System.String
To be added.
To be added.
Gets or sets the text for the toolbar.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(System.Windows.Forms.ToolBarTextAlign.Underneath)
System.Windows.Forms.ToolBarTextAlign
To be added.
The can be aligned underneath or to the right of the image displayed on the controls.
Gets or sets the alignment of text in relation to each image displayed on the toolbar button controls.
1.0.5000.0
2.0.0.0
Event
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.EventHandler
The property is not meaningful for this control, although you can change its value and handle the event to detect the change.
Occurs when the property changes.
1.0.5000.0
2.0.0.0
Method
System.String
The method returns a string that includes the type, the value of the property in the , and the string returned by the method of the toolbar’s first button.
Returns a string that represents the control.
A String that represents the current .
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.Localizable(true)
System.ComponentModel.DefaultValue(true)
System.Boolean
To be added.
Toolbar buttons can be divided into logical groups by using separators. A separator is a toolbar button with the property set to ToolBarButtonStyle.Separator. If the property is set to true and the toolbar becomes too small to display all the buttons on the same line, the toolbar is broken into additional lines, with the breaks occurring at the separators. This ensures that button groups stay together. Toolbar buttons that are not in a group can be separated when the toolbar wraps. The toolbar can become too small to display all its buttons on the same line if its parent is resized.
Gets or sets a value indicating whether the toolbar buttons wrap to the next line if the toolbar becomes too small to display all the buttons on the same line.
1.0.5000.0
2.0.0.0