VisualStyleElement.Window.Caption Class

Reference

Definition

Namespace:: System.Windows.Forms.VisualStyles

Assembly:: System.Windows.Forms.dll

Source:: VisualStyleElement.cs

Source:: VisualStyleElement.cs

Source:: VisualStyleElement.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides VisualStyleElement objects for each state of the title bar of a window. This class cannot be inherited.

public: ref class VisualStyleElement::Window::Caption abstract sealed

public static class VisualStyleElement.Window.Caption

type VisualStyleElement.Window.Caption = class

Public Class VisualStyleElement.Window.Caption

Inheritance: Object
VisualStyleElement.Window.Caption

Examples

The following code example demonstrates how to create a VisualStyleRenderer with the VisualStyleElement returned by the Active property. To run this example, paste it into a Windows Form. Handle the form's Paint event and call the DrawVisualStyleElementWindowCaption1 method from the Paint event-handling method, passing e as PaintEventArgs.

public void DrawVisualStyleElementWindowCaption1(PaintEventArgs e)
{
    if (VisualStyleRenderer.IsElementDefined(
        VisualStyleElement.Window.Caption.Active))
    {
        VisualStyleRenderer renderer =
             new VisualStyleRenderer(VisualStyleElement.Window.Caption.Active);
        Rectangle rectangle1 = new Rectangle(10, 50, 50, 50);
        renderer.DrawBackground(e.Graphics, rectangle1);
        e.Graphics.DrawString("VisualStyleElement.Window.Caption.Active",
             this.Font, Brushes.Black, new Point(10, 10));
    }
    else
        e.Graphics.DrawString("This element is not defined in the current visual style.",
             this.Font, Brushes.Black, new Point(10, 10));
}

Public Sub DrawVisualStyleElementWindowCaption1(ByVal e As PaintEventArgs)
    If (VisualStyleRenderer.IsElementDefined( _
     VisualStyleElement.Window.Caption.Active)) Then
        Dim renderer As New VisualStyleRenderer _
          (VisualStyleElement.Window.Caption.Active)
        Dim rectangle1 As New Rectangle(10, 50, 50, 50)
        renderer.DrawBackground(e.Graphics, rectangle1)
        e.Graphics.DrawString("VisualStyleElement.Window.Caption.Active", _
          Me.Font, Brushes.Black, New Point(10, 10))
    Else
        e.Graphics.DrawString("This element is not defined in the current visual style.", _
          Me.Font, Brushes.Black, New Point(10, 10))
    End If
End Sub

Remarks

Each property of the VisualStyleElement.Window.Caption class returns a VisualStyleElement for a different state of the title bar of a window.

Properties

Active	Gets a visual style element that represents the title bar of an active window.
Disabled	Gets a visual style element that represents the title bar of a disabled window.
Inactive	Gets a visual style element that represents the title bar of an inactive window.

Applies to

Product	Versions
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via