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

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)

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 değeridir.

Örnekler

Aşağıdaki kod örneği, bir özel denetimin DrawBackground(IDeviceContext, Rectangle) OnPaint yöntemi içinde bir VisualStyleElement ç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, , Partve State özellikleri tarafından belirtilen geçerli görsel stili öğesinin Classarka planını çizer.

Width parametresi tarafından bounds belirtilen dikdörtgenin veya Height 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 GetEnumValue EnumProperty.BackgroundType. Öğenin arka planının belirtilen sınırlara uyacak şekilde ölçeklendirilip ölçeklenmeyeceğini belirlemek için yöntemini bağımsız değişken değeriyle çağırın GetEnumValue EnumProperty.SizingType.

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.

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 değeridir.

Açıklamalar

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

Width veya parametreleri tarafından belirtilen dikdörtgenin bounds veya Height clipRectangle 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 GetEnumValue EnumProperty.BackgroundType. Öğenin arka planının belirtilen sınırlara uyacak şekilde ölçeklendirilip ölçeklenmeyeceğini belirlemek için yöntemini bağımsız değişken değeriyle çağırın GetEnumValue EnumProperty.SizingType.