VisualStyleRenderer.DrawBackground Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
Används IDeviceContext för att rita bakgrundsbilden.
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
Används IDeviceContext för att rita bakgrundsbilden.
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.