VisualStyleRenderer.DrawBackground Méthode

public:
 void DrawBackground(System::Drawing::IDeviceContext ^ dc, System::Drawing::Rectangle bounds);

public void DrawBackground (System.Drawing.IDeviceContext dc, System.Drawing.Rectangle bounds);

member this.DrawBackground : System.Drawing.IDeviceContext * System.Drawing.Rectangle -> unit

Public Sub DrawBackground (dc As IDeviceContext, bounds As Rectangle)

Paramètres

Exceptions

Exemples

L’exemple de code suivant montre comment utiliser la méthode DrawBackground(IDeviceContext, Rectangle) pour dessiner un VisualStyleElement dans la méthode OnPaint d’un contrôle personnalisé. Cet exemple de code fait partie d’un exemple plus large fourni pour la vue d’ensemble de la classe VisualStyleRenderer.

protected:
    virtual void OnPaint(PaintEventArgs^ e) override
    {
        __super::OnPaint(e);

        // Ensure that visual styles are supported.
        if (!Application::RenderWithVisualStyles)
        {
            this->Text = "Visual styles are not enabled.";
            TextRenderer::DrawText(e->Graphics, this->Text,
                this->Font, this->Location, this->ForeColor);
            return;
        }

        // Set the clip region to define the curved corners
        // of the caption.
        SetClipRegion();

        // Draw each part of the window.
        for each(KeyValuePair<String^, VisualStyleElement^>^ entry
            in windowElements)
        {
            if (SetRenderer(entry->Value))
            {
                renderer->DrawBackground(e->Graphics,
                    elementRectangles[entry->Key]);
            }
        }

        // Draw the caption text.
        TextRenderer::DrawText(e->Graphics, this->Text, this->Font,
            elementRectangles["windowCaption"], Color::White,
            TextFormatFlags::VerticalCenter |
            TextFormatFlags::HorizontalCenter);
    }

protected override void OnPaint(PaintEventArgs e)
{
    base.OnPaint(e);

    // Ensure that visual styles are supported.
    if (!Application.RenderWithVisualStyles)
    {
        this.Text = "Visual styles are not enabled.";
        TextRenderer.DrawText(e.Graphics, this.Text,
            this.Font, this.Location, this.ForeColor);
        return;
    }

    // Set the clip region to define the curved corners 
    // of the caption.
    SetClipRegion();

    // Draw each part of the window.
    foreach (KeyValuePair<string, VisualStyleElement> entry
        in windowElements)
    {
        if (SetRenderer(entry.Value))
        {
            renderer.DrawBackground(e.Graphics,
                elementRectangles[entry.Key]);
        }
    }

    // Draw the caption text.
    TextRenderer.DrawText(e.Graphics, this.Text, this.Font,
        elementRectangles["windowCaption"], Color.White,
        TextFormatFlags.VerticalCenter |
        TextFormatFlags.HorizontalCenter);
}

Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
    MyBase.OnPaint(e)

    ' Ensure that visual styles are supported.
    If Not Application.RenderWithVisualStyles Then
        Me.Text = "Visual styles are not enabled."
        TextRenderer.DrawText(e.Graphics, Me.Text, Me.Font, _
            Me.Location, Me.ForeColor)
        Return
    End If

    ' Set the clip region to define the curved corners of 
    ' the caption.
    SetClipRegion()

    ' Draw each part of the window.
    Dim entry As KeyValuePair(Of String, VisualStyleElement)
    For Each entry In windowElements
        If SetRenderer(entry.Value) Then
            renderer.DrawBackground(e.Graphics, _
                elementRectangles(entry.Key))
        End If
    Next entry

    ' Draw the caption text.
    TextRenderer.DrawText(e.Graphics, Me.Text, Me.Font, _
        elementRectangles("windowCaption"), Color.White, _
        TextFormatFlags.VerticalCenter Or _
        TextFormatFlags.HorizontalCenter)
End Sub

Remarques

Cette méthode dessine l’arrière-plan de l’élément de style visuel actuel spécifié par les propriétés Class, Partet State.

Si la Width ou la Height du rectangle spécifié par le paramètre bounds est inférieure à 0, la méthode DrawBackground retourne sans dessiner l’arrière-plan.

L’arrière-plan d’un élément de style visuel peut être un fichier bitmap ou une bordure remplie. Pour déterminer le type d’arrière-plan, appelez la méthode GetEnumValue avec une valeur d’argument de EnumProperty.BackgroundType. Pour déterminer si l’arrière-plan de l’élément s’adapte aux limites spécifiées, appelez la méthode GetEnumValue avec une valeur d’argument de EnumProperty.SizingType.

public:
 void DrawBackground(System::Drawing::IDeviceContext ^ dc, System::Drawing::Rectangle bounds, System::Drawing::Rectangle clipRectangle);

public void DrawBackground (System.Drawing.IDeviceContext dc, System.Drawing.Rectangle bounds, System.Drawing.Rectangle clipRectangle);

member this.DrawBackground : System.Drawing.IDeviceContext * System.Drawing.Rectangle * System.Drawing.Rectangle -> unit

Public Sub DrawBackground (dc As IDeviceContext, bounds As Rectangle, clipRectangle As Rectangle)

Paramètres

Exceptions

Remarques

Cette méthode dessine l’arrière-plan de l’élément de style visuel actuel spécifié par les propriétés Class, Partet State. L’arrière-plan est coupé dans la zone spécifiée par le paramètre clipRectangle.

Si le Width ou Height du rectangle spécifié par les paramètres bounds ou clipRectangle est inférieur à 0, la méthode DrawBackground retourne sans dessiner l’arrière-plan.

L’arrière-plan d’un élément de style visuel peut être un fichier bitmap ou une bordure remplie. Pour déterminer le type d’arrière-plan, appelez la méthode GetEnumValue avec une valeur d’argument de EnumProperty.BackgroundType. Pour déterminer si l’arrière-plan de l’élément s’adapte aux limites spécifiées, appelez la méthode GetEnumValue avec une valeur d’argument de EnumProperty.SizingType.