Files
docs-desktop/dotnet-desktop-guide/framework/winforms/controls/how-to-set-the-toolstrip-renderer-at-run-time.md
T
Andy De George c0ba284473 Initial winforms content migrated (#18)
* Merge winforms framework content to working branch (#14)

* Breadcrumb / TOC / Move net5 to net folder (#15)

* change path from net5 to net

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Mess with bread/toc

* Add .net 5 winforms placeholder article (#16)

* added some metadata and adjusted net5 placeholder

* corrections

* corrections

* corrections

* Test1

* Swapping landing page vs concept

* fix links

* Fix links

* Fix desc
2020-09-01 16:26:21 -07:00

3.0 KiB

title, ms.date, dev_langs, helpviewer_keywords, ms.assetid
title ms.date dev_langs helpviewer_keywords ms.assetid
How to: Set the ToolStrip Renderer at Run Time 03/30/2017
csharp
vb
toolbars [Windows Forms]
ToolStripManager class [Windows Forms]
ToolStripProfessionalRenderer class [Windows Forms]
ToolStrip control [Windows Forms]
MenuStrip control [Windows Forms]
525e2347-0804-49aa-b9a3-9b2cabbf1c35

How to: Set the ToolStrip Renderer at Run Time

You can customize the appearance of your xref:System.Windows.Forms.ToolStrip control by creating a custom ProfessionalColorTable class.

Example

The following code example demonstrates how to create a custom ProfessionalColorTable class. This class defines gradients for a xref:System.Windows.Forms.MenuStrip and a xref:System.Windows.Forms.ToolStrip control.

To use this code example, compile and run the application, and then click Change Colors to apply the gradients defined in the custom ProfessionalColorTable class.

[!code-csharpSystem.Windows.Forms.ToolStrip.Misc#1] [!code-vbSystem.Windows.Forms.ToolStrip.Misc#1]
[!code-csharpSystem.Windows.Forms.ToolStrip.Misc#20] [!code-vbSystem.Windows.Forms.ToolStrip.Misc#20]

Defining a Custom ProfessionalColorTable class

The custom gradients are defined in the CustomProfessionalColors class.

[!code-csharpSystem.Windows.Forms.ToolStrip.Misc#30] [!code-vbSystem.Windows.Forms.ToolStrip.Misc#30]

Assigning a Custom Renderer

Create a new ToolStripProfessionalRenderer with a CustomProfessionalColors class, and assign it to the xref:System.Windows.Forms.ToolStripManager.Renderer%2A?displayProperty=nameWithType property.

[!code-csharpSystem.Windows.Forms.ToolStrip.Misc#22] [!code-vbSystem.Windows.Forms.ToolStrip.Misc#22]

Compiling the Code

This example requires:

  • References to the System.Design, System.Drawing, and System.Windows.Forms assemblies.

See also