ToolStripRenderer Class

 

Handles the painting functionality for ToolStrip objects.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)


public ref class ToolStripRenderer abstract 

NameDescription
System_CAPS_protmethodToolStripRenderer()

Initializes a new instance of the ToolStripRenderer class.

NameDescription
System_CAPS_pubmethodSystem_CAPS_staticCreateDisabledImage(Image^)

Creates a gray-scale copy of a given image.

System_CAPS_pubmethodDrawArrow(ToolStripArrowRenderEventArgs^)

Draws an arrow on a ToolStripItem.

System_CAPS_pubmethodDrawButtonBackground(ToolStripItemRenderEventArgs^)

Draws the background for a ToolStripButton.

System_CAPS_pubmethodDrawDropDownButtonBackground(ToolStripItemRenderEventArgs^)

Draws the background for a ToolStripDropDownButton.

System_CAPS_pubmethodDrawGrip(ToolStripGripRenderEventArgs^)

Draws a move handle on a ToolStrip.

System_CAPS_pubmethodDrawImageMargin(ToolStripRenderEventArgs^)

Draws the space around an image on a ToolStrip.

System_CAPS_pubmethodDrawItemBackground(ToolStripItemRenderEventArgs^)

Draws the background for a ToolStripItem.

System_CAPS_pubmethodDrawItemCheck(ToolStripItemImageRenderEventArgs^)

Draws an image on a ToolStripItem that indicates the item is in a selected state.

System_CAPS_pubmethodDrawItemImage(ToolStripItemImageRenderEventArgs^)

Draws an image on a ToolStripItem.

System_CAPS_pubmethodDrawItemText(ToolStripItemTextRenderEventArgs^)

Draws text on a ToolStripItem.

System_CAPS_pubmethodDrawLabelBackground(ToolStripItemRenderEventArgs^)

Draws the background for a ToolStripLabel.

System_CAPS_pubmethodDrawMenuItemBackground(ToolStripItemRenderEventArgs^)

Draws the background for a ToolStripMenuItem.

System_CAPS_pubmethodDrawOverflowButtonBackground(ToolStripItemRenderEventArgs^)

Draws the background for an overflow button.

System_CAPS_pubmethodDrawSeparator(ToolStripSeparatorRenderEventArgs^)
System_CAPS_pubmethodDrawSplitButton(ToolStripItemRenderEventArgs^)
System_CAPS_pubmethodDrawStatusStripSizingGrip(ToolStripRenderEventArgs^)

Draws a sizing grip.

System_CAPS_pubmethodDrawToolStripBackground(ToolStripRenderEventArgs^)

Draws the background for a ToolStrip.

System_CAPS_pubmethodDrawToolStripBorder(ToolStripRenderEventArgs^)

Draws the border for a ToolStrip.

System_CAPS_pubmethodDrawToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs^)

Draws the background of the ToolStripContentPanel.

System_CAPS_pubmethodDrawToolStripPanelBackground(ToolStripPanelRenderEventArgs^)

Draws the background of the ToolStripPanel.

System_CAPS_pubmethodDrawToolStripStatusLabelBackground(ToolStripItemRenderEventArgs^)

Draws the background of the ToolStripStatusLabel.

System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodInitialize(ToolStrip^)

When overridden in a derived class, provides for custom initialization of the given ToolStrip.

System_CAPS_protmethodInitializeContentPanel(ToolStripContentPanel^)

Initializes the specified ToolStripContentPanel.

System_CAPS_protmethodInitializeItem(ToolStripItem^)

When overridden in a derived class, provides for custom initialization of the given ToolStripItem.

System_CAPS_protmethodInitializePanel(ToolStripPanel^)

Initializes the specified ToolStripPanel.

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodOnRenderArrow(ToolStripArrowRenderEventArgs^)

Raises the RenderArrow event.

System_CAPS_protmethodOnRenderButtonBackground(ToolStripItemRenderEventArgs^)

Raises the RenderButtonBackground event.

System_CAPS_protmethodOnRenderDropDownButtonBackground(ToolStripItemRenderEventArgs^)
System_CAPS_protmethodOnRenderGrip(ToolStripGripRenderEventArgs^)

Raises the RenderGrip event.

System_CAPS_protmethodOnRenderImageMargin(ToolStripRenderEventArgs^)

Draws the item background.

System_CAPS_protmethodOnRenderItemBackground(ToolStripItemRenderEventArgs^)

Raises the OnRenderItemBackground event.

System_CAPS_protmethodOnRenderItemCheck(ToolStripItemImageRenderEventArgs^)

Raises the RenderItemCheck event.

System_CAPS_protmethodOnRenderItemImage(ToolStripItemImageRenderEventArgs^)

Raises the RenderItemImage event.

System_CAPS_protmethodOnRenderItemText(ToolStripItemTextRenderEventArgs^)

Raises the RenderItemText event.

System_CAPS_protmethodOnRenderLabelBackground(ToolStripItemRenderEventArgs^)

Raises the RenderLabelBackground event.

System_CAPS_protmethodOnRenderMenuItemBackground(ToolStripItemRenderEventArgs^)

Raises the RenderMenuItemBackground event.

System_CAPS_protmethodOnRenderOverflowButtonBackground(ToolStripItemRenderEventArgs^)
System_CAPS_protmethodOnRenderSeparator(ToolStripSeparatorRenderEventArgs^)

Raises the RenderSeparator event.

System_CAPS_protmethodOnRenderSplitButtonBackground(ToolStripItemRenderEventArgs^)
System_CAPS_protmethodOnRenderStatusStripSizingGrip(ToolStripRenderEventArgs^)

Raises the RenderStatusStripSizingGrip event.

System_CAPS_protmethodOnRenderToolStripBackground(ToolStripRenderEventArgs^)

Raises the RenderToolStripBackground event.

System_CAPS_protmethodOnRenderToolStripBorder(ToolStripRenderEventArgs^)

Raises the RenderToolStripBorder event.

System_CAPS_protmethodOnRenderToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs^)
System_CAPS_protmethodOnRenderToolStripPanelBackground(ToolStripPanelRenderEventArgs^)
System_CAPS_protmethodOnRenderToolStripStatusLabelBackground(ToolStripItemRenderEventArgs^)
System_CAPS_protmethodSystem_CAPS_staticScaleArrowOffsetsIfNeeded()

This API supports the product infrastructure and is not intended to be used directly from your code. Applies the F:System.Windows.Forms.ToolStripRenderer.Offset2X and F:System.Windows.Forms.ToolStripRenderer.Offset2Y specified to scaling the arrow icon, if scaling is required per the DPI settings of the computer.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_protfieldSystem_CAPS_staticOffset2X

This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the offset multiplier for twice the offset along the x-axis.

System_CAPS_protfieldSystem_CAPS_staticOffset2Y

This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the offset multiplier for twice the offset along the y axis.

NameDescription
System_CAPS_pubeventRenderArrow

Occurs when an arrow on a ToolStripItem is rendered.

System_CAPS_pubeventRenderButtonBackground

Occurs when the background for a ToolStripButton is rendered

System_CAPS_pubeventRenderDropDownButtonBackground

Occurs when the background for a ToolStripDropDownButton is rendered.

System_CAPS_pubeventRenderGrip

Occurs when the move handle for a ToolStrip is rendered.

System_CAPS_pubeventRenderImageMargin

Draws the margin between an image and its container.

System_CAPS_pubeventRenderItemBackground

Occurs when the background for a ToolStripItem is rendered.

System_CAPS_pubeventRenderItemCheck

Occurs when the image for a selected ToolStripItem is rendered.

System_CAPS_pubeventRenderItemImage

Occurs when the image for a ToolStripItem is rendered.

System_CAPS_pubeventRenderItemText

Occurs when the text for a ToolStripItem is rendered.

System_CAPS_pubeventRenderLabelBackground

Occurs when the background for a ToolStripLabel is rendered.

System_CAPS_pubeventRenderMenuItemBackground

Occurs when the background for a ToolStripMenuItem is rendered.

System_CAPS_pubeventRenderOverflowButtonBackground

Occurs when the background for an overflow button is rendered.

System_CAPS_pubeventRenderSeparator

Occurs when a ToolStripSeparator is rendered.

System_CAPS_pubeventRenderSplitButtonBackground

Occurs when the background for a ToolStripSplitButton is rendered.

System_CAPS_pubeventRenderStatusStripSizingGrip

Occurs when the display style changes.

System_CAPS_pubeventRenderToolStripBackground

Occurs when the background for a ToolStrip is rendered.

System_CAPS_pubeventRenderToolStripBorder

Occurs when the border for a ToolStrip is rendered.

System_CAPS_pubeventRenderToolStripContentPanelBackground

Draws the background of a ToolStripContentPanel.

System_CAPS_pubeventRenderToolStripPanelBackground

Draws the background of a ToolStripPanel.

System_CAPS_pubeventRenderToolStripStatusLabelBackground

Draws the background of a ToolStripStatusLabel.

Use the ToolStripRenderer class to apply a particular style or theme to a ToolStrip. Rather than custom painting a ToolStrip and the ToolStripItem objects it contains, you set the ToolStrip::Renderer property to an object that inherits from ToolStripRenderer. The painting specified by the ToolStripRenderer is applied to the ToolStrip, as well as the items it contains.

You can do custom painting in ToolStrip controls in several ways. As with other Windows Forms controls, the ToolStrip and ToolStripItem both have overridable OnPaint methods and Paint events. As with regular painting, the coordinate system is relative to the client area of the control; that is, the upper left-hand corner of the control is 0, 0. The Paint event and OnPaint method for a ToolStripItem behave like other control paint events.

The ToolStripRenderer class has overridable methods for painting the background, item background, item image, item arrow, item text, and border of the ToolStrip. The event arguments for these methods expose several properties such as rectangles, colors, and text formats that you can adjust as desired.

To adjust just a few aspects of how an item is painted, you typically override the ToolStripRenderer.

If you are writing a new item and want to control all aspects of the painting, override the OnPaint method. From within OnPaint, you can use methods from the ToolStripRenderer.

By default, the ToolStrip is double buffered, taking advantage of the OptimizedDoubleBuffer setting.

The following code example demonstrates how to implement a custom ToolStripRenderer class. The GridStripRenderer class customizes three aspects of the GridStrip control's appearance: GridStrip border, ToolStripButton border, and ToolStripButton image. For a full code listing, see How to: Implement a Custom ToolStripRenderer.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: