ToolStripProfessionalRenderer Classe

Definição

Trata da funcionalidade de pintura dos ToolStrip objetos, aplicando uma paleta personalizada e um estilo simplificado.

public ref class ToolStripProfessionalRenderer : System::Windows::Forms::ToolStripRenderer
public class ToolStripProfessionalRenderer : System.Windows.Forms.ToolStripRenderer
type ToolStripProfessionalRenderer = class
    inherit ToolStripRenderer
Public Class ToolStripProfessionalRenderer
Inherits ToolStripRenderer
Herança
ToolStripProfessionalRenderer

Exemplos

O exemplo de código seguinte demonstra como criar um controlo composto que imite o Painel de Navegação fornecido por Microsoft ® Outlook ®. Para uma lista completa de código, veja Como: Criar um Controlo ToolStrip com Estilo Profissional.

internal class StackRenderer : ToolStripProfessionalRenderer
{
    private static Bitmap titleBarGripBmp;
    private static string titleBarGripEnc = @"Qk16AQAAAAAAADYAAAAoAAAAIwAAAAMAAAABABgAAAAAAAAAAADEDgAAxA4AAAAAAAAAAAAAuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5ANj+RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5ANj+RzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMANj+";

    // Define titlebar colors.
    private static Color titlebarColor1 = Color.FromArgb(89, 135, 214);
    private static Color titlebarColor2 = Color.FromArgb(76, 123, 204);
    private static Color titlebarColor3 = Color.FromArgb(63, 111, 194);
    private static Color titlebarColor4 = Color.FromArgb(50, 99, 184);
    private static Color titlebarColor5 = Color.FromArgb(38, 88, 174);
    private static Color titlebarColor6 = Color.FromArgb(25, 76, 164);
    private static Color titlebarColor7 = Color.FromArgb(12, 64, 154);
    private static Color borderColor = Color.FromArgb(0, 0, 128);

    static StackRenderer()
    {
        titleBarGripBmp = StackView.DeserializeFromBase64(titleBarGripEnc);
    }

    public StackRenderer()
    {
    }

    private void DrawTitleBar(Graphics g, Rectangle rect)
    {
        // Assign the image for the grip.
        Image titlebarGrip = titleBarGripBmp;

        // Fill the titlebar. 
        // This produces the gradient and the rounded-corner effect.
        g.DrawLine(new Pen(titlebarColor1), rect.X, rect.Y, rect.X + rect.Width, rect.Y);
        g.DrawLine(new Pen(titlebarColor2), rect.X, rect.Y + 1, rect.X + rect.Width, rect.Y + 1);
        g.DrawLine(new Pen(titlebarColor3), rect.X, rect.Y + 2, rect.X + rect.Width, rect.Y + 2);
        g.DrawLine(new Pen(titlebarColor4), rect.X, rect.Y + 3, rect.X + rect.Width, rect.Y + 3);
        g.DrawLine(new Pen(titlebarColor5), rect.X, rect.Y + 4, rect.X + rect.Width, rect.Y + 4);
        g.DrawLine(new Pen(titlebarColor6), rect.X, rect.Y + 5, rect.X + rect.Width, rect.Y + 5);
        g.DrawLine(new Pen(titlebarColor7), rect.X, rect.Y + 6, rect.X + rect.Width, rect.Y + 6);

        // Center the titlebar grip.
        g.DrawImage(
            titlebarGrip,
            new Point(rect.X + ((rect.Width / 2) - (titlebarGrip.Width / 2)),
            rect.Y + 1));
    }

    // This method handles the RenderGrip event.
    protected override void OnRenderGrip(ToolStripGripRenderEventArgs e)
    {
        DrawTitleBar(
            e.Graphics,
            new Rectangle(0, 0, e.ToolStrip.Width, 7));
    }

    // This method handles the RenderToolStripBorder event.
    protected override void OnRenderToolStripBorder(ToolStripRenderEventArgs e)
    {
        DrawTitleBar(
            e.Graphics,
            new Rectangle(0, 0, e.ToolStrip.Width, 7));
    }

