VisualStyleRenderer.DrawBackground Methode

Definition

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements.Draws the background image of the current visual style element.

Überlädt

DrawBackground(IDeviceContext, Rectangle)

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen umschließenden Rechtecks.Draws the background image of the current visual style element within the specified bounding rectangle.

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen umschließenden Rechtecks und eingegrenzt auf das Auswahlrechteck.Draws the background image of the current visual style element within the specified bounding rectangle and clipped to the specified clipping rectangle.

DrawBackground(IDeviceContext, Rectangle)

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen umschließenden Rechtecks.Draws the background image of the current visual style element within the specified bounding rectangle.

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

dc
IDeviceContext

Der zum Zeichnen des Hintergrundbilds verwendete IDeviceContext.The IDeviceContext used to draw the background image.

bounds
Rectangle

Ein Rectangle, in dem das Hintergrundbild gezeichnet wird.A Rectangle in which the background image is drawn.

Ausnahmen

dc ist null.dc is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DrawBackground(IDeviceContext, Rectangle) -Methode verwendet wird, um eine VisualStyleElement innerhalb der-Methode eines benutzerdefinierten Steuer Elements zu zeichnen OnPaint .The following code example demonstrates how to use the DrawBackground(IDeviceContext, Rectangle) method to a draw a VisualStyleElement within a custom control's OnPaint method. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die VisualStyleRenderer Klassen Übersicht bereitgestellt wird.This code example is part of a larger example provided for the VisualStyleRenderer class overview.

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 Stil Elements, das von den Class Eigenschaften, und angegeben wird Part State .This method draws the background of the current visual style element specified by the Class, Part, and State properties.

Wenn das Width oder Height des Rechtecks, das durch den- bounds Parameter angegeben ist, kleiner als 0 ist, DrawBackground gibt die Methode zurück, ohne den Hintergrund zu zeichnen.If the Width or Height of the rectangle specified by the bounds parameter is less than 0, the DrawBackground method will return without drawing the background.

Der Hintergrund eines visuellen Stil Elements kann eine Bitmapdatei oder ein ausgefüllter Rahmen sein.The background of a visual style element can be a bitmap file or a filled border. Um den Hintergrundtyp zu bestimmen, müssen Sie die- GetEnumValue Methode mit einem Argument Wert von abrufen EnumProperty.BackgroundType .To determine the background type, call the GetEnumValue method with an argument value of EnumProperty.BackgroundType. Um zu ermitteln, ob der Element Hintergrund in die angegebenen Begrenzungen skaliert wird, müssen Sie die- GetEnumValue Methode mit einem Argument Wert von abrufen EnumProperty.SizingType .To determine whether the element background will scale to fit the specified bounds, call the GetEnumValue method with an argument value of EnumProperty.SizingType.

Gilt für:

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen umschließenden Rechtecks und eingegrenzt auf das Auswahlrechteck.Draws the background image of the current visual style element within the specified bounding rectangle and clipped to the specified clipping rectangle.

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

dc
IDeviceContext

Der zum Zeichnen des Hintergrundbilds verwendete IDeviceContext.The IDeviceContext used to draw the background image.

bounds
Rectangle

Ein Rectangle, in dem das Hintergrundbild gezeichnet wird.A Rectangle in which the background image is drawn.

clipRectangle
Rectangle

Ein Rectangle, das ein Auswahlrechteck für den Zeichenvorgang definiert.A Rectangle that defines a clipping rectangle for the drawing operation.

Ausnahmen

dc ist null.dc is null.

Hinweise

Diese Methode zeichnet den Hintergrund des aktuellen visuellen Stil Elements, das von den Class Eigenschaften, und angegeben wird Part State .This method draws the background of the current visual style element specified by the Class, Part, and State properties. Der Hintergrund wird auf den Bereich zugeschnitten, der durch den- clipRectangle Parameter angegeben wird.The background will be clipped to the area specified by the clipRectangle parameter.

Wenn Width oder Height des Rechtecks, das durch den- bounds Parameter oder den-Parameter angegeben clipRectangle wird, kleiner als 0 ist, DrawBackground gibt die Methode zurück, ohne den Hintergrund zu zeichnen.If the Width or Height of the rectangle specified by either the bounds or clipRectangle parameters is less than 0, the DrawBackground method will return without drawing the background.

Der Hintergrund eines visuellen Stil Elements kann eine Bitmapdatei oder ein ausgefüllter Rahmen sein.The background of a visual style element can be a bitmap file or a filled border. Um den Hintergrundtyp zu bestimmen, müssen Sie die- GetEnumValue Methode mit einem Argument Wert von abrufen EnumProperty.BackgroundType .To determine the background type, call the GetEnumValue method with an argument value of EnumProperty.BackgroundType. Um zu ermitteln, ob der Element Hintergrund in die angegebenen Begrenzungen skaliert wird, müssen Sie die- GetEnumValue Methode mit einem Argument Wert von abrufen EnumProperty.SizingType .To determine whether the element background will scale to fit the specified bounds, call the GetEnumValue method with an argument value of EnumProperty.SizingType.

Gilt für: