Visit Gigasoft's Web Site
 ProEssentials v11 Help

ImprovedCursor

Scope

Pego, Pesgo, Pepso

Type

Boolean/Int32

Default

FALSE

JS / .NET

PeUserInterface.Cursor.ImprovedCursor

OCX / VCL

ImprovedCursor

DLL

PEP_bIMPROVEDCURSOR

 

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. One should also set DrawCursorToCache =True. 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. 

 

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. 

 

Setting

Description

TRUE

Enable newer logic to draw cursors to CacheBmp2.

FALSE

Disabled, cursors draw to device context hDC. 

 

Comments

PeUserInterface.Cursor.ImprovedCursor members of Pego.PeUserInterface.Cursor, Pesgo.PeUserInterface.Cursor, Pepso.PeUserInterface.Cursor

 

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

 

See Also: DrawCursorToCache, CursorSubset, CursorPoint, CacheBmp2