Edit

ToolStrip Control Overview (Windows Forms)

  • Article

The Windows Forms ToolStrip control and its associated classes provide a common framework for combining user interface elements into toolbars, status bars, and menus. ToolStrip controls offer a rich design-time experience that includes in-place activation and editing, custom layout, and rafting, which is the ability of toolbars to share horizontal or vertical space.

Although ToolStrip replaces and adds functionality to the control in previous versions, ToolBar is retained for both backward compatibility and future use if desired.

Features of the ToolStrip Controls

Use the ToolStrip control to:

  • Present a common user interface across containers.

  • Create easily customized, commonly employed toolbars that support advanced user interface and layout features, such as docking, rafting, buttons with text and images, drop-down buttons and controls, overflow buttons, and run-time reordering of ToolStrip items.

  • Support overflow and run-time item reordering. The overflow feature moves items to a drop-down menu when there is not enough room to display them in a ToolStrip.

  • Support the typical appearance and behavior of the operating system through a common rendering model.

  • Handle events consistently for all containers and contained items, in the same way you handle events for other controls.

  • Drag items from one ToolStrip to another or within a ToolStrip.

  • Create drop-down controls and user interface type editors with advanced layouts in a ToolStripDropDown.

Use the ToolStripControlHost class to use other controls on a ToolStrip and gain ToolStrip functionality for them.

You can extend the functionality and modify the appearance and behavior by using the ToolStripRenderer, ToolStripProfessionalRenderer, and ToolStripManager along with the ToolStripRenderMode and ToolStripManagerRenderMode enumerations.

The ToolStrip control is highly configurable and extensible, and it provides many properties, methods, and events to customize appearance and behavior. Below are some noteworthy members:

Important ToolStrip Members

Name Description
Dock Gets or sets which edge of the parent container a ToolStrip is docked to.
AllowItemReorder Gets or sets a value indicating whether drag-and-drop and item reordering are handled privately by the ToolStrip class.
LayoutStyle Gets or sets a value indicating how the ToolStrip lays out its items.
Overflow Gets or sets whether a ToolStripItem is attached to the ToolStrip or ToolStripOverflowButton or can float between the two.
IsDropDown Gets a value indicating whether a ToolStripItem displays other items in a drop-down list when the ToolStripItem is clicked.
OverflowButton Gets the ToolStripItem that is the overflow button for a ToolStrip with overflow enabled.
Renderer Gets or sets a ToolStripRenderer used to customize the appearance and behavior (look and feel) of a ToolStrip.
RenderMode Gets or sets the painting styles to be applied to the ToolStrip.
RendererChanged Raised when the Renderer property changes.

The ToolStrip control's flexibility is achieved through the use of a number of companion classes. Below are some of the most noteworthy:

Important ToolStrip Companion Classes

Name Description
MenuStrip Replaces and adds functionality to the MainMenu class.
StatusStrip Replaces and adds functionality to the StatusBar class.
ContextMenuStrip Replaces and adds functionality to the ContextMenu class.
ToolStripItem Abstract base class that manages events and layout for all the elements that a ToolStrip, ToolStripControlHost, or ToolStripDropDown can contain.
ToolStripContainer Provides a container with a panel on each side of the form in which controls can be arranged in various ways.
ToolStripRenderer Handles the painting functionality for ToolStrip objects.
ToolStripProfessionalRenderer Provides Microsoft Office-style appearance.
ToolStripManager Controls ToolStrip rendering and rafting, and the merging of MenuStrip, ToolStripDropDownMenu, and ToolStripMenuItem objects.
ToolStripManagerRenderMode Specifies the painting style (custom, Windows XP, or Microsoft Office Professional) applied to multiple ToolStrip objects contained in a form.
ToolStripRenderMode Specifies the painting style (custom, Windows XP, or Microsoft Office Professional) applied to one ToolStrip object contained in a form.
ToolStripControlHost Hosts other controls that are not specifically ToolStrip controls but for which you want ToolStrip functionality.
ToolStripItemPlacement Specifies whether a ToolStripItem is to be laid out on the main ToolStrip, on the overflow ToolStrip, or neither.

For more information, see ToolStrip Technology Summary and ToolStrip Control Architecture.

See also