Freigeben über


ToolStripRenderer Klasse

Definition

Behandelt die Zeichenfunktionen für ToolStrip-Objekte.

public ref class ToolStripRenderer abstract
public abstract class ToolStripRenderer
type ToolStripRenderer = class
Public MustInherit Class ToolStripRenderer
Vererbung
ToolStripRenderer
Abgeleitet

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine benutzerdefinierte ToolStripRenderer-Klasse implementiert wird. Die GridStripRenderer -Klasse passt drei Aspekte der Darstellung des GridStrip Steuerelements an: GridStrip Rahmen, ToolStripButton Rahmen und ToolStripButton Bild. Eine vollständige Codeauflistung finden Sie unter Vorgehensweise: Implementieren eines benutzerdefinierten ToolStripRenderers.

// This class implements a custom ToolStripRenderer for the 
// GridStrip control. It customizes three aspects of the 
// GridStrip control's appearance: GridStrip border, 
// ToolStripButton border, and ToolStripButton image.
internal class GridStripRenderer : ToolStripRenderer
{   
    // The style of the empty cell's text.
    private static StringFormat style = new StringFormat();

    // The thickness (width or height) of a 
    // ToolStripButton control's border.
    static int borderThickness = 2;

    // The main bitmap that is the source for the 
    // subimagesthat are assigned to individual 
    // ToolStripButton controls.
    private Bitmap bmp = null;

    // The brush that paints the background of 
    // the GridStrip control.
    private Brush backgroundBrush = null;

    // This is the static constructor. It initializes the
    // StringFormat for drawing the text in the empty cell.
    static GridStripRenderer()
    {
        style.Alignment = StringAlignment.Center;
        style.LineAlignment = StringAlignment.Center;
    }

    // This method initializes the GridStripRenderer by
    // creating the image that is used as the source for
    // the individual button images.
    protected override void Initialize(ToolStrip ts)
    {
        base.Initialize(ts);

        this.InitializeBitmap(ts);
    }

    // This method initializes an individual ToolStripButton
    // control. It copies a subimage from the GridStripRenderer's
    // main image, according to the position and size of 
    // the ToolStripButton.
    protected override void InitializeItem(ToolStripItem item)
    {
        base.InitializeItem(item);

        GridStrip gs = item.Owner as GridStrip;

        // The empty cell does not receive a subimage.
        if ((item is ToolStripButton) &&
            (item != gs.EmptyCell))
        {
            // Copy the subimage from the appropriate 
            // part of the main image.
            Bitmap subImage = bmp.Clone(
                item.Bounds,
                PixelFormat.Undefined);

            // Assign the subimage to the ToolStripButton
            // control's Image property.
            item.Image = subImage;
        }
    }

    // This utility method creates the main image that
    // is the source for the subimages of the individual 
    // ToolStripButton controls.
    private void InitializeBitmap(ToolStrip toolStrip)
    {
        // Create the main bitmap, into which the image is drawn.
        this.bmp = new Bitmap(
            toolStrip.Size.Width,
            toolStrip.Size.Height);

        // Draw a fancy pattern. This could be any image or drawing.
        using (Graphics g = Graphics.FromImage(bmp))
        {
            // Draw smoothed lines.
            g.SmoothingMode = SmoothingMode.AntiAlias;
            
            // Draw the image. In this case, it is 
            // a number of concentric ellipses. 
            for (int i = 0; i < toolStrip.Size.Width; i += 8)
            {
                g.DrawEllipse(Pens.Blue, 0, 0, i, i);
            }
        }
    }

    // This method draws a border around the GridStrip control.
    protected override void OnRenderToolStripBorder(
        ToolStripRenderEventArgs e)
    {
        base.OnRenderToolStripBorder(e);

        ControlPaint.DrawFocusRectangle(
            e.Graphics,
            e.AffectedBounds,
            SystemColors.ControlDarkDark,
            SystemColors.ControlDarkDark);
    }