    // This method handles the RenderButtonBackground event.
    protected override void OnRenderButtonBackground(ToolStripItemRenderEventArgs e)
    {
        Graphics g = e.Graphics;
        Rectangle bounds = new Rectangle(Point.Empty, e.Item.Size);

        Color gradientBegin = Color.FromArgb(203, 225, 252);
        Color gradientEnd = Color.FromArgb(125, 165, 224);

        ToolStripButton button = e.Item as ToolStripButton;
        if (button.Pressed || button.Checked)
        {
            gradientBegin = Color.FromArgb(254, 128, 62);
            gradientEnd = Color.FromArgb(255, 223, 154);
        }
        else if (button.Selected)
        {
            gradientBegin = Color.FromArgb(255, 255, 222);
            gradientEnd = Color.FromArgb(255, 203, 136);
        }

        using (Brush b = new LinearGradientBrush(
            bounds,
            gradientBegin,
            gradientEnd,
            LinearGradientMode.Vertical))
        {
            g.FillRectangle(b, bounds);
        }

        e.Graphics.DrawRectangle(
            SystemPens.ControlDarkDark,
            bounds);

        g.DrawLine(
            SystemPens.ControlDarkDark,
            bounds.X,
            bounds.Y,
            bounds.Width - 1,
            bounds.Y);

        g.DrawLine(
            SystemPens.ControlDarkDark,
            bounds.X,
            bounds.Y,
            bounds.X,
            bounds.Height - 1);

        ToolStrip toolStrip = button.Owner;
        ToolStripButton nextItem = button.Owner.GetItemAt(
            button.Bounds.X,
            button.Bounds.Bottom + 1) as ToolStripButton;

        if (nextItem == null)
        {
            g.DrawLine(
                SystemPens.ControlDarkDark,
                bounds.X,
                bounds.Height - 1,
                bounds.X + bounds.Width - 1,
                bounds.Height - 1);
        }
    }
}
Friend Class StackRenderer
   Inherits ToolStripProfessionalRenderer
   Private Shared titleBarGripBmp As Bitmap
   Private Shared titleBarGripEnc As String = "Qk16AQAAAAAAADYAAAAoAAAAIwAAAAMAAAABABgAAAAAAAAAAADEDgAAxA4AAAAAAAAAAAAAuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5uGMyuGMy+/n5+/n5ANj+RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5wm8/RzIomHRh+/n5ANj+RzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMzHtMRzIoRzIozHtMANj+"
   
   ' Define titlebar colors.
   Private Shared titlebarColor1 As Color = Color.FromArgb(89, 135, 214)
   Private Shared titlebarColor2 As Color = Color.FromArgb(76, 123, 204)
   Private Shared titlebarColor3 As Color = Color.FromArgb(63, 111, 194)
   Private Shared titlebarColor4 As Color = Color.FromArgb(50, 99, 184)
   Private Shared titlebarColor5 As Color = Color.FromArgb(38, 88, 174)
   Private Shared titlebarColor6 As Color = Color.FromArgb(25, 76, 164)
   Private Shared titlebarColor7 As Color = Color.FromArgb(12, 64, 154)
   Private Shared borderColor As Color = Color.FromArgb(0, 0, 128)
   
   Shared Sub New()
      titleBarGripBmp = StackView.DeserializeFromBase64(titleBarGripEnc)
     End Sub
   
   Public Sub New()
     End Sub
   
     Private Sub DrawTitleBar(ByVal g As Graphics, ByVal rect As Rectangle)

         ' Assign the image for the grip.
         Dim titlebarGrip As Image = titleBarGripBmp

         ' Fill the titlebar. 
         ' This produces the gradient and the rounded-corner effect.
         g.DrawLine(New Pen(titlebarColor1), rect.X, rect.Y, rect.X + rect.Width, rect.Y)
         g.DrawLine(New Pen(titlebarColor2), rect.X, rect.Y + 1, rect.X + rect.Width, rect.Y + 1)
         g.DrawLine(New Pen(titlebarColor3), rect.X, rect.Y + 2, rect.X + rect.Width, rect.Y + 2)
         g.DrawLine(New Pen(titlebarColor4), rect.X, rect.Y + 3, rect.X + rect.Width, rect.Y + 3)
         g.DrawLine(New Pen(titlebarColor5), rect.X, rect.Y + 4, rect.X + rect.Width, rect.Y + 4)
         g.DrawLine(New Pen(titlebarColor6), rect.X, rect.Y + 5, rect.X + rect.Width, rect.Y + 5)
         g.DrawLine(New Pen(titlebarColor7), rect.X, rect.Y + 6, rect.X + rect.Width, rect.Y + 6)

         ' Center the titlebar grip.
         g.DrawImage(titlebarGrip, New Point(rect.X + (rect.Width / 2 - titlebarGrip.Width / 2), rect.Y + 1))
     End Sub
   
   
   ' This method handles the RenderGrip event.
   Protected Overrides Sub OnRenderGrip(e As ToolStripGripRenderEventArgs)
      DrawTitleBar(e.Graphics, New Rectangle(0, 0, e.ToolStrip.Width, 7))
     End Sub
   
   
   ' This method handles the RenderToolStripBorder event.
   Protected Overrides Sub OnRenderToolStripBorder(e As ToolStripRenderEventArgs)
      DrawTitleBar(e.Graphics, New Rectangle(0, 0, e.ToolStrip.Width, 7))
     End Sub
   
   
   ' This method handles the RenderButtonBackground event.
   Protected Overrides Sub OnRenderButtonBackground(e As ToolStripItemRenderEventArgs)
      Dim g As Graphics = e.Graphics
      Dim bounds As New Rectangle(Point.Empty, e.Item.Size)
      
      Dim gradientBegin As Color = Color.FromArgb(203, 225, 252)
      Dim gradientEnd As Color = Color.FromArgb(125, 165, 224)
      
         Dim button As ToolStripButton = CType(e.Item, ToolStripButton)
      
      If button.Pressed OrElse button.Checked Then
         gradientBegin = Color.FromArgb(254, 128, 62)
         gradientEnd = Color.FromArgb(255, 223, 154)
      ElseIf button.Selected Then
         gradientBegin = Color.FromArgb(255, 255, 222)
         gradientEnd = Color.FromArgb(255, 203, 136)
      End If
      
      Dim b = New LinearGradientBrush(bounds, gradientBegin, gradientEnd, LinearGradientMode.Vertical)
      Try
         g.FillRectangle(b, bounds)
      Finally
         b.Dispose()
      End Try
      
      e.Graphics.DrawRectangle(SystemPens.ControlDarkDark, bounds)
      
      g.DrawLine(SystemPens.ControlDarkDark, bounds.X, bounds.Y, bounds.Width - 1, bounds.Y)
      
      g.DrawLine(SystemPens.ControlDarkDark, bounds.X, bounds.Y, bounds.X, bounds.Height - 1)
      
      Dim toolStrip As ToolStrip = button.Owner
         Dim nextItem As ToolStripButton = CType(button.Owner.GetItemAt(button.Bounds.X, button.Bounds.Bottom + 1), ToolStripButton)
      
      If nextItem Is Nothing Then
         g.DrawLine(SystemPens.ControlDarkDark, bounds.X, bounds.Height - 1, bounds.X + bounds.Width - 1, bounds.Height - 1)
      End If
     End Sub
 End Class

Observações

ToolStripProfessionalRenderer cria canetas e pincéis baseados numa tabela de cores substituível chamada ProfessionalColorTable.

Construtores

Name Description
ToolStripProfessionalRenderer()

Inicializa uma nova instância da ToolStripProfessionalRenderer classe.

ToolStripProfessionalRenderer(ProfessionalColorTable)

Inicializa uma nova instância da ToolStripProfessionalRenderer classe.

Propriedades

Name Description
ColorTable

Recebe a paleta de cores usada para pintar.

RoundedEdges

Recebe ou define um valor que indica se as arestas dos controlos têm uma aparência arredondada em vez de quadrada ou nítida.

Métodos

Name Description
DrawArrow(ToolStripArrowRenderEventArgs)

Desenha uma seta num ToolStripItem.

(Herdado de ToolStripRenderer)
DrawButtonBackground(ToolStripItemRenderEventArgs)

Desenha o fundo para um ToolStripButton.

(Herdado de ToolStripRenderer)
DrawDropDownButtonBackground(ToolStripItemRenderEventArgs)

Desenha o fundo para um ToolStripDropDownButton.

(Herdado de ToolStripRenderer)
DrawGrip(ToolStripGripRenderEventArgs)

Desenha uma alça de movimento num ToolStrip.

