VisualStyleRenderer.DrawBackground Metod

Definition

Ritar bakgrundsbilden av det aktuella visuella formatelementet.

Överlagringar

Name Description
DrawBackground(IDeviceContext, Rectangle)

Ritar bakgrundsbilden av det aktuella visuella formatelementet inom den angivna rektangeln för avgränsning.

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Ritar bakgrundsbilden av det aktuella visualiseringsformatelementet inom den angivna rektangeln för avgränsning och klipps till den angivna urklippsrektangeln.

DrawBackground(IDeviceContext, Rectangle)

Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs

Ritar bakgrundsbilden av det aktuella visuella formatelementet inom den angivna rektangeln för avgränsning.

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)

Parametrar

dc
IDeviceContext

Används IDeviceContext för att rita bakgrundsbilden.

bounds
Rectangle

En Rectangle där bakgrundsbilden ritas.

Undantag

dc är null.

Exempel

I följande kodexempel visas hur du använder DrawBackground(IDeviceContext, Rectangle) metoden för att rita en VisualStyleElement i en anpassad kontrolls OnPaint metod. Det här kodexemplet är en del av ett större exempel som tillhandahålls för klassöversikten 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

Kommentarer

Den här metoden ritar bakgrunden för det aktuella visualiseringsformatelementet som anges av Classegenskaperna , Partoch State .

Width Om rektangeln eller Height som anges av parametern bounds är mindre än 0 DrawBackground returnerar metoden utan att rita bakgrunden.

Bakgrunden för ett visuellt formatelement kan vara en bitmappsfil eller en fylld kantlinje. Om du vill fastställa bakgrundstypen anropar du GetEnumValue metoden med argumentvärdet EnumProperty.BackgroundType. För att avgöra om elementbakgrunden ska skalas för att passa de angivna gränserna anropar GetEnumValue du metoden med ett argumentvärde på EnumProperty.SizingType.

Gäller för

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs
Källa:
VisualStyleRenderer.cs

Ritar bakgrundsbilden av det aktuella visualiseringsformatelementet inom den angivna rektangeln för avgränsning och klipps till den angivna urklippsrektangeln.

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)

Parametrar

dc
IDeviceContext

Används IDeviceContext för att rita bakgrundsbilden.

bounds
Rectangle

En Rectangle där bakgrundsbilden ritas.

clipRectangle
Rectangle

En Rectangle som definierar en urklippsrektangel för ritningsåtgärden.

Undantag

dc är null.

Kommentarer

Den här metoden ritar bakgrunden för det aktuella visualiseringsformatelementet som anges av Classegenskaperna , Partoch State . Bakgrunden klipps till det område som anges av parametern clipRectangle .

Width Om rektangeln eller Height som anges av antingen parametrarna bounds eller clipRectangle är mindre än 0 DrawBackground returnerar metoden utan att rita bakgrunden.

Bakgrunden för ett visuellt formatelement kan vara en bitmappsfil eller en fylld kantlinje. Om du vill fastställa bakgrundstypen anropar du GetEnumValue metoden med argumentvärdet EnumProperty.BackgroundType. För att avgöra om elementbakgrunden ska skalas för att passa de angivna gränserna anropar GetEnumValue du metoden med ett argumentvärde på EnumProperty.SizingType.

Gäller för