gridctrl.shtml

MFC 打印效果 超好的学习例子

<!--#include virtual="header.shtml" -->

<!-- Title -->
<CENTER><H3><FONT COLOR="#AOAO99">MFC Grid control (derived from CWnd)</FONT></H3></CENTER>

<HR>

This article was contributed by <A HREF="mailto:[e-mail]">Chris Maunder</A>.


<P>Copyright &copy; 1998-1999 Chris Maunder</A>.

<!-- Image and download files -->
<P><IMG SRC="gridctrl.gif" ALT="gridctrl example image" width="341" height="228" BORDER=0  ALIGN=BOTTOM>
Download <A HREF="gridctrl_src.zip">source files</A> (56 Kb) or 
<A HREF="gridctrl_demo.zip">sample project</A> (101 Kb).

<h4>Check out latest changes (version 1.12) <a href="gridctrl.shtml#New">here</a>.</h4>

<p>Environment: VC++ 5.0, VC 6.0 SP1, NT 4.0 (SP3,4), Win95/98, WinCE 2.0/2.11<br>

<!-- TOC -->
<p>
<TABLE CELLSPACING=5 WIDTH="90%">
<tr>
<td><a href="gridctrl.shtml#Introduction">Introduction</a></td>
<td><a href="gridctrl.shtml#Appearance">General appearance and features</a></td>
<td><a href="gridctrl.shtml#Structures">Structures, defines and Messages</a></td>
</tr>
<tr>
<td><a href="gridctrl.shtml#Files">Files</a></td>
<td><a href="gridctrl.shtml#Colours">Colours</a></td>
<td><a href="gridctrl.shtml#Overrides">Protected overridable functions</a></td>
</tr>
<tr>
<td><a href="gridctrl.shtml#Constuction">Constuction</a></td>
<td><a href="gridctrl.shtml#CellInfo">General cell information</a></td>
<td><a href="gridctrl.shtml#Clipboard">Clipboard</a></td>
</tr>
<tr>
<td><a href="gridctrl.shtml#NumRowsCols">Number of rows and columns</a></td>
<td><a href="gridctrl.shtml#Operations">Operations</a></td>
<td><a href="gridctrl.shtml#Acknowledgements">Acknowledgements</a></td>
</tr>
<tr>
<td><a href="gridctrl.shtml#Sizing">Sizing and position functions</a></td>
<td><a href="gridctrl.shtml#Printing">Printing</a></td>
<td><a href="gridctrl.shtml#History">History</a></td>
</tr>
</table>

<br><br>

<!-- the article... -->

<h3><a name="Introduction">Introduction</a></h3>
<P>After pushing the CListCtrl to its limits in trying to display and edit
tabulated data I decided what was really needed was a dedicated grid control.
I started writing my own grid control from scratch but decided to save
time by modifying <A HREF="mailto:[e-mail]">Joe Willcoxson's</A>
free WorldCom grid control at <A HREF="http://users.aol.com/chinajoe/wcmfclib.html">
http://users.aol.com/chinajoe/wcmfclib.html</A>. I tore apert his code and 
rebuilt it from the ground up in order to get it to do all the things I needed.
The code has gone through so many modifications that I'm not sure if there is 
even a single original line of code. In any case Joe's code was a great framework 
on which to build.

<P>The project started out as a simple clean up but very quickly ballooned
into a bit of a nightmare as I kept finding new features that I felt just
<I>had</I> to go into it. It has not been tested exhaustively - but I'm
fairly confident that it won't fall over too badly :). Joe was kind enough
to allow me to release the source with no strings attached (since it is
based on his code) but since the project was such a marathon I am placing
a couple of very minor conditions on the use of this code:

<br><br>
<CENTER><TABLE WIDTH="80%" border=1>
<TR>
<TD><I>This file may be redistributed unmodified by any means PROVIDING
it is not sold for profit without the authors written consent, and providing
that this notice and the authors name and all copyright notices remains
intact. This code may be used in compiled form in any way you desire with
the following conditions. If the source code in this file is used in any
commercial application then a statement along the lines of "Portions copyright
(c) Chris Maunder, 1998-1999" must be included in the startup banner, "About"
box or printed documentation. The source code may not be compiled into
a standalone library and sold for profit. Besides - it's free to whoever
wants it anyway! <br><br><b>This software is provided "as is" without 
express or implied warranty. Use it at your own risk!</b> <br>
Whilst I have made every effort to remove any undesirable "features", 
I cannot be held responsible if it causes any damage or loss of time or 
data.</I></TD>
</TR>
</TABLE></CENTER>
<br><br>