    // This method renders the GridStrip control's background.
    protected override void OnRenderToolStripBackground(
        ToolStripRenderEventArgs e)
    {
        base.OnRenderToolStripBackground(e);

        // This late initialization is a workaround. The gradient
        // depends on the bounds of the GridStrip control. The bounds 
        // are dependent on the layout engine, which hasn't fully
        // performed layout by the time the Initialize method runs.
        if (this.backgroundBrush == null)
        {
            this.backgroundBrush = new LinearGradientBrush(
               e.ToolStrip.ClientRectangle,
               SystemColors.ControlLightLight,
               SystemColors.ControlDark,
               90,
               true);
        }

        // Paint the GridStrip control's background.
        e.Graphics.FillRectangle(
            this.backgroundBrush, 
            e.AffectedBounds);
    }

    // This method draws a border around the button's image. If the background
    // to be rendered belongs to the empty cell, a string is drawn. Otherwise,
    // a border is drawn at the edges of the button.
    protected override void OnRenderButtonBackground(
        ToolStripItemRenderEventArgs e)
    {
        base.OnRenderButtonBackground(e);

        // Define some local variables for convenience.
        Graphics g = e.Graphics;
        GridStrip gs = e.ToolStrip as GridStrip;
        ToolStripButton gsb = e.Item as ToolStripButton;

        // Calculate the rectangle around which the border is painted.
        Rectangle imageRectangle = new Rectangle(
            borderThickness, 
            borderThickness, 
            e.Item.Width - 2 * borderThickness, 
            e.Item.Height - 2 * borderThickness);

        // If rendering the empty cell background, draw an 
        // explanatory string, centered in the ToolStripButton.
        if (gsb == gs.EmptyCell)
        {
            e.Graphics.DrawString(
                "Drag to here",
                gsb.Font, 
                SystemBrushes.ControlDarkDark,
                imageRectangle, style);
        }
        else
        {
            // If the button can be a drag source, paint its border red.
            // otherwise, paint its border a dark color.
            Brush b = gs.IsValidDragSource(gsb) ? b = 
                Brushes.Red : SystemBrushes.ControlDarkDark;

            // Draw the top segment of the border.
            Rectangle borderSegment = new Rectangle(
                0, 
                0, 
                e.Item.Width, 
                imageRectangle.Top);
            g.FillRectangle(b, borderSegment);

            // Draw the right segment.
            borderSegment = new Rectangle(
                imageRectangle.Right,
                0,
                e.Item.Bounds.Right - imageRectangle.Right,
                imageRectangle.Bottom);
            g.FillRectangle(b, borderSegment);

            // Draw the left segment.
            borderSegment = new Rectangle(
                0,
                0,
                imageRectangle.Left,
                e.Item.Height);
            g.FillRectangle(b, borderSegment);

            // Draw the bottom segment.
            borderSegment = new Rectangle(
                0,
                imageRectangle.Bottom,
                e.Item.Width,
                e.Item.Bounds.Bottom - imageRectangle.Bottom);
            g.FillRectangle(b, borderSegment);
        }
    }
}
' This class implements a custom ToolStripRenderer for the 
' GridStrip control. It customizes three aspects of the 
' GridStrip control's appearance: GridStrip border, 
' ToolStripButton border, and ToolStripButton image.
Friend Class GridStripRenderer
     Inherits ToolStripRenderer

   ' The style of the empty cell's text.
   Private Shared style As New StringFormat()
   
   ' The thickness (width or height) of a 
   ' ToolStripButton control's border.
   Private Shared borderThickness As Integer = 2
   
   ' The main bitmap that is the source for the 
   ' subimagesthat are assigned to individual 
   ' ToolStripButton controls.
   Private bmp As Bitmap = Nothing
   
   ' The brush that paints the background of 
   ' the GridStrip control.
   Private backgroundBrush As Brush = Nothing
   
   
   ' This is the static constructor. It initializes the
   ' StringFormat for drawing the text in the empty cell.
   Shared Sub New()
      style.Alignment = StringAlignment.Center
      style.LineAlignment = StringAlignment.Center
   End Sub 
   
   ' This method initializes the GridStripRenderer by
   ' creating the image that is used as the source for
   ' the individual button images.
   Protected Overrides Sub Initialize(ts As ToolStrip)
      MyBase.Initialize(ts)
      
      Me.InitializeBitmap(ts)
     End Sub

   ' This method initializes an individual ToolStripButton
   ' control. It copies a subimage from the GridStripRenderer's
   ' main image, according to the position and size of 
   ' the ToolStripButton.
   Protected Overrides Sub InitializeItem(item As ToolStripItem)
      MyBase.InitializeItem(item)
      
         Dim gs As GridStrip = item.Owner
      
      ' The empty cell does not receive a subimage.
         If ((TypeOf (item) Is ToolStripButton) And _
              (item IsNot gs.EmptyCell)) Then
             ' Copy the subimage from the appropriate 
             ' part of the main image.
             Dim subImage As Bitmap = bmp.Clone(item.Bounds, PixelFormat.Undefined)

             ' Assign the subimage to the ToolStripButton
             ' control's Image property.
             item.Image = subImage
         End If
   End Sub 

   ' This utility method creates the main image that
   ' is the source for the subimages of the individual 
   ' ToolStripButton controls.
   Private Sub InitializeBitmap(toolStrip As ToolStrip)
      ' Create the main bitmap, into which the image is drawn.
      Me.bmp = New Bitmap(toolStrip.Size.Width, toolStrip.Size.Height)
      
      ' Draw a fancy pattern. This could be any image or drawing.
      Dim g As Graphics = Graphics.FromImage(bmp)
      Try
         ' Draw smoothed lines.
         g.SmoothingMode = SmoothingMode.AntiAlias
         
         ' Draw the image. In this case, it is 
         ' a number of concentric ellipses. 
         Dim i As Integer
         For i = 0 To toolStrip.Size.Width - 8 Step 8
            g.DrawEllipse(Pens.Blue, 0, 0, i, i)
         Next i
      Finally
         g.Dispose()
      End Try
   End Sub 
   
   ' This method draws a border around the GridStrip control.
   Protected Overrides Sub OnRenderToolStripBorder(e As ToolStripRenderEventArgs)
      MyBase.OnRenderToolStripBorder(e)
      
      ControlPaint.DrawFocusRectangle(e.Graphics, e.AffectedBounds, SystemColors.ControlDarkDark, SystemColors.ControlDarkDark)
   End Sub 

   ' This method renders the GridStrip control's background.
   Protected Overrides Sub OnRenderToolStripBackground(e As ToolStripRenderEventArgs)
      MyBase.OnRenderToolStripBackground(e)
      
      ' This late initialization is a workaround. The gradient
      ' depends on the bounds of the GridStrip control. The bounds 
      ' are dependent on the layout engine, which hasn't fully
      ' performed layout by the time the Initialize method runs.
      If Me.backgroundBrush Is Nothing Then
         Me.backgroundBrush = New LinearGradientBrush(e.ToolStrip.ClientRectangle, SystemColors.ControlLightLight, SystemColors.ControlDark, 90, True)
      End If
      
      ' Paint the GridStrip control's background.
      e.Graphics.FillRectangle(Me.backgroundBrush, e.AffectedBounds)
     End Sub

   ' This method draws a border around the button's image. If the background
   ' to be rendered belongs to the empty cell, a string is drawn. Otherwise,
   ' a border is drawn at the edges of the button.
   Protected Overrides Sub OnRenderButtonBackground(e As ToolStripItemRenderEventArgs)
      MyBase.OnRenderButtonBackground(e)
      
      ' Define some local variables for convenience.
      Dim g As Graphics = e.Graphics
      Dim gs As GridStrip = e.ToolStrip 
      Dim gsb As ToolStripButton = e.Item 
      
      ' Calculate the rectangle around which the border is painted.
      Dim imageRectangle As New Rectangle(borderThickness, borderThickness, e.Item.Width - 2 * borderThickness, e.Item.Height - 2 * borderThickness)
      
      ' If rendering the empty cell background, draw an 
      ' explanatory string, centered in the ToolStripButton.
         If gsb Is gs.EmptyCell Then
             e.Graphics.DrawString("Drag to here", gsb.Font, SystemBrushes.ControlDarkDark, imageRectangle, style)
         Else
             ' If the button can be a drag source, paint its border red.
             ' otherwise, paint its border a dark color.
             Dim b As Brush = IIf(gs.IsValidDragSource(gsb), Brushes.Red, SystemBrushes.ControlDarkDark)

             ' Draw the top segment of the border.
             Dim borderSegment As New Rectangle(0, 0, e.Item.Width, imageRectangle.Top)
             g.FillRectangle(b, borderSegment)

             ' Draw the right segment.
             borderSegment = New Rectangle(imageRectangle.Right, 0, e.Item.Bounds.Right - imageRectangle.Right, imageRectangle.Bottom)
             g.FillRectangle(b, borderSegment)

             ' Draw the left segment.
             borderSegment = New Rectangle(0, 0, imageRectangle.Left, e.Item.Height)
             g.FillRectangle(b, borderSegment)

             ' Draw the bottom segment.
             borderSegment = New Rectangle(0, imageRectangle.Bottom, e.Item.Width, e.Item.Bounds.Bottom - imageRectangle.Bottom)
             g.FillRectangle(b, borderSegment)
         End If
     End Sub
 End Class

Hinweise

Verwenden Sie die ToolStripRenderer -Klasse, um einen bestimmten Stil oder ein bestimmtes Design auf anzuwenden ToolStrip. Anstatt eine ToolStrip und die ToolStripItem darin enthaltenen Objekte benutzerdefinierte zu zeichnen, legen Sie die ToolStrip.Renderer -Eigenschaft auf ein -Objekt fest, das von ToolStripRenderererbt. Die von ToolStripRenderer angegebene Zeichnung wird auf die ToolStripangewendet, sowie auf die darin enthaltenen Elemente.

Sie können auf verschiedene Weise in ToolStrip-Steuerelementen zeichnen. Wie bei anderen Windows Forms-Steuerelementen besitzen auch ToolStrip und ToolStripItem überschreibbare OnPaint-Methoden und Paint-Ereignisse. Wie beim normalen Zeichnen ist das Koordinatensystem relativ zum Clientbereich des Steuerelements, d. h. die linke obere Ecke des Steuerelements ist 0, 0. Das Paint-Ereignis und die OnPaint-Methode für ein ToolStripItem verhalten sich wie andere Ereignisse zum Zeichnen von Steuerelementen.

Die ToolStripRenderer -Klasse verfügt über überschreibbare Methoden zum Zeichnen des Hintergrunds, des Elementhintergrunds, des Elementbilds, des Elementpfeils, des Elementtexts und des ToolStripRahmens von . Die Ereignisargumente für diese Methoden zeigen verschiedene Eigenschaften wie Rechtecke, Farben und Textformate an, die Sie nach Belieben anpassen können.

