VisualStyleRenderer.DrawBackground Methode

Definition

Namespace:: System.Windows.Forms.VisualStyles

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements.

Überlädt

Name	Beschreibung
DrawBackground(IDeviceContext, Rectangle)	Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen umgebenden Rechtecks.
DrawBackground(IDeviceContext, Rectangle, Rectangle)	Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen Umgebenden Rechtecks und wird auf das angegebene Beschneidungsrechteck zugeschnitten.

DrawBackground(IDeviceContext, Rectangle)

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen umgebenden Rechtecks.

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

Wird IDeviceContext zum Zeichnen des Hintergrundbilds verwendet.

bounds: Rectangle

A Rectangle , in dem das Hintergrundbild gezeichnet wird.

Ausnahmen

ArgumentNullException

dc ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Methode zum Zeichnen einer Zeichnung innerhalb der Methode eines benutzerdefinierten Steuerelements veranschaulicht.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.

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 Class, Partund State Eigenschaften angegeben wird.

Wenn das Width Height durch den bounds Parameter angegebene Rechteck kleiner als 0 ist, wird die DrawBackground Methode ohne Zeichnung des Hintergrunds zurückgegeben.

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 einem Argumentwert von EnumProperty.BackgroundType. Um zu bestimmen, ob der Elementhintergrund an die angegebenen Grenzen angepasst wird, rufen Sie die GetEnumValue Methode mit einem Argumentwert von EnumProperty.SizingType.

Gilt für:

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Quelle:: VisualStyleRenderer.cs

Zeichnet das Hintergrundbild des aktuellen visuellen Stilelements innerhalb des angegebenen Umgebenden Rechtecks und wird auf das angegebene Beschneidungsrechteck zugeschnitten.

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

Wird IDeviceContext zum Zeichnen des Hintergrundbilds verwendet.

bounds: Rectangle

A Rectangle , in dem das Hintergrundbild gezeichnet wird.

clipRectangle: Rectangle

A Rectangle that defines a clipping rectangle for the drawing operation.

Ausnahmen

ArgumentNullException

dc ist null.

Hinweise

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

Wenn das Width Height durch die bounds Parameter clipRectangle angegebene Rechteck oder das Rechteck kleiner als 0 ist, wird die DrawBackground Methode ohne Zeichnung des Hintergrunds zurückgegeben.

Gilt für:

Feedback

War diese Seite hilfreich?