ToolStripRenderer.OnRenderToolStripBackground Methode

protected:
 virtual void OnRenderToolStripBackground(System::Windows::Forms::ToolStripRenderEventArgs ^ e);

protected virtual void OnRenderToolStripBackground(System.Windows.Forms.ToolStripRenderEventArgs e);

abstract member OnRenderToolStripBackground : System.Windows.Forms.ToolStripRenderEventArgs -> unit
override this.OnRenderToolStripBackground : System.Windows.Forms.ToolStripRenderEventArgs -> unit

Protected Overridable Sub OnRenderToolStripBackground (e As ToolStripRenderEventArgs)

Parameters

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de OnRenderToolStripBackground methode voor het schilderen van een kleurovergang op de achtergrond van een ToolStrip besturingselement overschrijft. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de ToolStripRenderer klasse.

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

Opmerkingen

Als u een gebeurtenis aanroept, wordt de gebeurtenis-handler via een gemachtigde aangeroepen. Zie Afhandeling en het genereren van gebeurtenissen voor meer informatie.

Met OnRenderToolStripBackground de methode kunnen afgeleide klassen de gebeurtenis ook verwerken zonder een gemachtigde te koppelen. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een afgeleide klasse.

Notities voor overnemers

Wanneer u OnRenderToolStripBackground(ToolStripRenderEventArgs) overschrijft in een afgeleide klasse, moet u de methode van OnRenderToolStripBackground(ToolStripRenderEventArgs) de basisklasse aanroepen, zodat geregistreerde gemachtigden de gebeurtenis ontvangen.

Zie ook

• Procedure: Een aangepaste ToolStripRenderer implementeren