VisualStyleRenderer.DrawBackground Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms.VisualStyles

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Dessine l'image d'arrière-plan de l'élément de style visuel en cours.

Surcharges

DrawBackground(IDeviceContext, Rectangle)	Dessine l'image d'arrière-plan de l'élément de style visuel en cours dans le rectangle englobant spécifié.
DrawBackground(IDeviceContext, Rectangle, Rectangle)	Dessine l'image d'arrière-plan de l'élément de style visuel en cours au sein du rectangle englobant spécifié et découpée selon le rectangle de découpage spécifié.

DrawBackground(IDeviceContext, Rectangle)

Dessine l'image d'arrière-plan de l'élément de style visuel en cours dans le rectangle englobant spécifié.

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

dc: IDeviceContext

IDeviceContext utilisé pour dessiner l'image d'arrière-plan.

bounds: Rectangle

Rectangle au sein duquel l'image d'arrière-plan est dessinée.

Exceptions

ArgumentNullException

dc a la valeur null.

Exemples

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

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 et State les Class Partpropriétés.

Si le Width Height rectangle spécifié par le bounds paramètre est inférieur à 0, la DrawBackground méthode 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 GetEnumValue méthode avec une valeur d’argument de EnumProperty.BackgroundType. Pour déterminer si l’arrière-plan de l’élément est mis à l’échelle pour ajuster les limites spécifiées, appelez la GetEnumValue méthode avec une valeur d’argument de EnumProperty.SizingType.

S’applique à

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Dessine l'image d'arrière-plan de l'élément de style visuel en cours au sein du rectangle englobant spécifié et découpée selon le rectangle de découpage spécifié.

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

dc: IDeviceContext

IDeviceContext utilisé pour dessiner l'image d'arrière-plan.

bounds: Rectangle

Rectangle au sein duquel l'image d'arrière-plan est dessinée.

clipRectangle: Rectangle

Rectangle qui définit un rectangle de découpage pour l'opération de dessin.

Exceptions

ArgumentNullException

dc a la valeur null.

Remarques

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

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

S’applique à

Share via

VisualStyleRenderer.DrawBackground Méthode

Définition

Surcharges

DrawBackground(IDeviceContext, Rectangle)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires