VisualStyleRenderer.DrawBackground Yöntem

Tanım

Ad Alanı:

System.Windows.Forms.VisualStyles

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Geçerli görsel stili öğesinin arka plan görüntüsünü çizer.

Aşırı Yüklemeler

Name	Description
DrawBackground(IDeviceContext, Rectangle)	Belirtilen sınırlayıcı dikdörtgen içinde geçerli görsel stili öğesinin arka plan görüntüsünü çizer.
DrawBackground(IDeviceContext, Rectangle, Rectangle)	Belirtilen sınırlayıcı dikdörtgen içinde geçerli görsel stili öğesinin arka plan görüntüsünü çizer ve belirtilen kırpma dikdörtgenine kırpılır.

DrawBackground(IDeviceContext, Rectangle)

Kaynak:

VisualStyleRenderer.cs

Belirtilen sınırlayıcı dikdörtgen içinde geçerli görsel stili öğesinin arka plan görüntüsünü çizer.

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)

Parametreler

dc

IDeviceContext

IDeviceContext Arka plan resmini çizmek için kullanılır.

bounds

Rectangle

Rectangle Arka plan görüntüsünün çizildiği bir.

Özel durumlar

ArgumentNullException

dc, null'e eşittir.

Örnekler

Aşağıdaki kod örneği, bir özel denetimin DrawBackground(IDeviceContext, Rectangle)VisualStyleElement yöntemi içinde bir OnPaint çizmek için yönteminin nasıl kullanılacağını gösterir. Bu kod örneği, sınıfa genel bakış için VisualStyleRenderer sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

Bu yöntem, , Classve Part özellikleri tarafından belirtilen geçerli görsel stili öğesinin Statearka planını çizer.

Width parametresi tarafından Height belirtilen dikdörtgenin veya bounds değeri 0'dan küçükse, DrawBackground yöntem arka planı çizmeden döner.

Görsel stil öğesinin arka planı bit eşlem dosyası veya dolgulu kenarlık olabilir. Arka plan türünü belirlemek için yöntemini bağımsız değişken değeriyle çağırın GetEnumValueEnumProperty.BackgroundType. Öğe arka planının belirtilen sınırlara sığacak şekilde ölçeklendirilip ölçeklendirilmeyeceğini belirlemek için yöntemini bağımsız değişken değeriyle çağırın GetEnumValueEnumProperty.SizingType.

DrawBackground(IDeviceContext, Rectangle, Rectangle)

Kaynak:

VisualStyleRenderer.cs

Belirtilen sınırlayıcı dikdörtgen içinde geçerli görsel stili öğesinin arka plan görüntüsünü çizer ve belirtilen kırpma dikdörtgenine kırpılır.

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)

Parametreler

dc

IDeviceContext

IDeviceContext Arka plan resmini çizmek için kullanılır.

bounds

Rectangle

Rectangle Arka plan görüntüsünün çizildiği bir.

clipRectangle

Rectangle

Rectangle Çizim işlemi için bir kırpma dikdörtgeni tanımlayan.

Özel durumlar

ArgumentNullException

dc, null'e eşittir.

Açıklamalar

Bu yöntem, , Classve Part özellikleri tarafından belirtilen geçerli görsel stili öğesinin Statearka planını çizer. Arka plan parametresi tarafından clipRectangle belirtilen alana kırpılır.

Width veya parametreleri tarafından Height belirtilen dikdörtgenin veya boundsclipRectangle değeri 0'dan küçükse, DrawBackground yöntem arka planı çizmeden döner.

Görsel stil öğesinin arka planı bit eşlem dosyası veya dolgulu kenarlık olabilir. Arka plan türünü belirlemek için yöntemini bağımsız değişken değeriyle çağırın GetEnumValueEnumProperty.BackgroundType. Öğe arka planının belirtilen sınırlara sığacak şekilde ölçeklendirilip ölçeklendirilmeyeceğini belirlemek için yöntemini bağımsız değişken değeriyle çağırın GetEnumValueEnumProperty.SizingType.