Wenn Sie nur einige Aspekte anpassen möchten, wie ein Element gezeichnet wird, setzen Sie in der Regel die Option ToolStripRenderer außer Kraft.

Wenn Sie ein neues Element erstellen und alle Aspekte des Bilds steuern möchten, setzen Sie die Methode OnPaint außer Kraft. Sie können aus OnPaint heraus Methoden von ToolStripRenderer verwenden.

Standardmäßig wird ToolStrip doppelt gepuffert und nutzt die Einstellung OptimizedDoubleBuffer.

Konstruktoren

ToolStripRenderer()

Initialisiert eine neue Instanz der ToolStripRenderer-Klasse.

Felder

Offset2X

Ruft den Offset-Multiplikator für den doppelten Offset entlang der x-Achse ab oder legt diesen fest.

Offset2Y

Ruft den Offset-Multiplikator für den doppelten Offset entlang der y-Achse ab oder legt diesen fest.

Methoden

CreateDisabledImage(Image)

Erstellt eine Kopie eines angegebenen Bilds in Graustufen.

DrawArrow(ToolStripArrowRenderEventArgs)

Zeichnet einen Pfeil auf einem ToolStripItem.

DrawButtonBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund für einen ToolStripButton.

DrawDropDownButtonBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund für einen ToolStripDropDownButton.