(Herdado de ToolStripRenderer)
DrawImageMargin(ToolStripRenderEventArgs)

Desenha o espaço em torno de uma imagem num ToolStrip.

(Herdado de ToolStripRenderer)
DrawItemBackground(ToolStripItemRenderEventArgs)

Desenha o fundo para um ToolStripItem.

(Herdado de ToolStripRenderer)
DrawItemCheck(ToolStripItemImageRenderEventArgs)

Desenha uma imagem em um ToolStripItem que indica que o item está num estado selecionado.

(Herdado de ToolStripRenderer)
DrawItemImage(ToolStripItemImageRenderEventArgs)

Desenha uma imagem num ToolStripItem.

(Herdado de ToolStripRenderer)
DrawItemText(ToolStripItemTextRenderEventArgs)

Desenha texto num ToolStripItem.

(Herdado de ToolStripRenderer)
DrawLabelBackground(ToolStripItemRenderEventArgs)

Desenha o fundo para um ToolStripLabel.

(Herdado de ToolStripRenderer)
DrawMenuItemBackground(ToolStripItemRenderEventArgs)

Desenha o fundo para um ToolStripMenuItem.

(Herdado de ToolStripRenderer)
DrawOverflowButtonBackground(ToolStripItemRenderEventArgs)

Desenha o fundo para um botão de overflow.

(Herdado de ToolStripRenderer)
DrawSeparator(ToolStripSeparatorRenderEventArgs)

Tira um ToolStripSeparator.

(Herdado de ToolStripRenderer)
DrawSplitButton(ToolStripItemRenderEventArgs)

Tira um ToolStripSplitButton.

(Herdado de ToolStripRenderer)
DrawStatusStripSizingGrip(ToolStripRenderEventArgs)

Tira uma pega de tamanho.

(Herdado de ToolStripRenderer)
DrawToolStripBackground(ToolStripRenderEventArgs)

Desenha o fundo para um ToolStrip.

(Herdado de ToolStripRenderer)
DrawToolStripBorder(ToolStripRenderEventArgs)

Desenha a fronteira para um ToolStrip.

(Herdado de ToolStripRenderer)
DrawToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Desenha o fundo do ToolStripContentPanel.

(Herdado de ToolStripRenderer)
DrawToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Desenha o fundo do ToolStripPanel.

(Herdado de ToolStripRenderer)
DrawToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Desenha o fundo do ToolStripStatusLabel.

(Herdado de ToolStripRenderer)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize(ToolStrip)

Quando sobrescrito numa classe derivada, permite a inicialização personalizada do dado ToolStrip.

(Herdado de ToolStripRenderer)
InitializeContentPanel(ToolStripContentPanel)

Inicializa o especificado ToolStripContentPanel.

(Herdado de ToolStripRenderer)
InitializeItem(ToolStripItem)

Quando sobrescrito numa classe derivada, permite a inicialização personalizada do dado ToolStripItem.

(Herdado de ToolStripRenderer)
InitializePanel(ToolStripPanel)

Inicializa o especificado ToolStripPanel.

(Herdado de ToolStripRenderer)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnRenderArrow(ToolStripArrowRenderEventArgs)

Eleva o RenderArrow evento.

OnRenderButtonBackground(ToolStripItemRenderEventArgs)

Eleva o RenderButtonBackground evento.

OnRenderDropDownButtonBackground(ToolStripItemRenderEventArgs)

Eleva o RenderDropDownButtonBackground evento.

OnRenderGrip(ToolStripGripRenderEventArgs)

Eleva o RenderGrip evento.

OnRenderImageMargin(ToolStripRenderEventArgs)

Desenha o fundo do item.

OnRenderItemBackground(ToolStripItemRenderEventArgs)

Eleva o OnRenderItemBackground(ToolStripItemRenderEventArgs) evento.

(Herdado de ToolStripRenderer)
OnRenderItemCheck(ToolStripItemImageRenderEventArgs)

Eleva o RenderItemCheck evento.

