This topic has not yet been rated - Rate this topic

SystemPens Class

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.

System.Object
  System.Drawing.SystemPens

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)
public sealed class SystemPens

The SystemPens type exposes the following members.

  Name Description
Public property Static member ActiveBorder Gets a Pen that is the color of the active window's border.
Public property Static member ActiveCaption Gets a Pen that is the color of the background of the active window's title bar.
Public property Static member ActiveCaptionText Gets a Pen that is the color of the text in the active window's title bar.
Public property Static member AppWorkspace Gets a Pen that is the color of the application workspace.
Public property Static member ButtonFace Gets a Pen that is the face color of a 3-D element.
Public property Static member ButtonHighlight Gets a Pen that is the highlight color of a 3-D element.
Public property Static member ButtonShadow Gets a Pen that is the shadow color of a 3-D element.
Public property Static member Control Gets a Pen that is the face color of a 3-D element.
Public property Static member ControlDark Gets a Pen that is the shadow color of a 3-D element.
Public property Static member ControlDarkDark Gets a Pen that is the dark shadow color of a 3-D element.
Public property Static member ControlLight Gets a Pen that is the light color of a 3-D element.
Public property Static member ControlLightLight Gets a Pen that is the highlight color of a 3-D element.
Public property Static member ControlText Gets a Pen that is the color of text in a 3-D element.
Public property Static member Desktop Gets a Pen that is the color of the Windows desktop.
Public property Static member GradientActiveCaption Gets a Pen that is the lightest color in the color gradient of an active window's title bar.
Public property Static member GradientInactiveCaption Gets a Pen that is the lightest color in the color gradient of an inactive window's title bar.
Public property Static member GrayText Gets a Pen that is the color of dimmed text.
Public property Static member Highlight Gets a Pen that is the color of the background of selected items.
Public property Static member HighlightText Gets a Pen that is the color of the text of selected items.
Public property Static member HotTrack Gets a Pen that is the color used to designate a hot-tracked item.
Public property Static member InactiveBorder Gets a Pen is the color of the border of an inactive window.
Public property Static member InactiveCaption Gets a Pen that is the color of the title bar caption of an inactive window.
Public property Static member InactiveCaptionText Gets a Pen that is the color of the text in an inactive window's title bar.
Public property Static member Info Gets a Pen that is the color of the background of a ToolTip.
Public property Static member InfoText Gets a Pen that is the color of the text of a ToolTip.
Public property Static member Menu Gets a Pen that is the color of a menu's background.
Public property Static member MenuBar Gets a Pen that is the color of the background of a menu bar.
Public property Static member MenuHighlight Gets a Pen that is the color used to highlight menu items when the menu appears as a flat menu.
Public property Static member MenuText Gets a Pen that is the color of a menu's text.
Public property Static member ScrollBar Gets a Pen that is the color of the background of a scroll bar.
Public property Static member Window Gets a Pen that is the color of the background in the client area of a window.
Public property Static member WindowFrame Gets a Pen that is the color of a window frame.
Public property Static member WindowText Gets a Pen that is the color of the text in the client area of a window.
Top
  Name Description
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method Static member FromSystemColor Creates a Pen from the specified Color.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Top

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.


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);
    }

}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