SystemPens Class

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

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 static class SystemPens

type SystemPens = class

Public Class SystemPens

Inheritance

Object

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.