Поделиться через


ToolStripRenderer Класс

Определение

Выполняет функции рисования для объектов ToolStrip.

public ref class ToolStripRenderer abstract
public abstract class ToolStripRenderer
type ToolStripRenderer = class
Public MustInherit Class ToolStripRenderer
Наследование
ToolStripRenderer
Производный

Примеры

В следующем примере кода показано создание пользовательского класса ToolStripRenderer. Класс GridStripRenderer настраивает три аспекта GridStrip внешнего вида элемента управления: GridStrip границу, ToolStripButton границу и ToolStripButton изображение. Полный список кода см. в разделе Практическое руководство. Реализация пользовательского средства 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

Комментарии

Используйте класс для ToolStripRenderer применения определенного стиля или темы к объекту ToolStrip. Вместо настраиваемого ToolStrip рисования объекта и содержащихся в ToolStripItem нем объектов необходимо задать ToolStrip.Renderer для свойства объект, который наследуется от ToolStripRenderer. Рисунок, заданный , ToolStripRenderer применяется к объекту ToolStrip, а также к элементам, которые он содержит.

Вы можете реализовать настраиваемое рисование в элементах управления ToolStrip несколькими способами. Как и в случае с другими элементами управления Windows Forms, ToolStrip и ToolStripItem имеют переопределяемые методы OnPaint и события Paint. Как и при обычном рисовании, система координат связана с клиентской областью элемента управления, то есть верхний левый угол элемента управления имеет координаты 0, 0. Событие Paint и метод OnPaint для ToolStripItem ведут себя так же, как и другие события рисования элемента управления.

Класс ToolStripRenderer имеет переопределимые методы для рисования фона, фона элемента, изображения элемента, стрелки элемента, текста элемента и границы ToolStrip. Аргументы событий для этих методов предоставляют несколько свойств, таких как прямоугольники, цвета и текстовые форматы, которые можно настраивать по желанию.

Чтобы настроить всего несколько аспектов рисования элемента, вы обычно переопределяете ToolStripRenderer.

Если вы создаете новый элемент и хотите контролировать все аспекты рисования, переопределите метод OnPaint. Внутри OnPaint вы можете использовать методы из ToolStripRenderer.

По умолчанию для элемента управления ToolStrip задана двойная буферизация с использованием преимуществ параметра OptimizedDoubleBuffer.

Конструкторы

ToolStripRenderer()

Инициализирует новый экземпляр класса ToolStripRenderer.

Поля

Offset2X

Получает или задает коэффициент смещения для двойного смещения вдоль оси Х.

Offset2Y

Получает или задает коэффициент смещения для двойного смещения вдоль оси Y.

Методы

CreateDisabledImage(Image)

Создает черно-белую копию заданного изображения.

DrawArrow(ToolStripArrowRenderEventArgs)

Рисует стрелку в элементе ToolStripItem.

DrawButtonBackground(ToolStripItemRenderEventArgs)

Рисует фон для кнопки ToolStripButton.

DrawDropDownButtonBackground(ToolStripItemRenderEventArgs)

Рисует фон для кнопки ToolStripDropDownButton.

DrawGrip(ToolStripGripRenderEventArgs)

Рисует маркер перемещения для элемента ToolStrip.

DrawImageMargin(ToolStripRenderEventArgs)

Рисует поля вокруг изображения в элементе ToolStrip.

DrawItemBackground(ToolStripItemRenderEventArgs)

Рисует фон для кнопки ToolStripItem.

DrawItemCheck(ToolStripItemImageRenderEventArgs)

Рисует на элементе ToolStripItem изображение, которое показывает, что этот элемент выбран.

DrawItemImage(ToolStripItemImageRenderEventArgs)

Рисует изображение на элементе ToolStripItem.

DrawItemText(ToolStripItemTextRenderEventArgs)

Рисует текст в элементе ToolStripItem.

DrawLabelBackground(ToolStripItemRenderEventArgs)

Рисует фон для кнопки ToolStripLabel.

DrawMenuItemBackground(ToolStripItemRenderEventArgs)

Рисует фон для кнопки ToolStripMenuItem.

DrawOverflowButtonBackground(ToolStripItemRenderEventArgs)

Рисует фон для кнопки переполнения.

DrawSeparator(ToolStripSeparatorRenderEventArgs)

Рисует объект ToolStripSeparator.

DrawSplitButton(ToolStripItemRenderEventArgs)

Рисует объект ToolStripSplitButton.

DrawStatusStripSizingGrip(ToolStripRenderEventArgs)

Рисует захват для изменения размера.

DrawToolStripBackground(ToolStripRenderEventArgs)

Рисует фон для кнопки ToolStrip.

DrawToolStripBorder(ToolStripRenderEventArgs)

Рисует границы для элемента ToolStrip.

DrawToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Рисует фон элемента ToolStripContentPanel.

DrawToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Рисует фон элемента ToolStripPanel.

DrawToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Рисует фон элемента ToolStripStatusLabel.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
Initialize(ToolStrip)

В случае переопределения в производном классе выполняет нестандартную инициализацию заданного элемента ToolStrip.

InitializeContentPanel(ToolStripContentPanel)

Инициализирует заданный элемент ToolStripContentPanel.

InitializeItem(ToolStripItem)

В случае переопределения в производном классе выполняет нестандартную инициализацию заданного элемента ToolStripItem.

InitializePanel(ToolStripPanel)

Инициализирует заданный элемент ToolStripPanel.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
OnRenderArrow(ToolStripArrowRenderEventArgs)

Вызывает событие RenderArrow.

OnRenderButtonBackground(ToolStripItemRenderEventArgs)

Вызывает событие RenderButtonBackground.

OnRenderDropDownButtonBackground(ToolStripItemRenderEventArgs)

Вызывает событие RenderDropDownButtonBackground.

OnRenderGrip(ToolStripGripRenderEventArgs)

Вызывает событие RenderGrip.

OnRenderImageMargin(ToolStripRenderEventArgs)

Рисует фон элемента.

OnRenderItemBackground(ToolStripItemRenderEventArgs)

Вызывает событие OnRenderItemBackground(ToolStripItemRenderEventArgs).

OnRenderItemCheck(ToolStripItemImageRenderEventArgs)

Вызывает событие RenderItemCheck.

OnRenderItemImage(ToolStripItemImageRenderEventArgs)

Вызывает событие RenderItemImage.

OnRenderItemText(ToolStripItemTextRenderEventArgs)

Вызывает событие RenderItemText.

OnRenderLabelBackground(ToolStripItemRenderEventArgs)

Вызывает событие RenderLabelBackground.

OnRenderMenuItemBackground(ToolStripItemRenderEventArgs)

Вызывает событие RenderMenuItemBackground.

OnRenderOverflowButtonBackground(ToolStripItemRenderEventArgs)

Вызывает событие RenderOverflowButtonBackground.

OnRenderSeparator(ToolStripSeparatorRenderEventArgs)

Вызывает событие RenderSeparator.

OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs)

Вызывает событие OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs).

OnRenderStatusStripSizingGrip(ToolStripRenderEventArgs)

Вызывает событие RenderStatusStripSizingGrip.

OnRenderToolStripBackground(ToolStripRenderEventArgs)

Вызывает событие RenderToolStripBackground.

OnRenderToolStripBorder(ToolStripRenderEventArgs)

Вызывает событие RenderToolStripBorder.

OnRenderToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Вызывает событие RenderToolStripContentPanelBackground.

OnRenderToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Вызывает событие RenderToolStripPanelBackground.

OnRenderToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Вызывает событие RenderToolStripStatusLabelBackground.

ScaleArrowOffsetsIfNeeded()

Применяет значения Offset2X и Offset2Y для масштабирования значка стрелки, если такое масштабирование должно быть выполнено на основе параметров DPI компьютера.

ScaleArrowOffsetsIfNeeded(Int32)

Применяет значения Offset2X и Offset2Y для масштабирования значка стрелки на основе заданного значения DPI.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

События

RenderArrow

Происходит во время отрисовки стрелки в элементе ToolStripItem.

RenderButtonBackground

Создается во время отрисовки фона для кнопки ToolStripButton.

RenderDropDownButtonBackground

Создается во время отрисовки фона для кнопки ToolStripDropDownButton.

RenderGrip

Создается во время отрисовки маркера перемещения для элемента ToolStrip.

RenderImageMargin

Рисует поля между изображением и его контейнером.

RenderItemBackground

Создается во время отрисовки фона для кнопки ToolStripItem.

RenderItemCheck

Создается во время отрисовки изображения для выбранного элемента ToolStripItem.

RenderItemImage

Создается во время отрисовки изображения для элемента ToolStripItem.

RenderItemText

Создается во время отрисовки текста для элемента ToolStripItem.

RenderLabelBackground

Создается во время отрисовки фона для кнопки ToolStripLabel.

RenderMenuItemBackground

Создается во время отрисовки фона для кнопки ToolStripMenuItem.

RenderOverflowButtonBackground

Происходит во время отрисовки фона для кнопки переполнения.

RenderSeparator

Создается во время отрисовки объекта ToolStripSeparator.

RenderSplitButtonBackground

Создается во время отрисовки фона для кнопки ToolStripSplitButton.

RenderStatusStripSizingGrip

Происходит при изменении стиля отображения.

RenderToolStripBackground

Создается во время отрисовки фона для кнопки ToolStrip.

RenderToolStripBorder

Создается во время отрисовки границ для элемента ToolStrip.

RenderToolStripContentPanelBackground

Рисует фон для панели ToolStripContentPanel.

RenderToolStripPanelBackground

Рисует фон для панели ToolStripPanel.

RenderToolStripStatusLabelBackground

Рисует фон для панели ToolStripStatusLabel.

Применяется к

См. также раздел