Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

ToolStripManager.RenderMode Property

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
ToolStripManager.cs
Source:
ToolStripManager.cs
Source:
ToolStripManager.cs
Source:
ToolStripManager.cs
Source:
ToolStripManager.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the default theme for the form.

public:
 static property System::Windows::Forms::ToolStripManagerRenderMode RenderMode { System::Windows::Forms::ToolStripManagerRenderMode get(); void set(System::Windows::Forms::ToolStripManagerRenderMode value); };
public static System.Windows.Forms.ToolStripManagerRenderMode RenderMode { get; set; }
static member RenderMode : System.Windows.Forms.ToolStripManagerRenderMode with get, set
Public Shared Property RenderMode As ToolStripManagerRenderMode

Property Value

One of the ToolStripManagerRenderMode values.

Exceptions

The set value was not one of the ToolStripManagerRenderMode values.

ToolStripManagerRenderMode is set to Custom; use the Renderer property instead.

Examples

The following code example demonstrates a use of the RenderMode property. This example is part of a larger example provided for the Renderer property.

// This event handler is invoked when 
// the "Apply Renderers" button is clicked.
// Depending on the value selected in a ComboBox control,
// it applies a custom renderer selectively to
// individual MenuStrip or ToolStrip controls,
// or it applies a custom renderer to the 
// application as a whole.
void applyButton_Click(object sender, EventArgs e)
{
 ToolStrip ms = ToolStripManager.FindToolStrip("MenuStrip");
 ToolStrip ts = ToolStripManager.FindToolStrip("ToolStrip");

 if (targetComboBox.SelectedItem != null)
 {
 switch (targetComboBox.SelectedItem.ToString())
 {
 case "Reset":
 {
 ms.RenderMode = ToolStripRenderMode.ManagerRenderMode;
 ts.RenderMode = ToolStripRenderMode.ManagerRenderMode;

 // Set the default RenderMode to Professional.
 ToolStripManager.RenderMode = ToolStripManagerRenderMode.Professional;

 break;
 }

 case "All":
 {
 ms.RenderMode = ToolStripRenderMode.ManagerRenderMode;
 ts.RenderMode = ToolStripRenderMode.ManagerRenderMode;

 // Assign the custom renderer at the application level.
 ToolStripManager.Renderer = new CustomProfessionalRenderer();

 break;
 }

 case "MenuStrip":
 {
 // Assign the custom renderer to the MenuStrip control only.
 ms.Renderer = new CustomProfessionalRenderer();

 break;
 }

 case "ToolStrip":
 {
 // Assign the custom renderer to the ToolStrip control only.
 ts.Renderer = new CustomProfessionalRenderer();

 break;
 }
 }
 }
}
' This event handler is invoked when 
' the "Apply Renderers" button is clicked.
' Depending on the value selected in a ComboBox 
' control, it applies a custom renderer selectively
' to individual MenuStrip or ToolStrip controls,
' or it applies a custom renderer to the 
' application as a whole.
Sub applyButton_Click(ByVal sender As Object, ByVal e As EventArgs)
 Dim ms As ToolStrip = ToolStripManager.FindToolStrip("MenuStrip")
 Dim ts As ToolStrip = ToolStripManager.FindToolStrip("ToolStrip")

 If targetComboBox.SelectedItem IsNot Nothing Then

 Select Case targetComboBox.SelectedItem.ToString()
 Case "Reset"
 ms.RenderMode = ToolStripRenderMode.ManagerRenderMode
 ts.RenderMode = ToolStripRenderMode.ManagerRenderMode

 ' Set the default RenderMode to Professional.
 ToolStripManager.RenderMode = ToolStripManagerRenderMode.Professional

 Exit Select

 Case "All"
 ms.RenderMode = ToolStripRenderMode.ManagerRenderMode
 ts.RenderMode = ToolStripRenderMode.ManagerRenderMode

 ' Assign the custom renderer at the application level.
 ToolStripManager.Renderer = New CustomProfessionalRenderer()

 Exit Select

 Case "MenuStrip"
 ' Assign the custom renderer to the MenuStrip control only.
 ms.Renderer = New CustomProfessionalRenderer()

 Exit Select

 Case "ToolStrip"
 ' Assign the custom renderer to the ToolStrip control only.
 ts.Renderer = New CustomProfessionalRenderer()

 Exit Select
 End Select

 End If
End Sub

Remarks

Use the RenderMode property to get or set whether the application is painted by the ToolStripProfessionalRenderer, the ToolStripSystemRenderer, or a customized ToolStripRenderer.

Applies to


Feedback

Was this page helpful?