DrawGrip(ToolStripGripRenderEventArgs)

Zeichnet einen Verschiebepunkt auf einem ToolStrip.

DrawImageMargin(ToolStripRenderEventArgs)

Zeichnet den Leerraum um ein Bild auf einem ToolStrip.

DrawItemBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund für einen ToolStripItem.

DrawItemCheck(ToolStripItemImageRenderEventArgs)

Zeichnet ein Bild auf einem ToolStripItem, das angibt, dass sich das Element im ausgewählten Zustand befindet.

DrawItemImage(ToolStripItemImageRenderEventArgs)

Zeichnet ein Bild auf einem ToolStripItem.

DrawItemText(ToolStripItemTextRenderEventArgs)

Zeichnet Text auf einem ToolStripItem.

DrawLabelBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund für einen ToolStripLabel.

DrawMenuItemBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund für einen ToolStripMenuItem.

DrawOverflowButtonBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund einer Überlaufschaltfläche.

DrawSeparator(ToolStripSeparatorRenderEventArgs)

Zeichnet einen ToolStripSeparator.

DrawSplitButton(ToolStripItemRenderEventArgs)

Zeichnet einen ToolStripSplitButton.

DrawStatusStripSizingGrip(ToolStripRenderEventArgs)

Zeichnet einen Größenziehpunkt.

DrawToolStripBackground(ToolStripRenderEventArgs)

Zeichnet den Hintergrund für einen ToolStrip.

DrawToolStripBorder(ToolStripRenderEventArgs)

Zeichnet den Rahmen für einen ToolStrip.

DrawToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Zeichnet den Hintergrund des ToolStripContentPanel.

DrawToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Zeichnet den Hintergrund des ToolStripPanel.

DrawToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Zeichnet den Hintergrund des ToolStripStatusLabel.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize(ToolStrip)

Stellt beim Überschreiben in einer abgeleiteten Klasse die benutzerdefinierte Initialisierung des angegebenen ToolStrip bereit.

InitializeContentPanel(ToolStripContentPanel)

Initialisiert das angegebene ToolStripContentPanel.

InitializeItem(ToolStripItem)

Stellt beim Überschreiben in einer abgeleiteten Klasse die benutzerdefinierte Initialisierung des angegebenen ToolStripItem bereit.

InitializePanel(ToolStripPanel)

Initialisiert das angegebene ToolStripPanel.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnRenderArrow(ToolStripArrowRenderEventArgs)

Löst das RenderArrow-Ereignis aus.

OnRenderButtonBackground(ToolStripItemRenderEventArgs)

Löst das RenderButtonBackground-Ereignis aus.

OnRenderDropDownButtonBackground(ToolStripItemRenderEventArgs)

Löst das RenderDropDownButtonBackground-Ereignis aus.

OnRenderGrip(ToolStripGripRenderEventArgs)

Löst das RenderGrip-Ereignis aus.

OnRenderImageMargin(ToolStripRenderEventArgs)

Zeichnet den Hintergrund des Elements.

OnRenderItemBackground(ToolStripItemRenderEventArgs)

Löst das OnRenderItemBackground(ToolStripItemRenderEventArgs)-Ereignis aus.

OnRenderItemCheck(ToolStripItemImageRenderEventArgs)

Löst das RenderItemCheck-Ereignis aus.

OnRenderItemImage(ToolStripItemImageRenderEventArgs)

Löst das RenderItemImage-Ereignis aus.

OnRenderItemText(ToolStripItemTextRenderEventArgs)

Löst das RenderItemText-Ereignis aus.

OnRenderLabelBackground(ToolStripItemRenderEventArgs)

