DrawCursorToCache

Purpose

This property enables newer cursor drawing logic (Direct2D) that draws to CacheBmp2.  This feature does require more system memory and more internal work to draw / un-draw the cursor.  Given modern systems have plenty of memory and performance, enabling should not impact your project and you can take advantage of CursorColor, CursorVLineType, CursorHLineType, and Quick Draw Annotations as shown in demo example 110.  Setting DrawCursorToCache will also automatically set ImprovedCursor True. 

If False, the cursor draws in a legacy fashion (GDI) directly to the chart's window device context. Utilizing windows api SetROP2 to quickly draw and un-draw/cleanup the cursor graphics in an efficient manner that does not require a double buffer.  Because the cursor is drawn as a NOT operation, it's color is always the inverse color of what is currently shown on the window underneath cursor. Because ProEssentials has existed since 1994 when systems were slow and Direct2D did not exist, the legacy method of drawing the cursor is quite old, but has passed the test of time and still a valid default option.  Plus, it is convient not having to worry about the CursorColor having contrast given any graph background or data color.

Given the WPF interface does not offer a per-control Window, our logic has to workaround this issue by drawing to the mainwindow's hDC, which can be challenging.  So WPF controls should set DrawCursorToCache = True. 

Comments

This property is only meaningful if CursorMode is not equal to PECM_NONE . 

See Also: CursorSubset, CursorPoint, CacheBmp2