Aracılığıyla paylaş


ToolStripRenderer Sınıf

Tanım

Nesneler için ToolStrip boyama işlevini işler.

public ref class ToolStripRenderer abstract
public abstract class ToolStripRenderer
type ToolStripRenderer = class
Public MustInherit Class ToolStripRenderer
Devralma
ToolStripRenderer
Türetilmiş

Örnekler

Aşağıdaki kod örneğinde özel ToolStripRenderer bir sınıfın nasıl uygulandığı gösterilmektedir. sınıfı denetimin GridStripRendererGridStrip görünümünün üç yönünü özelleştirir: GridStrip kenarlık, ToolStripButton kenarlık ve ToolStripButton görüntü. Tam kod listesi için bkz . Nasıl yapılır: Özel ToolStripRenderer Uygulama.

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

Açıklamalar

sınıfını ToolStripRenderer kullanarak bir öğesine belirli bir stil veya tema ToolStripuygulayın. a ToolStrip ve ToolStripItem içerdiği nesneleri özel olarak boyamak yerine, özelliğini öğesinden ToolStripRendererdevralan bir nesneye ayarlarsınızToolStrip.Renderer. tarafından ToolStripRenderer belirtilen tablo, içerdiği öğelerin yanı sıra öğesine de uygulanır ToolStrip.

Denetimlerde ToolStrip çeşitli yollarla özel boyama yapabilirsiniz. Diğer Windows Forms denetimlerinde ToolStrip olduğu gibi ve ToolStripItem her ikisi de geçersiz kılınabilir OnPaint yöntemlere ve Paint olaylara sahiptir. Normal boyamada olduğu gibi koordinat sistemi de denetimin istemci alanına göredir; yani denetimin sol üst köşesi 0, 0'dır. olayı Paint ve OnPaint yöntemi ToolStripItem diğer denetim boyası olayları gibi davranır.

sınıfı arka ToolStripRenderer planı, öğe arka planını, öğe görüntüsünü, öğe okunu, öğe metnini ve kenarını boyamak için geçersiz kılınabilir yöntemlere ToolStripsahiptir. Bu yöntemlerin olay bağımsız değişkenleri dikdörtgenler, renkler ve metin biçimleri gibi istediğiniz gibi ayarlayabileceğiniz çeşitli özellikleri kullanıma sunar.

Bir öğenin boyanma şeklinin yalnızca birkaç yönünü ayarlamak için, genellikle öğesini ToolStripRenderergeçersiz kılarsınız.

Yeni bir öğe yazıyorsanız ve tablonun tüm yönlerini denetlemek istiyorsanız, yöntemini geçersiz kılın OnPaint . içinden OnPaintiçindeki yöntemlerini ToolStripRendererkullanabilirsiniz.

Varsayılan olarak, ToolStrip ayarından OptimizedDoubleBuffer yararlanarak iki kez arabelleğe alır.

Oluşturucular

ToolStripRenderer()

ToolStripRenderer sınıfının yeni bir örneğini başlatır.

Alanlar

Offset2X

x ekseni boyunca uzaklık çarpımını iki kat daha fazla olacak şekilde alır veya ayarlar.

Offset2Y

Y ekseni boyunca uzaklık için iki kat uzaklık çarpanını alır veya ayarlar.

Yöntemler

CreateDisabledImage(Image)

Belirli bir görüntünün gri ölçekli bir kopyasını oluşturur.

DrawArrow(ToolStripArrowRenderEventArgs)

üzerine ToolStripItembir ok çizer.

DrawButtonBackground(ToolStripItemRenderEventArgs)

için ToolStripButtonarka plan çizer.

DrawDropDownButtonBackground(ToolStripItemRenderEventArgs)

için ToolStripDropDownButtonarka plan çizer.

DrawGrip(ToolStripGripRenderEventArgs)

üzerinde taşıma tutamacı ToolStripçizer.

DrawImageMargin(ToolStripRenderEventArgs)

üzerindeki ToolStripbir resmin etrafındaki boşluğu çizer.

DrawItemBackground(ToolStripItemRenderEventArgs)

için ToolStripItemarka plan çizer.

DrawItemCheck(ToolStripItemImageRenderEventArgs)

Öğenin seçili durumda olduğunu gösteren bir ToolStripItem resim çizer.

DrawItemImage(ToolStripItemImageRenderEventArgs)

üzerine ToolStripItembir resim çizer.

DrawItemText(ToolStripItemTextRenderEventArgs)

üzerine ToolStripItemmetin çizer.

DrawLabelBackground(ToolStripItemRenderEventArgs)

için ToolStripLabelarka plan çizer.

DrawMenuItemBackground(ToolStripItemRenderEventArgs)

için ToolStripMenuItemarka plan çizer.

DrawOverflowButtonBackground(ToolStripItemRenderEventArgs)

Taşma düğmesinin arka planını çizer.

DrawSeparator(ToolStripSeparatorRenderEventArgs)

Bir ToolStripSeparatorçizer.

DrawSplitButton(ToolStripItemRenderEventArgs)

Bir ToolStripSplitButtonçizer.

DrawStatusStripSizingGrip(ToolStripRenderEventArgs)

Boyutlandırma kavraması çizer.

DrawToolStripBackground(ToolStripRenderEventArgs)

için ToolStriparka plan çizer.

DrawToolStripBorder(ToolStripRenderEventArgs)

bir ToolStripiçin kenarlık çizer.

DrawToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

arka planını ToolStripContentPanelçizer.

DrawToolStripPanelBackground(ToolStripPanelRenderEventArgs)

arka planını ToolStripPanelçizer.

DrawToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

arka planını ToolStripStatusLabelçizer.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
Initialize(ToolStrip)

Türetilmiş bir sınıfta geçersiz kılındığında, verilen ToolStripöğesinin özel başlatılmasını sağlar.

InitializeContentPanel(ToolStripContentPanel)

Belirtilen ToolStripContentPanelöğesini başlatır.

InitializeItem(ToolStripItem)

Türetilmiş bir sınıfta geçersiz kılındığında, verilen ToolStripItemöğesinin özel başlatılmasını sağlar.

InitializePanel(ToolStripPanel)

Belirtilen ToolStripPanelöğesini başlatır.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnRenderArrow(ToolStripArrowRenderEventArgs)

Olayı tetikler RenderArrow .

OnRenderButtonBackground(ToolStripItemRenderEventArgs)

Olayı tetikler RenderButtonBackground .

OnRenderDropDownButtonBackground(ToolStripItemRenderEventArgs)

Olayı tetikler RenderDropDownButtonBackground .

OnRenderGrip(ToolStripGripRenderEventArgs)

Olayı tetikler RenderGrip .

OnRenderImageMargin(ToolStripRenderEventArgs)

Öğenin arka planını çizer.

OnRenderItemBackground(ToolStripItemRenderEventArgs)

Olayı tetikler OnRenderItemBackground(ToolStripItemRenderEventArgs) .

OnRenderItemCheck(ToolStripItemImageRenderEventArgs)

Olayı tetikler RenderItemCheck .

OnRenderItemImage(ToolStripItemImageRenderEventArgs)

Olayı tetikler RenderItemImage .

OnRenderItemText(ToolStripItemTextRenderEventArgs)

Olayı tetikler RenderItemText .

OnRenderLabelBackground(ToolStripItemRenderEventArgs)

Olayı tetikler RenderLabelBackground .

OnRenderMenuItemBackground(ToolStripItemRenderEventArgs)

Olayı tetikler RenderMenuItemBackground .

OnRenderOverflowButtonBackground(ToolStripItemRenderEventArgs)

Olayı tetikler RenderOverflowButtonBackground .

OnRenderSeparator(ToolStripSeparatorRenderEventArgs)

Olayı tetikler RenderSeparator .

OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs)

Olayı tetikler OnRenderSplitButtonBackground(ToolStripItemRenderEventArgs) .

OnRenderStatusStripSizingGrip(ToolStripRenderEventArgs)

Olayı tetikler RenderStatusStripSizingGrip .

OnRenderToolStripBackground(ToolStripRenderEventArgs)

Olayı tetikler RenderToolStripBackground .

OnRenderToolStripBorder(ToolStripRenderEventArgs)

Olayı tetikler RenderToolStripBorder .

OnRenderToolStripContentPanelBackground(ToolStripContentPanelRenderEventArgs)

Olayı tetikler RenderToolStripContentPanelBackground .

OnRenderToolStripPanelBackground(ToolStripPanelRenderEventArgs)

Olayı tetikler RenderToolStripPanelBackground .

OnRenderToolStripStatusLabelBackground(ToolStripItemRenderEventArgs)

Olayı tetikler RenderToolStripStatusLabelBackground .

ScaleArrowOffsetsIfNeeded()

Offset2X Bilgisayarın DPI ayarlarına göre ölçeklendirme gerekiyorsa ok simgesini ölçeklendirmeye ve Offset2Y değerlerini uygular.

ScaleArrowOffsetsIfNeeded(Int32)

Offset2X Ok simgesini belirtilen DPI değerine göre ölçeklendirmek için ve Offset2Y değerlerini uygular.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Ekinlikler

RenderArrow

üzerindeki ToolStripItem bir ok işlendiğinde gerçekleşir.

RenderButtonBackground

Arka plan ToolStripButton işlendiğinde gerçekleşir.

RenderDropDownButtonBackground

Arka plan ToolStripDropDownButton işlendiğinde gerçekleşir.

RenderGrip

taşıma tutamacı işlendiğinde ToolStrip gerçekleşir.

RenderImageMargin

Görüntüyle kapsayıcısı arasındaki kenar boşluğunu çizer.

RenderItemBackground

Arka plan ToolStripItem işlendiğinde gerçekleşir.

RenderItemCheck

Seçilen ToolStripItem bir görüntü işlendiğinde gerçekleşir.

RenderItemImage

bir için ToolStripItem görüntü işlendiğinde gerçekleşir.

RenderItemText

bir için ToolStripItem metin işlendiğinde gerçekleşir.

RenderLabelBackground

Arka plan ToolStripLabel işlendiğinde gerçekleşir.

RenderMenuItemBackground

Arka plan ToolStripMenuItem işlendiğinde gerçekleşir.

RenderOverflowButtonBackground

Taşma düğmesinin arka planı işlendiğinde gerçekleşir.

RenderSeparator

bir ToolStripSeparator işlendiğinde gerçekleşir.

RenderSplitButtonBackground

Arka plan ToolStripSplitButton işlendiğinde gerçekleşir.

RenderStatusStripSizingGrip

Görüntüleme stili değiştiğinde gerçekleşir.

RenderToolStripBackground

Arka plan ToolStrip işlendiğinde gerçekleşir.

RenderToolStripBorder

Bir ToolStrip için kenarlık işlendiğinde gerçekleşir.

RenderToolStripContentPanelBackground

bir ToolStripContentPanelöğesinin arka planını çizer.

RenderToolStripPanelBackground

bir ToolStripPanelöğesinin arka planını çizer.

RenderToolStripStatusLabelBackground

bir ToolStripStatusLabelöğesinin arka planını çizer.

Şunlara uygulanır

Ayrıca bkz.