Partager via


ToolStripRenderer Classe

Définition

Gère la fonctionnalité de peinture pour les objets ToolStrip.

public ref class ToolStripRenderer abstract
public abstract class ToolStripRenderer
type ToolStripRenderer = class
Public MustInherit Class ToolStripRenderer
Héritage
ToolStripRenderer
Dérivé

Exemples

L'exemple de code suivant montre comment implémenter une classe ToolStripRenderer personnalisée. La GridStripRenderer classe personnalise trois aspects de l’apparence GridStrip du contrôle : GridStrip bordure, ToolStripButton bordure et ToolStripButton image. Pour obtenir une liste de code complète, consultez Guide pratique pour implémenter un outil personnalisé ToolStripRenderer.

// 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

Remarques

Utilisez la ToolStripRenderer classe pour appliquer un style ou un thème particulier à un ToolStrip. Plutôt que de peindre personnalisé un ToolStrip et les ToolStripItem objets qu’il contient, vous définissez la ToolStrip.Renderer propriété sur un objet qui hérite de ToolStripRenderer. La peinture spécifiée par est ToolStripRenderer appliquée au , ainsi qu’aux ToolStripéléments qu’il contient.

Vous pouvez effectuer une peinture personnalisée dans ToolStrip des contrôles de plusieurs façons. Comme avec d’autres contrôles Windows Forms, les deux ont des ToolStrip méthodes et Paint des événements substituablesOnPaint.ToolStripItem Comme pour la peinture régulière, le système de coordonnées est relatif à la zone cliente du contrôle ; autrement dit, le coin supérieur gauche du contrôle est 0, 0. L’événement Paint et la OnPaint méthode d’un ToolStripItem se comportent comme d’autres événements de peinture de contrôle.

La ToolStripRenderer classe a des méthodes substituables pour peindre l’arrière-plan, l’arrière-plan de l’élément, l’image de l’élément, la flèche de l’élément, le texte de l’élément et la ToolStripbordure du . Les arguments d’événement pour ces méthodes exposent plusieurs propriétés telles que des rectangles, des couleurs et des formats de texte que vous pouvez ajuster à votre guise.

Pour ajuster quelques aspects de la façon dont un élément est peint, vous remplacez généralement .ToolStripRenderer

Si vous écrivez un nouvel élément et souhaitez contrôler tous les aspects de la peinture, remplacez la OnPaint méthode . OnPaintÀ partir de , vous pouvez utiliser des méthodes à partir de ToolStripRenderer.

Par défaut, le ToolStrip est double mis en mémoire tampon, tirant parti du OptimizedDoubleBuffer paramètre.

Constructeurs

ToolStripRenderer()

Initialise une nouvelle instance de la classe ToolStripRenderer.

Champs

Offset2X

Obtient ou définit le multiplicateur de décalage pour deux fois le décalage le long de l’axe x.

Offset2Y

Obtient ou définit le multiplicateur de décalage pour deux fois le décalage le long de l’axe y.

Méthodes

CreateDisabledImage(Image)

Crée une copie d'échelle de gris d'une image donnée.

DrawArrow(ToolStripArrowRenderEventArgs)

Dessine une flèche sur un ToolStripItem.

DrawButtonBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan pour ToolStripButton.

DrawDropDownButtonBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan pour ToolStripDropDownButton.

DrawGrip(ToolStripGripRenderEventArgs)

Dessine une poignée de déplacement sur un ToolStrip.

DrawImageMargin(ToolStripRenderEventArgs)

Dessine l'espace autour d'une image sur un ToolStrip.

DrawItemBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan pour ToolStripItem.

DrawItemCheck(ToolStripItemImageRenderEventArgs)

Dessine une image sur un ToolStripItem qui indique que l'élément se trouve dans un état sélectionné.

DrawItemImage(ToolStripItemImageRenderEventArgs)

Dessine une image sur un ToolStripItem.

DrawItemText(ToolStripItemTextRenderEventArgs)

Dessine le texte sur un ToolStripItem.

DrawLabelBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan pour ToolStripLabel.

DrawMenuItemBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan pour ToolStripMenuItem.

DrawOverflowButtonBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan d'un bouton de dépassement de capacité.

DrawSeparator(ToolStripSeparatorRenderEventArgs)

Dessine un ToolStripSeparator.

DrawSplitButton(ToolStripItemRenderEventArgs)

Dessine un ToolStripSplitButton.

DrawStatusStripSizingGrip(ToolStripRenderEventArgs)

Dessine une poignée de dimensionnement.

DrawToolStripBackground(ToolStripRenderEventArgs)

Dessine l'arrière-plan pour ToolStrip.

DrawToolStripBorder(ToolStripRenderEventArgs)

Dessine la bordure pour ToolStrip.

DrawToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Dessine l'arrière-plan de ToolStripContentPanel.

DrawToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Dessine l'arrière-plan de ToolStripPanel.

DrawToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Dessine l'arrière-plan de ToolStripStatusLabel.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
Initialize(ToolStrip)

En cas de substitution dans une classe dérivée, fournit une initialisation personnalisée du ToolStrip donné.

InitializeContentPanel(ToolStripContentPanel)

Initialise le ToolStripContentPanel spécifié.

InitializeItem(ToolStripItem)

En cas de substitution dans une classe dérivée, fournit une initialisation personnalisée du ToolStripItem donné.

InitializePanel(ToolStripPanel)

Initialise le ToolStripPanel spécifié.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnRenderArrow(ToolStripArrowRenderEventArgs)

Déclenche l’événement RenderArrow.

OnRenderButtonBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement RenderButtonBackground.

OnRenderDropDownButtonBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement RenderDropDownButtonBackground.

OnRenderGrip(ToolStripGripRenderEventArgs)

Déclenche l’événement RenderGrip.

OnRenderImageMargin(ToolStripRenderEventArgs)

Dessine l'arrière-plan.

OnRenderItemBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement OnRenderItemBackground(ToolStripItemRenderEventArgs).

OnRenderItemCheck(ToolStripItemImageRenderEventArgs)

Déclenche l’événement RenderItemCheck.

OnRenderItemImage(ToolStripItemImageRenderEventArgs)

Déclenche l’événement RenderItemImage.

OnRenderItemText(ToolStripItemTextRenderEventArgs)

Déclenche l’événement RenderItemText.

OnRenderLabelBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement RenderLabelBackground.

OnRenderMenuItemBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement RenderMenuItemBackground.

OnRenderOverflowButtonBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement RenderOverflowButtonBackground.

OnRenderSeparator(ToolStripSeparatorRenderEventArgs)

Déclenche l’événement RenderSeparator.

OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs).

OnRenderStatusStripSizingGrip(ToolStripRenderEventArgs)

Déclenche l’événement RenderStatusStripSizingGrip.

OnRenderToolStripBackground(ToolStripRenderEventArgs)

Déclenche l’événement RenderToolStripBackground.

OnRenderToolStripBorder(ToolStripRenderEventArgs)

Déclenche l’événement RenderToolStripBorder.

OnRenderToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Déclenche l’événement RenderToolStripContentPanelBackground.

OnRenderToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Déclenche l’événement RenderToolStripPanelBackground.

OnRenderToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Déclenche l’événement RenderToolStripStatusLabelBackground.

ScaleArrowOffsetsIfNeeded()

Applique les valeurs Offset2X et Offset2Y pour la mise à l’échelle de l’icône de flèche, si une mise à l’échelle est nécessaire selon les paramètres PPP de l’ordinateur.

ScaleArrowOffsetsIfNeeded(Int32)

Applique les valeurs Offset2X et Offset2Y pour la mise à l’échelle de l’icône de flèche, selon la valeur PPP spécifiée.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Événements

RenderArrow

Se produit lors du rendu d'une flèche sur un ToolStripItem.

RenderButtonBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStripButton.

RenderDropDownButtonBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStripDropDownButton.

RenderGrip

Se produit lors du rendu de la poignée de déplacement d'un ToolStrip.

RenderImageMargin

Dessine la marge entre une image et son conteneur.

RenderItemBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStripItem.

RenderItemCheck

Se produit lors du rendu de l'image d'un ToolStripItem sélectionné.

RenderItemImage

Se produit lors du rendu de l'image d'un ToolStripItem.

RenderItemText

Se produit lors du rendu du texte d'un ToolStripItem.

RenderLabelBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStripLabel.

RenderMenuItemBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStripMenuItem.

RenderOverflowButtonBackground

Se produit lors du rendu de l'arrière-plan d'un bouton de dépassement de capacité.

RenderSeparator

Se produit lors du rendu d'un ToolStripSeparator.

RenderSplitButtonBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStripSplitButton.

RenderStatusStripSizingGrip

Se produit lors d'un changement de style d'affichage.

RenderToolStripBackground

Se produit lors du rendu de l'arrière-plan d'un ToolStrip.

RenderToolStripBorder

Se produit lors du rendu de la bordure d'un ToolStrip.

RenderToolStripContentPanelBackground

Dessine l'arrière-plan de ToolStripContentPanel.

RenderToolStripPanelBackground

Dessine l'arrière-plan de ToolStripPanel.

RenderToolStripStatusLabelBackground

Dessine l'arrière-plan de ToolStripStatusLabel.

S’applique à

Voir aussi