ButtonRenderer.DrawParentBackground メソッド

.NET Framework クラス ライブラリ リファレンス

ButtonRenderer.DrawParentBackground メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した領域にコントロールの親の背景を描画します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub DrawParentBackground
 ( _
    g As Graphics, _
    bounds As Rectangle, _
    childControl As Control _
)

Visual Basic (使用法)

Dim g As Graphics
Dim bounds As Rectangle
Dim childControl As Control

ButtonRenderer.DrawParentBackground(g, bounds, childControl)

C#

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

C++

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

J#

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

JScript

public static function DrawParentBackground
 (
    g : Graphics, 
    bounds : Rectangle, 
    childControl : Control
)

パラメータ

g

childControl の親の背景を描画するときに使用する Graphics。

bounds

親コントロールの背景を描画する Rectangle。この四角形は、子コントロールの境界内に存在する必要があります。

childControl

親の背景が描画されるコントロール。

使用例

DrawParentBackground メソッドを使用して、カスタム コントロールの領域を塗りつぶすコード例を、次に示します。このコード例は、ButtonRenderer クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Draw the large or small button, depending on the current state.
Protected Overrides Sub
 OnPaint(ByVal e As PaintEventArgs)
    MyBase.OnPaint(e)

    ' Draw the smaller pressed button image.
    If state = PushButtonState.Pressed Then
        ' 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.
        If Application.RenderWithVisualStyles Then
            Me.BackColor = Color.Azure
        Else
            Me.BackColor = Me.Parent.BackColor
        End If

        ' 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.
        ButtonRenderer.DrawParentBackground(e.Graphics, _
            Me.ClientRectangle, Me)
        ButtonRenderer.DrawButton(e.Graphics, ClickRectangle, _
            Me.Text, Me.Font, True,
 state)

    ' Draw the bigger unpressed button image.
    Else
        ButtonRenderer.DrawButton(e.Graphics, Me.ClientRectangle,
 _
            Me.Text, Me.Font, False,
 state)
    End If
End Sub

C#

// Draw the large or small button, depending on the current state.
protected override void OnPaint(PaintEventArgs
 e)
{
    base.OnPaint(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.
        ButtonRenderer.DrawParentBackground(e.Graphics,
            ClientRectangle, this);
        ButtonRenderer.DrawButton(e.Graphics, ClickRectangle,
            this.Text, this.Font, true,
 state);
    }

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

C++

    // Draw the large or small button, depending on the current state.
protected:
    virtual void OnPaint(PaintEventArgs^ e) override
    {
        __super::OnPaint(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.
            if (Application::RenderWithVisualStyles)
            {
                this->BackColor = Color::Azure;
            }
            else
            {
                this->BackColor = 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.
            ButtonRenderer::DrawParentBackground(e->Graphics,
                ClientRectangle, this);
            ButtonRenderer::DrawButton(e->Graphics, ClickRectangle,
                this->Text, this->Font,
 true, state);
        }

        // Draw the bigger unpressed button image.
        else
        {
            ButtonRenderer::DrawButton(e->Graphics, ClientRectangle,
                this->Text, this->Font,
 false, state);
        }
    }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ButtonRenderer クラス
ButtonRenderer メンバ
System.Windows.Forms 名前空間