VisualStyleRenderer.DrawBackground Methode

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DrawBackground(IDeviceContext, Rectangle) -Methode verwenden, um eine VisualStyleElement in der Methode eines benutzerdefinierten Steuerelements OnPaint zu zeichnen. Dieses Codebeispiel ist Teil eines größeren Beispiels für die VisualStyleRenderer Klassenübersicht.

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

Hinweise

Diese Methode zeichnet den Hintergrund des aktuellen visuellen Stilelements, das durch die ClassEigenschaften , Partund State angegeben wird.

Wenn das Width oder Height des durch den bounds Parameter angegebenen Rechtecks kleiner als 0 ist, gibt die DrawBackground Methode zurück, ohne den Hintergrund zu zeichnen.

Der Hintergrund eines visuellen Stilelements kann eine Bitmapdatei oder ein gefüllter Rahmen sein. Um den Hintergrundtyp zu bestimmen, rufen Sie die GetEnumValue -Methode mit dem Argumentwert auf EnumProperty.BackgroundType. Um zu bestimmen, ob der Elementhintergrund an die angegebenen Grenzen skaliert wird, rufen Sie die -Methode mit dem GetEnumValue Argumentwert von auf 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)

Parameter

Ausnahmen

Hinweise

Diese Methode zeichnet den Hintergrund des aktuellen visuellen Stilelements, das durch die ClassEigenschaften , Partund State angegeben wird. Der Hintergrund wird auf den durch den clipRectangle Parameter angegebenen Bereich zugeschnitten.

Wenn das Width oder Height des durch den bounds Parameter oder clipRectangle angegebenen Rechtecks kleiner als 0 ist, gibt die DrawBackground Methode zurück, ohne den Hintergrund zu zeichnen.

Der Hintergrund eines visuellen Stilelements kann eine Bitmapdatei oder ein gefüllter Rahmen sein. Um den Hintergrundtyp zu bestimmen, rufen Sie die GetEnumValue -Methode mit dem Argumentwert auf EnumProperty.BackgroundType. Um zu bestimmen, ob der Elementhintergrund an die angegebenen Grenzen skaliert wird, rufen Sie die -Methode mit dem GetEnumValue Argumentwert von auf EnumProperty.SizingType.