Löst das RenderLabelBackground-Ereignis aus.

OnRenderMenuItemBackground(ToolStripItemRenderEventArgs)

Löst das RenderMenuItemBackground-Ereignis aus.

OnRenderOverflowButtonBackground(ToolStripItemRenderEventArgs)

Löst das RenderOverflowButtonBackground-Ereignis aus.

OnRenderSeparator(ToolStripSeparatorRenderEventArgs)

Löst das RenderSeparator-Ereignis aus.

OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs)

Löst das OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs)-Ereignis aus.

OnRenderStatusStripSizingGrip(ToolStripRenderEventArgs)

Löst das RenderStatusStripSizingGrip-Ereignis aus.

OnRenderToolStripBackground(ToolStripRenderEventArgs)

Löst das RenderToolStripBackground-Ereignis aus.

OnRenderToolStripBorder(ToolStripRenderEventArgs)

Löst das RenderToolStripBorder-Ereignis aus.

OnRenderToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Löst das RenderToolStripContentPanelBackground-Ereignis aus.

OnRenderToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Löst das RenderToolStripPanelBackground-Ereignis aus.

OnRenderToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Löst das RenderToolStripStatusLabelBackground-Ereignis aus.

ScaleArrowOffsetsIfNeeded()

Wendet die Werte Offset2X und Offset2Y auf die Skalierung des Pfeilsymbols an, wenn Skalierung aufgrund der DPI-Einstellungen des Computers erforderlich ist.

ScaleArrowOffsetsIfNeeded(Int32)

Wendet auf der Grundlage des angegebenen DPI-Werts die für die Skalierung des Pfeilsymbols angegebenen Werte Offset2X und Offset2Y an.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Ereignisse

RenderArrow

Tritt ein, wenn ein Pfeil auf einem ToolStripItem gerendert wird.

RenderButtonBackground

Tritt ein, wenn der Hintergrund für einen ToolStripButton gerendert wird.

RenderDropDownButtonBackground

Tritt ein, wenn der Hintergrund für einen ToolStripDropDownButton gerendert wird.

RenderGrip

Tritt ein, wenn der Verschiebepunkt von einem ToolStrip gerendert wird.

RenderImageMargin

Zeichnet den Rand zwischen einem Bild und seinem Container.

RenderItemBackground

Tritt ein, wenn der Hintergrund für einen ToolStripItem gerendert wird.

RenderItemCheck

Tritt ein, wenn das Bild für ein ausgewähltes ToolStripItem gerendert wird.

RenderItemImage

Tritt ein, wenn das Bild für ein ToolStripItem gerendert wird.

RenderItemText

Tritt ein, wenn der Text für ein ToolStripItem gerendert wird.

RenderLabelBackground

Tritt ein, wenn der Hintergrund für einen ToolStripLabel gerendert wird.

RenderMenuItemBackground

Tritt ein, wenn der Hintergrund für einen ToolStripMenuItem gerendert wird.

RenderOverflowButtonBackground

Tritt ein, wenn der Hintergrund einer Überlaufschaltfläche gerendert wird.

RenderSeparator

Tritt ein, wenn ein ToolStripSeparator gerendert wird.

RenderSplitButtonBackground

Tritt ein, wenn der Hintergrund für einen ToolStripSplitButton gerendert wird.

RenderStatusStripSizingGrip

Tritt ein, wenn sich der Anzeigestil ändert.

RenderToolStripBackground

Tritt ein, wenn der Hintergrund für einen ToolStrip gerendert wird.

RenderToolStripBorder

Tritt ein, wenn der Rahmen für einen ToolStrip gerendert wird.

RenderToolStripContentPanelBackground

Zeichnet den Hintergrund für ein ToolStripContentPanel.

RenderToolStripPanelBackground

Zeichnet den Hintergrund für ein ToolStripPanel.

RenderToolStripStatusLabelBackground

Zeichnet den Hintergrund für ein ToolStripStatusLabel.

Gilt für:

Weitere Informationen