Hopefully that isn't too much to ask considering the amount of work that
went into this. If you <I>do</I> use it in a commercial application then
<B>please</B> send me an <A HREF="mailto:[e-mail]">email</A>
letting me know. There's no point in me releasing and maintaining/upgrading
this thing if no one is gonna use it.

<p>The control features:
<ul>
<li>Cell selection using the mouse, with optional Control and Shift key
    combinations. Selection can be disabled.
<li>Row and Column resizing. Sizing can be diabled for row, columns or both.
<li>Auto row or column sizing when dividers are double-clicked.
<li>Any number of fixed rows and columns.
<li>Individual cells can have separate text and background colours.
<li>Individual cells can have separate fonts.
<li>Individaul cells can be marked "Read-Only", or have their modification status
    set and checked.
<li>OLE Drag and drop.
<li>Ctrl-C, Ctrl-X and Ctrl-V perform clipboard copy, cut and paste, and Ctrl-A for
    "Select All"
<li>In place editing of cell contents. If a character key is pressed while
    a cell has focus, editing will start on that cell, and the arrow keys
    will allow navigation to other keys. If the current focus cell is clicked
    on, editing will start and the arrow keys will move the carot inside the 
    edit control. Editing can be disabled.
<li>Support for Microsoft intellimouse.
<li>Optional grid lines.
<li>Images in any cell
<li>Full printing support, for either a Doc/View environment (inc Print
    preview) or a standalone dialog based app (no print preview).
<li>Optional "List mode", including full row selection, single row selection,
    and sort on column header click.
<li>Numerous virtual functions to allow this control to be extended very easily.
<li>UNICODE support.
<li>WinCE support
<li>Titletips for cells that are too small to display their data.
<li>Compiles under VC 4.2, 5.0, 6.0 and under the CE toolkit version 2.0 and 3.0
</ul>

The <A HREF="gridctrl_demo.zip">sample project</A> demonstrates most of the
features of the grid control.

<h3><a name="Files">Files</a></h3>

<p>To use the Grid control in your project you will need to add a number of
files to your project:

<br><br>
<TABLE CELLSPACING=0 WIDTH="90%">

<TR VALIGN=TOP>
<TD WIDTH="5%">&nbsp;</td>
<TD WIDTH="45%"><tt><FONT COLOR="#990000">gridctrl.cpp, gridctrl.h</FONT></tt></TD>
<TD WIDTH="50%">Main grid control source and header files.</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH="5%">&nbsp;</td>
<TD WIDTH="45%"><tt><FONT COLOR="#990000">CellRange.h</FONT></tt></TD>
<TD WIDTH="50%">Definition of CCellID and CCellRange helper classes.</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH="5%">&nbsp;</td>
<TD WIDTH="45%"><tt><FONT COLOR="#990000">MemDC.h</FONT></tt></TD>
<TD WIDTH="50%"><a href="[e-mail]">Keith Rule</a>'s memory DC helper class.</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH="5%">&nbsp;</td>
<TD WIDTH="45%"><tt><FONT COLOR="#990000">InPlaceEdit.cpp, InPlaceEdit.h</FONT></tt></TD>
<TD WIDTH="50%">In-place edit windows source and header files.</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH="5%">&nbsp;</td>
<TD WIDTH="45%"><tt><FONT COLOR="#990000">GridDropTarget.cpp, GridDropTarget.h</FONT></tt></TD>
<TD WIDTH="50%">Grid control OLE drag and drop target. Only necessary if you don't define
                GRIDCONTROL_NO_DRAGDROP in gridctrl.h</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="5%">&nbsp;</td>
<TD WIDTH="45%"><tt><FONT COLOR="#990000">Titletip.cpp, Titletip.h</FONT></tt></TD>
<TD WIDTH="50%">Titletips for cells, from <a href="http://www.codeguru.com">www.codeguru.com</a>
                Only necessary if you don't define GRIDCONTROL_NO_TITLETIPS in gridctrl.h</TD>
</TR>

</table>

<h3><a name="Constuction">Constuction</a></h3>
OK - so how do you use it?

