SystemPens Class

Definition

Each property of the SystemPens class is a Pen that is the color of a Windows display element and that has a width of 1 pixel.

public ref class SystemPens abstract sealed
public ref class SystemPens sealed
public static class SystemPens
public sealed class SystemPens
type SystemPens = class
Public Class SystemPens
Public NotInheritable Class SystemPens
Inheritance
SystemPens

Examples

The following code example creates points and sizes using several of the overloaded operators defined for these types. It also demonstrates how to use the SystemPens class.

This example is designed to be used with Windows Forms. Create a form that contains a Button named subtractButton. Paste the code into the form and call the CreatePointsAndSizes method from the form's Paint event-handling method, passing e as PaintEventArgs.

void CreatePointsAndSizes( PaintEventArgs^ e )
{
   // Create the starting point.
   Point startPoint = Point(subtractButton->Size);
   
   // Use the addition operator to get the end point.
   Point endPoint = startPoint + System::Drawing::Size( 140, 150 );
   
   // Draw a line between the points.
   e->Graphics->DrawLine( SystemPens::Highlight, startPoint, endPoint );
   
   // Convert the starting point to a size and compare it to the
   // subtractButton size.  
   System::Drawing::Size buttonSize = (System::Drawing::Size)startPoint;
   if ( buttonSize == subtractButton->Size )
   {
      e->Graphics->DrawString( "The sizes are equal.", gcnew System::Drawing::Font( this->Font,FontStyle::Italic ), Brushes::Indigo, 10.0F, 65.0F );
   }
}
private void CreatePointsAndSizes(PaintEventArgs e)
{

    // Create the starting point.
    Point startPoint = new Point(subtractButton.Size);

    // Use the addition operator to get the end point.
    Point endPoint = startPoint + new Size(140, 150);

    // Draw a line between the points.
    e.Graphics.DrawLine(SystemPens.Highlight, startPoint, endPoint);

    // Convert the starting point to a size and compare it to the
    // subtractButton size.  
    Size buttonSize = (Size)startPoint;
    if (buttonSize == subtractButton.Size)

        // If the sizes are equal, tell the user.
    {
        e.Graphics.DrawString("The sizes are equal.", 
            new Font(this.Font, FontStyle.Italic), 
            Brushes.Indigo, 10.0F, 65.0F);
    }
}
Private Sub CreatePointsAndSizes(ByVal e As PaintEventArgs)

    ' Create the starting point.
    Dim startPoint As New Point(subtractButton.Size)

    ' Use the addition operator to get the end point.
    Dim endPoint As Point = Point.op_Addition(startPoint, _
        New Size(140, 150))

    ' Draw a line between the points.
    e.Graphics.DrawLine(SystemPens.Highlight, startPoint, endPoint)

    ' Convert the starting point to a size and compare it to the
    ' subtractButton size.  
    Dim buttonSize As Size = Point.op_Explicit(startPoint)
    If (Size.op_Equality(buttonSize, subtractButton.Size)) Then

        ' If the sizes are equal, tell the user.
        e.Graphics.DrawString("The sizes are equal.", _
            New Font(Me.Font, FontStyle.Italic), _
            Brushes.Indigo, 10.0F, 65.0F)
    End If

End Sub

Remarks

Note

In .NET 6 and later versions, the System.Drawing.Common package, which includes this type, is only supported on Windows operating systems. Use of this type in cross-platform apps causes compile-time warnings and run-time exceptions. For more information, see System.Drawing.Common only supported on Windows.

Properties

ActiveBorder

Gets a Pen that is the color of the active window's border.

ActiveCaption

Gets a Pen that is the color of the background of the active window's title bar.

ActiveCaptionText

Gets a Pen that is the color of the text in the active window's title bar.

AppWorkspace

Gets a Pen that is the color of the application workspace.

ButtonFace

Gets a Pen that is the face color of a 3-D element.

ButtonHighlight

Gets a Pen that is the highlight color of a 3-D element.

ButtonShadow

Gets a Pen that is the shadow color of a 3-D element.

Control

Gets a Pen that is the face color of a 3-D element.

ControlDark

Gets a Pen that is the shadow color of a 3-D element.

ControlDarkDark

Gets a Pen that is the dark shadow color of a 3-D element.

ControlLight

Gets a Pen that is the light color of a 3-D element.

ControlLightLight

Gets a Pen that is the highlight color of a 3-D element.

ControlText

Gets a Pen that is the color of text in a 3-D element.

Desktop

Gets a Pen that is the color of the Windows desktop.

GradientActiveCaption

Gets a Pen that is the lightest color in the color gradient of an active window's title bar.

GradientInactiveCaption

Gets a Pen that is the lightest color in the color gradient of an inactive window's title bar.

GrayText

Gets a Pen that is the color of dimmed text.

Highlight

Gets a Pen that is the color of the background of selected items.

HighlightText

Gets a Pen that is the color of the text of selected items.

HotTrack

Gets a Pen that is the color used to designate a hot-tracked item.

InactiveBorder

Gets a Pen is the color of the border of an inactive window.

InactiveCaption

Gets a Pen that is the color of the title bar caption of an inactive window.

InactiveCaptionText

Gets a Pen that is the color of the text in an inactive window's title bar.

Info

Gets a Pen that is the color of the background of a ToolTip.

InfoText

Gets a Pen that is the color of the text of a ToolTip.

Menu

Gets a Pen that is the color of a menu's background.

MenuBar

Gets a Pen that is the color of the background of a menu bar.

MenuHighlight

Gets a Pen that is the color used to highlight menu items when the menu appears as a flat menu.

MenuText

Gets a Pen that is the color of a menu's text.

ScrollBar

Gets a Pen that is the color of the background of a scroll bar.

Window

Gets a Pen that is the color of the background in the client area of a window.

WindowFrame

Gets a Pen that is the color of a window frame.

WindowText

Gets a Pen that is the color of the text in the client area of a window.

Methods

FromSystemColor(Color)

Creates a Pen from the specified Color.

Applies to