OnRenderItemImage(ToolStripItemImageRenderEventArgs)

Eleva o RenderItemImage evento.

OnRenderItemText(ToolStripItemTextRenderEventArgs)

Eleva o RenderItemText evento.

OnRenderLabelBackground(ToolStripItemRenderEventArgs)

Eleva o RenderLabelBackground evento.

OnRenderMenuItemBackground(ToolStripItemRenderEventArgs)

Eleva o RenderMenuItemBackground evento.

OnRenderOverflowButtonBackground(ToolStripItemRenderEventArgs)

Eleva o RenderOverflowButtonBackground evento.

OnRenderSeparator(ToolStripSeparatorRenderEventArgs)

Eleva o RenderSeparator evento.

OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs)

Levanta o evento OnRenderSplitButtonBackground.

OnRenderStatusStripSizingGrip(ToolStripRenderEventArgs)

Eleva o RenderStatusStripSizingGrip evento.

(Herdado de ToolStripRenderer)
OnRenderToolStripBackground(ToolStripRenderEventArgs)

Eleva o RenderToolStripBackground evento.

OnRenderToolStripBorder(ToolStripRenderEventArgs)

Eleva o RenderToolStripBorder evento.

OnRenderToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Eleva o RenderToolStripContentPanelBackground evento.

OnRenderToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Eleva o RenderToolStripPanelBackground evento.

OnRenderToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Eleva o RenderToolStripStatusLabelBackground evento.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
RenderArrow

Ocorre quando uma seta em um ToolStripItem é renderizada.

(Herdado de ToolStripRenderer)
RenderButtonBackground

Ocorre quando o fundo de um ToolStripButton é renderizado.

(Herdado de ToolStripRenderer)
RenderDropDownButtonBackground

Ocorre quando o fundo de um ToolStripDropDownButton é renderizado.

(Herdado de ToolStripRenderer)
RenderGrip

Ocorre quando a alça de movimento para um ToolStrip é renderizada.

(Herdado de ToolStripRenderer)
RenderImageMargin

Desenha a margem entre uma imagem e o seu recipiente.

(Herdado de ToolStripRenderer)
RenderItemBackground

Ocorre quando o fundo de um ToolStripItem é renderizado.

(Herdado de ToolStripRenderer)
RenderItemCheck

Ocorre quando a imagem de um selecionado ToolStripItem é renderizada.

(Herdado de ToolStripRenderer)
RenderItemImage

Ocorre quando a imagem de um ToolStripItem é renderizada.

(Herdado de ToolStripRenderer)
RenderItemText

Ocorre quando o texto para um ToolStripItem é renderizado.

(Herdado de ToolStripRenderer)
RenderLabelBackground

Ocorre quando o fundo de um ToolStripLabel é renderizado.

(Herdado de ToolStripRenderer)
RenderMenuItemBackground

Ocorre quando o fundo de um ToolStripMenuItem é renderizado.

(Herdado de ToolStripRenderer)
RenderOverflowButtonBackground

Ocorre quando o fundo de fundo de um botão de overflow é renderizado.

(Herdado de ToolStripRenderer)
RenderSeparator

Ocorre quando a ToolStripSeparator é renderizado.

(Herdado de ToolStripRenderer)
RenderSplitButtonBackground

Ocorre quando o fundo de um ToolStripSplitButton é renderizado.

(Herdado de ToolStripRenderer)
RenderStatusStripSizingGrip

Ocorre quando o estilo de exibição muda.

(Herdado de ToolStripRenderer)
RenderToolStripBackground

Ocorre quando o fundo de um ToolStrip é renderizado.

(Herdado de ToolStripRenderer)
RenderToolStripBorder

Ocorre quando a borda de um ToolStrip é renderizada.

(Herdado de ToolStripRenderer)
RenderToolStripContentPanelBackground

Desenha o fundo de um ToolStripContentPanel.

(Herdado de ToolStripRenderer)
RenderToolStripPanelBackground

Desenha o fundo de um ToolStripPanel.

(Herdado de ToolStripRenderer)
RenderToolStripStatusLabelBackground

Desenha o fundo de um ToolStripStatusLabel.

(Herdado de ToolStripRenderer)

Aplica-se a