Export (0) Print
Expand All

ButtonRenderer.DrawParentBackground Method

Draws the background of a control's parent in the specified area.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public static void DrawParentBackground(
	Graphics g,
	Rectangle bounds,
	Control childControl


Type: System.Drawing.Graphics
The Graphics used to draw the background of the parent of childControl.
Type: System.Drawing.Rectangle
The Rectangle in which to draw the parent control's background. This rectangle should be inside the child control’s bounds.
Type: System.Windows.Forms.Control
The control whose parent's background will be drawn.

The following code example uses the DrawParentBackground method to paint over an area of a custom control. This code example is part of a larger example provided for the ButtonRenderer class.

// Draw the large or small button, depending on the current state.
protected override void OnPaint(PaintEventArgs e)

    // Draw the smaller pressed button image
    if (state == PushButtonState.Pressed)
        // Set the background color to the parent if visual styles  
        // are disabled, because DrawParentBackground will only paint  
        // over the control background if visual styles are enabled.
        this.BackColor = Application.RenderWithVisualStyles ?
            Color.Azure : this.Parent.BackColor;

        // If you comment out the call to DrawParentBackground, 
        // the background of the control will still be visible 
        // outside the pressed button, if visual styles are enabled.
            ClientRectangle, this);
        ButtonRenderer.DrawButton(e.Graphics, ClickRectangle,
            this.Text, this.Font, true, state);

    // Draw the bigger unpressed button image.
        ButtonRenderer.DrawButton(e.Graphics, ClientRectangle,
            this.Text, this.Font, false, state);

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

© 2014 Microsoft