GraphicsCache Class

Provides methods to paint on drawing surfaces in GDI+ and DirectX modes (see DirectX hardware acceleration). Provides storage for pens, fonts and brushes.

Namespace: DevExpress.Utils.Drawing

Assembly: DevExpress.Utils.v18.1.dll

Declaration

C#

public class GraphicsCache :
    IGraphicsCache,
    IDisposable

VB.NET

Public Class GraphicsCache
    Implements IGraphicsCache,
               IDisposable

Related API Members

The following members accept/return GraphicsCache objects:

Show 19 links

• BarItemCustomDrawEventArgs.Cache
• CustomDrawDayNumberCellEventArgs.Cache
• CustomDrawEventArgs.Cache
• CustomDrawEventArgs.Cache
• CustomDrawEventArgs.Cache
• CustomDrawObjectEventArgs.Cache
• CustomDrawObjectEventArgs.Cache
• CustomDrawObjectEventsArgs.Cache
• GalleryItemCustomDrawEventArgs.Cache
• GridControl.CreateGraphicsCache()
• LayoutViewInfoCustomizingEventArgs.Cache
• ListBoxDrawItemEventArgs.Cache
• PivotCustomDrawCellEventArgs.GraphicsCache
• PivotCustomDrawCellThreadSafeEventArgs.GraphicsCache
• PivotCustomDrawEventArgs.GraphicsCache
• PivotCustomDrawThreadSafeEventArgs.GraphicsCache
• RichEditViewCustomDrawEventArgs.Cache
• ToolTipControllerCustomDrawEventArgs.Cache
• TreeList.CreateGraphicsCache()

Remarks

The GraphicsCache class provides methods to obtain pens, fonts and brushes with specified settings. When a method is called, it first checks whether the object with the requested parameters is already stored within an internal hash table. If so, the located object is returned. Otherwise a new object with the requested parameters is created and written to the corresponding hash table.

The GraphicsCache object maintains four hash tables used to store pens, fonts and solid and linear gradient brushes. You can obtain corresponding objects via the GraphicsCache.GetPen, GraphicsCache.GetFont, GraphicsCache.GetSolidBrush and GraphicsCache.GetGradientBrush methods respectively. Note that all mentioned hash tables are initially empty.

When DirectX hardware acceleration is activated, the methods provided by the GraphicsCache object allow you to paint various graphics primitives.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the GraphicsCache class.

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#

custom-editor-timeedit-with-a-popup-window-e4060/CS/TimeEditControl/TimeEditPopupControl/TimeEditPopupControlPainter.cs#L27

public void Draw(GraphicsCache cache)
{

how-to-make-a-custom-gridview-that-takes-into-account-custom-painting-when-exporting-and-pri-e4955/CS/MyXtraGrid/MyGridView/MyGridView.cs#L36

public FooterCellCustomDrawEventArgs GetCustomDrawCellArgs(GraphicsCache cache, Rectangle rect, GridColumn col)
{

skins-how-to-manually-paint-a-button-by-using-a-skin-element-and-internal-classes-t498252/CS/DXApplication191/SkinButtonHelper.cs#L38

public void DrawButton(PaintEventArgs args, ObjectState state) {
    using (GraphicsCache cache = new GraphicsCache(args)) {
        SkinElement element = CommonSkins.GetSkin(UserLookAndFeel.Default)[CommonSkins.SkinButton];

how-to-place-any-control-to-the-detail-view-e3387/CS/GridControlDetailView/CustomGrid/CustomPainter.cs#L43

{
    public CustomViewDrawArgs(GraphicsCache graphicsCache, CustomViewInfo viewInfo, Rectangle bounds)
        : base(graphicsCache, viewInfo, bounds)

how-to-show-large-images-48x48-64x64-on-a-button-within-ribboncontrol-e3726/CS/CustomRibbonControl/CustomRibbonItemViewInfoCalculator.cs#L15

public override void CalcLargeButtonViewInfo(GraphicsCache cache, RibbonItemViewInfo item) {
    Rectangle glyph, bounds = item.Bounds;

VB.NET

custom-editor-timeedit-with-a-popup-window-e4060/VB/TimeEditControl/TimeEditPopupControl/TimeEditPopupControlPainter.vb#L24

Public Sub Draw(ByVal cache As GraphicsCache)
    DrawContent(cache)

how-to-make-a-custom-gridview-that-takes-into-account-custom-painting-when-exporting-and-pri-e4955/VB/MyXtraGrid/MyGridView/MyGridView.vb#L44

Public Function GetCustomDrawCellArgs(ByVal cache As GraphicsCache, ByVal rect As Rectangle, ByVal col As GridColumn) As FooterCellCustomDrawEventArgs
    Dim styleArgs As New GridFooterCellInfoArgs(cache)

skins-how-to-manually-paint-a-button-by-using-a-skin-element-and-internal-classes-t498252/VB/DXApplication191/SkinButtonHelper.vb#L50

Public Sub DrawButton(ByVal args As PaintEventArgs, ByVal state As ObjectState)
    Using cache As New GraphicsCache(args)
        Dim element As SkinElement = CommonSkins.GetSkin(UserLookAndFeel.Default)(CommonSkins.SkinButton)

how-to-place-any-control-to-the-detail-view-e3387/VB/GridControlDetailView/CustomGrid/CustomPainter.vb#L40

Public Sub New(ByVal graphicsCache As GraphicsCache, ByVal viewInfo As CustomViewInfo, ByVal bounds As Rectangle)
    MyBase.New(graphicsCache, viewInfo, bounds)

how-to-show-large-images-48x48-64x64-on-a-button-within-ribboncontrol-e3726/VB/CustomRibbonControl/CustomRibbonItemViewInfoCalculator.vb#L19

Public Overrides Sub CalcLargeButtonViewInfo(ByVal cache As GraphicsCache, ByVal item As RibbonItemViewInfo)
    Dim glyph As Rectangle, bounds As Rectangle = item.Bounds

Inheritance

Object

GraphicsCache