Dapfor grid manual

2.2.0

MFC Grid permits you to create a complex, well-designed application only in a few lines of code. This RAD (Rapid application development) and threadsafe component supports MVC pattern and works with arbitrary C++ objects, directly inserted into the rows. These objects can be updated, sorted, filtered, highlighted in real time with the incredible speed.

The CGrid extends the MFC library and allows to display objects of arbitrary classes. These objects are displayed in CGrid by using the binding mechanism, implemented in the Common::CDataObject class. The rows of CGrid correspond to objects of arbitrary classes and columns to their functions.

The CGrid was designed to work in a heavy multi-threaded environment. Practically all functions are thread-safe. The grid offers different modes to work properly in multi-threaded applications.

Since the version 2.1.0, the MFC Grid is released under the license 2.0. Please, refer the terms and conditions of the license here.

The CGrid is compiled on the next compilers:

• VC 6.0 SP 6
• VC 8.0 SP 1
• VC 9.0

There are 12 possible configurations of the MFC Grid libraries for each compiler:

Build version	Dapfor libraries	Character set	MFC libraries	Runtime libraries	VC 6.0 library	VC 8.0 library	VC 9.0 library
Debug	static	Not set	static	/MTd	Dapfor.Grid60ds.lib	Dapfor.Grid80ds.lib	Dapfor.Grid90ds.lib
Release	static	Not set	static	/MT	Dapfor.Grid60s.lib	Dapfor.Grid80s.lib	Dapfor.Grid90s.lib
Debug	static	Unicode	static	/MTd	Dapfor.Grid60uds.lib	Dapfor.Grid80uds.lib	Dapfor.Grid90uds.lib
Release	static	Unicode	static	/MT	Dapfor.Grid60us.lib	Dapfor.Grid80us.lib	Dapfor.Grid90us.lib
Debug	static	Not set	dynamic	/MDd	Dapfor.Grid60dss.lib	Dapfor.Grid80dss.lib	Dapfor.Grid90dss.lib
Release	static	Not set	dynamic	/MD	Dapfor.Grid60ss.lib	Dapfor.Grid80ss.lib	Dapfor.Grid90ss.lib
Debug	static	Unicode	dynamic	/MDd	Dapfor.Grid60udss.lib	Dapfor.Grid80udss.lib	Dapfor.Grid90udss.lib
Release	static	Unicode	dynamic	/MD	Dapfor.Grid60uss.lib	Dapfor.Grid80uss.lib	Dapfor.Grid90uss.lib
Debug	dynamic	Not set	dynamic	/MDd	Dapfor.Grid60d.lib Dapfor.Grid60d.dll	Dapfor.Grid80d.lib Dapfor.Grid80d.dll	Dapfor.Grid90d.lib Dapfor.Grid90d.dll
Release	dynamic	Not set	dynamic	/MD	Dapfor.Grid60.lib Dapfor.Grid60.dll	Dapfor.Grid80.lib Dapfor.Grid80.dll	Dapfor.Grid90.lib Dapfor.Grid90.dll
Debug	dynamic	Unicode	dynamic	/MDd	Dapfor.Grid60ud.lib Dapfor.Grid60ud.dll	Dapfor.Grid80ud.lib Dapfor.Grid80ud.dll	Dapfor.Grid90ud.lib Dapfor.Grid90ud.dll
Release	dynamic	Unicode	dynamic	/MD	Dapfor.Grid60u.lib Dapfor.Grid60u.dll	Dapfor.Grid80u.lib Dapfor.Grid80u.dll	Dapfor.Grid90u.lib Dapfor.Grid90u.dll

Main features: MFC Grid main features:

• Model-View-Controller (MVC) pattern support.
• C++ objects in rows. In cells - values, returned by methods of these objects.
• Hierarchical data presentation.
• Auto sorting of dynamically updating C++ objects.
• Auto filtering of C++ objects at their inserting or updating.
• Auto highlighting. No timers needed to highlight cells.
• Multiple sorting through the hierarchical data.
• MFC grid compares values, returned by C++ objects, not strings shown in cells -> the rows are ordered correctly.
• High insertion speed > 150 000 rows/second.
• High removing speed > 120 000 rows/second.
• High comparing speed > 5000 sorts a grid of 3000 rows per second.
• High updating speed with highlighting > 50 000 cells/second.
• Sharing the same C++ objects between many grids -> all modifications are replicated everywhere.
• Full thread safety. The C++ objects may notify the grid from any thread.
• Dead-lock free asynchronous patterns.
• Any MFC controls in cells. The grid handles their visibility and placement automatically.
• Edit in place. The MFC grid puts the results directly into the C++ objects.
• Navigation between editable cells (Tab, KeyUp, KeyDown etc.)
• Fixed rows.
• Fixed columns.
• Resizing rows and columns.
• Filtering rows and columns.
• Flicker-free drawing.
• Background 32-bit color image.
• 32-bit color images in cells.
• Full customization (colors, fonts, alpha-blending and drawing in the CDC).
• Selection does not hide background colors.
• Copy/Edit/Paste. Copy data to Excel/Word. High speed, low memory consumption.
• Drag and drop support. Drag and drop of a hierarchical data. Drop data to Word/Excel.
• Tooltips show remaining text over partially visible cells.
• No memory leaks.
• No GDI resources leaks.
• Low memory and CPU consumption. No more huge arrays of strings that load memory and CPU.
• Fault-tolerant design.
• RAD (Rapid application development) design.
• Serialization with versions support. New versions of the MFC grid will be compatible with previous ones.
• Print and print preview.
• MFC Grid may by used in dialogs, MDI/SDI applications.
• Available in static or dynamic libraries with or without Unicode support.

Below you will find more details about the grid, some explanations, examples and 'best practices' that you can apply in your projects.

• What's new in this version?
• MFC Grid features
• Model-View-Controller (MVC) patterns and MFC grid.
• Introduction to the grids. Existing solutions.
• What is a data object?
• How to install the MFC grid and compile the first application?

FAQ and Code examples is a knowelege base, which helps you in your work with the MFC Grid.