GraphicsCache.GetPen(Color, Int32) Method

Returns a pen with specified settings.

Namespace: DevExpress.Utils.Drawing

Assembly: DevExpress.Utils.v23.2.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

Declaration

C#

public Pen GetPen(
    Color color,
    int width
)

VB.NET

Public Function GetPen(
    color As Color,
    width As Integer
) As Pen

Parameters

Name	Type	Description
color	Color	A System.Drawing.Color object specifying the pen color.
width	Int32	An integer value specifying the pen width.

Returns

Type	Description
Pen	A System.Drawing.Pen object representing the requested pen.

Remarks

When the GetPen method is called, it checks whether the requested pen is already contained in an internal pens hash table. If so, the found pen is returned. Otherwise a new pen with specified parameters is created and added to an internal hash table. The hash table is initially empty. The introduced technique allows you to provide quick access to recently used pens.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GetPen(Color, Int32) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-grid-print-custom-draw-content/CS/MyXtraGrid/Form1.cs#L40

e.Appearance.FillRectangle(e.Cache, rect);
e.Cache.DrawLine(e.Cache.GetPen(Color.Red, 3), new Point(rect.X, rect.Y), new Point(rect.Right, rect.Bottom));
e.Cache.DrawEllipse(e.Cache.GetPen(Color.Red, 3), rect);

winforms-grid-copy-cell-value-to-other-cells-by-dragging-its-right-bottom-edge/CS/Classes/SelectedCellsBorderHelper.cs#L117

Rectangle rect = GetSelectionBounds();
e.Cache.DrawRectangle(e.Cache.GetPen(Color.Black, lineWidth), rect);
if(GridView.GetSelectedCells().Length == 1)

xaf-how-to-extend-the-application-model/CS/ExtendModel.Win/XafSplashScreen.cs#L16

    bounds.Width--; bounds.Height--;
    graphicsCache.Graphics.DrawRectangle(graphicsCache.GetPen(Color.FromArgb(255, 87, 87, 87), 1), bounds);
}

XAF-How-to-Implement-CRUD-Operations-for-Non-Persistent-Objects-Stored-Remotely/CS/NonPersistentObjectsDemo.Win/XafSplashScreen.cs#L25

    bounds.Width--; bounds.Height--;
    graphicsCache.Graphics.DrawRectangle(graphicsCache.GetPen(Color.FromArgb(255, 87, 87, 87), 1), bounds);
}

XAF_Non-Persistent-Objects-Filtering-Demo/CS/NonPersistentObjectsDemo.Win/XafSplashScreen.cs#L25

    bounds.Width--; bounds.Height--;
    graphicsCache.Graphics.DrawRectangle(graphicsCache.GetPen(Color.FromArgb(255, 87, 87, 87), 1), bounds);
}

VB.NET

winforms-grid-print-custom-draw-content/VB/MyXtraGrid/Form1.vb#L40

e.Appearance.FillRectangle(e.Cache, rect)
e.Cache.DrawLine(e.Cache.GetPen(Color.Red, 3), New Point(rect.X, rect.Y), New Point(rect.Right, rect.Bottom))
e.Cache.DrawEllipse(e.Cache.GetPen(Color.Red, 3), rect)

winforms-grid-copy-cell-value-to-other-cells-by-dragging-its-right-bottom-edge/VB/Classes/SelectedCellsBorderHelper.vb#L133

Dim rect As Rectangle = GetSelectionBounds()
e.Cache.DrawRectangle(e.Cache.GetPen(Color.Black, lineWidth), rect)
If GridView.GetSelectedCells().Length = 1 Then

xaf-how-to-extend-the-application-model/VB/ExtendModel.Win/XafSplashScreen.vb#L19

    bounds.Height -= 1
    graphicsCache.Graphics.DrawRectangle(graphicsCache.GetPen(Color.FromArgb(255, 87, 87, 87), 1), bounds)
End Sub

XAF-How-to-Implement-CRUD-Operations-for-Non-Persistent-Objects-Stored-Remotely/VB/NonPersistentObjectsDemo.Win/XafSplashScreen.vb#L28

    bounds.Height -= 1
    graphicsCache.Graphics.DrawRectangle(graphicsCache.GetPen(Color.FromArgb(255, 87, 87, 87), 1), bounds)
End Sub

XAF_Non-Persistent-Objects-Filtering-Demo/VB/NonPersistentObjectsDemo.Win/XafSplashScreen.vb#L28

    bounds.Height -= 1
    graphicsCache.Graphics.DrawRectangle(graphicsCache.GetPen(Color.FromArgb(255, 87, 87, 87), 1), bounds)
End Sub