<P>The underlying class of the grid control is <B>CGridCtrl</B> which is
derived from CWnd. To use it, either use the MS Visual C++ dialog editor
to place a custom control on a dialog, and enter "MFCGridCtrl" (no quotes)
as the Class name, or use CGridCtrl::Create:
<PRE><FONT COLOR="#990000">
        CGridCtrl(int nRows = 0, int nCols = 0, int nFixedRows = 0, int nFixedCols = 0);
        BOOL Create(const RECT&amp; rect, CWnd* parent, UINT nID,
                    DWORD dwStyle = WS_CHILD | WS_BORDER | WS_TABSTOP | WS_VISIBLE);

        void AFXAPI DDX_GridControl(CDataExchange* pDX, int nIDC, CGridCtrl&amp;rControl);
</FONT></PRE>

<p>DDX_GridControl is used where a DDX_Control call is needed. It is necessary 
to use DDX_GridControl instead of DDX_Control when creating the control via a 
dialog template in order to ensure that the grid is correctly registered as a 
drag and drop target. This is to avoid a strange COleDropTarget::Register
error that occurs in win95.

<h3><a name="NumRowsCols">Number of rows and columns</a></h3>

<TABLE CELLSPACING=0 WIDTH="90%" >
<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int  GetRowCount() const</FONT></PRE>
</TD>

<TD WIDTH="50%">Returns the number of rows (including fixed
rows)</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int  GetColumnCount() const</FONT></PRE>
</TD>

<TD WIDTH="50%">Returns the number of columns (including fixed
columns)</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int  GetFixedRowCount() const</FONT></PRE>
</TD>

<TD VALIGN=TOP WIDTH="50%">Returns the number of fixed rows</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int  GetFixedColumnCount() const</FONT></PRE>
</TD>

<TD WIDTH="50%">Returns the number of fixed columns</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL SetRowCount(int nRows)</FONT></PRE>
</TD>

<TD WIDTH="50%">Sets the number of rows (including fixed rows),
Returning TRUE on success.</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL SetColumnCount(int nCols)</FONT></PRE>
</TD>

<TD WIDTH="50%">Sets the number of columns (including fixed
columns), Returning TRUE on success.</TD>
</TR>

<TR VALIGN=TOP>
<TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL SetFixedRowCount(int nFixedRows = 1)</FONT></PRE>
</TD>

<TD WIDTH="50%">Sets the number of fixed rows, returning TRUE on success.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL SetFixedColumnCount(int nFixedCols = 1)</FONT></PRE>
</TD><TD WIDTH="50%">Sets the number of columns, returning TRUE on success.</TD>
</TR>

</TABLE>
 
<h3><a name="Sizing">Sizing and position functions</a></h3>

<TABLE CELLSPACING=0 WIDTH="90%" >

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int GetRowHeight(int nRow) const</FONT></PRE>
</TD><TD WIDTH="50%">Gets the height of row nRow.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL SetRowHeight(int row, int height)</FONT></PRE>
</TD><TD WIDTH="50%">Sets the height of row nRow.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int GetColumnWidth(int nCol) const</FONT></PRE>
</TD><TD WIDTH="50%">Gets the width of column nCol</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL SetColumnWidth(int col, int width)</FONT></PRE>
</TD><TD WIDTH="50%">Sets the width of column nCol.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int GetFixedRowHeight() const</FONT></PRE>
</TD><TD WIDTH="50%">Gets the combined height of the fixed rows.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">int GetFixedColumnWidth() const</FONT></PRE>
</TD><TD WIDTH="50%">Gets the combined width of the fixed columns.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">long GetVirtualHeight() const</FONT></PRE>
</TD><TD WIDTH="50%">Gets the combined height of all the rows.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">long GetVirtualWidth() const</FONT></PRE>
</TD><TD WIDTH="50%">Gets the combined width of all the columns.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL GetCellOrigin(int nRow, int nCol, LPPOINT p)<br></FONT></PRE>
</TD><TD WIDTH="50%">Gets the topleft point for cell (nRow,nCol), returning
TRUE if successful. (cell must be visible for success).</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL GetCellOrigin(const CCellID&amp; cell, LPPOINT p)<br></FONT></PRE>
</TD><TD WIDTH="50%">Gets the topleft point for the given cell, returning
TRUE if successful. (cell must be visible for success). 
See also <a href="gridctrl.shtml#CCellID">CCellID<a>.</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL GetCellRect(int nRow, int nCol, LPRECT pRect)</FONT></PRE>
</TD><TD WIDTH="50%">Gets the bounding rectangle for the given cell, returning
TRUE if successful. (cell must be visible for success).</TD>
</TR>

<TR VALIGN=TOP><TD WIDTH="50%">
<PRE><FONT COLOR="#990000">BOOL GetCellRect(const CCellID&amp; cell, LPRECT pRect)</FONT></PRE>