xtreme toolkit pro——CXTPReportControl控件教程
CXTPReportControl控件是xtreme toolkit pro中的一个控件，它用来显示表格，可以显示表头表尾，可以对各列排序，拖放，等等，，也可以对各个单元格进行编辑，功能非常强大。下面介绍一下他的使用：
1. 在工程中头文件“stdafx.h”中添加：
#include <XTToolkitPro.h> // Xtreme Toolkit Pro component library
2. 如果要使用静态连接的方式，还应该：
Add the following line to your application's .rc2 file. This will link in the toolkit resources so they are available to your application.
#include <XTToolkitPro.rc>
如果是动态连接的方式，需要xtreme toolkit的.dll拷贝到exe的输出目录下。
3. 添加CXTPReportControl控件：
（1）在对话框中添加一个自定义控件，将该控件的class属性改为XTPReport，ID改为;IDC_REPORTCTRL_LIST。
（2）添加一个自定义变量：CXTPReportControl m_wndReportCtrl;
（3）将控件和变量联系起来，在对话框初始化函数OnInitDialog()中添加如下代码：
m_wndReportCtrlList.SubclassDlgItem(IDC_REPORTCTRL_LIST,this);
4. 设置控件的外观：
//初始化报表的外观
m_wndReportCtrl.AllowEdit(FALSE);
//m_wndReportCtrl.EditOnClick(FALSE);
//m_wndReportCtrl.EnableDragDrop(NULL, xtpReportAllowDrag | xtpReportAllowDrop);//允许拖曳行
m_wndReportCtrl.EnableToolTips(TRUE);//在列头显示提示tooltips
//m_wndReportCtrl.ShowHeader(TRUE);//显示头部(默认显示)
//m_wndReportCtrl.ShowHeaderRows(TRUE);//显示头行
//m_wndReportCtrl.ShowFooter(TRUE);//显示页脚footer,即界面下边，与header对应
//m_wndReportCtrl.ShowFooterRows(TRUE);//显示页脚行
//m_wndReportCtrl.HeaderRowsAllowEdit(TRUE);//允许编辑HeaderRows
//m_wndReportCtrl.FooterRowsAllowEdit(TRUE);//允许编辑FooterRows
// COLORREF clrNew;
// clrNew = RGB(0, 255, 0);
// m_wndReportCtrl.SetGridColor(clrNew);//设置网格线颜色
m_wndReportCtrl.SetGridStyle(TRUE,XTPReportGridStyle(xtpReportGridSolid));//设置垂直网格线风格
m_wndReportCtrl.SetGridStyle(FALSE,XTPReportGridStyle(xtpReportGridSolid));//设置垂直网格线风格
//m_wndReportCtrl.SetFreezeColumnsCount(2);//左侧两列冻住，注意，此方法必须在添加了列之后才能使用
m_wndReportCtrl.GetPaintManager()->SetColumnStyle(XTPReportColumnStyle(xtpReportColumnOffice2007));//设置列的风格
//m_wndReportCtrl.GetPaintManager()->SetGridColor(clrNew);//设置网格线颜色
m_wndReportCtrl.GetReportHeader()->AllowColumnRemove(FALSE);//不允许移除列
m_wndReportCtrl.GetReportHeader()->AllowColumnResize(TRUE);//允许改变列的宽度
m_wndReportCtrl.GetReportHeader()->AllowColumnSort(TRUE);//允许对列中的各行排序
m_wndReportCtrl.GetReportHeader()->AllowColumnReorder(FALSE);//不允许列之间重新排序（通过拖拽列头部）
m_wndReportCtrl.GetReportHeader()->SetAutoColumnSizing(TRUE);//不允许各列自动调节宽度
//设置列宽自动调整为false，这样一来，所有列宽不是随reportControl的宽度变化而自动变化。
//如果所有的列宽之和大于reportControl的宽度，就会自动显示横向工具条
m_wndReportCtrl.SetFullColumnScrolling(FALSE);//按像素水平滚动，而不是逐列滚动(即滚动一下就移动一列)
//m_wndReportCtrl.SetFullColumnScrolling(TRUE);//逐列滚动(即滚动一下就移动一列)
m_wndReportCtrl.SetMultipleSelection(TRUE);//允许多选
5. 添加列：
///添加列
CXTPReportColumn* pCol1=new CXTPReportColumn(0, _T("序号"), 80);
pCol1->SetHeaderAlignment(DT_CENTER);
pCol1->SetAlignment(DT_CENTER);
//pCol1->SetEditable(FALSE);//不可编辑
m_wndReportCtrl.AddColumn(pCol1);
6. 添加行
CXTPReportRecord *pRecord = new CXTPReportRecord();
pRecord->AddItem(new CXTPReportRecordItemNumber(i+1));//行号
pRecord->AddItem(new CXTPReportRecordItemText(m_pDataGroup->m_arrDataTable[i].m_sBusInfo));//基本信息
pRecord->AddItem(new CXTPReportRecordItemNumber(m_pDataGroup->m_arrDataTable[i].m_dMw1,KEY_FORMAT_NUMBER));
pRecord->AddItem(new CXTPReportRecordItemNumber(m_pDataGroup->m_arrDataTable[i].m_dMw2,KEY_FORMAT_NUMBER));
pRecord->AddItem(new CXTPReportRecordItemNumber(m_pDataGroup->m_arrDataTable[i].m_dMw2-m_pDataGroup->m_arrDataTable[i].m_dMw1,KEY_FORMAT_NUMBER));
m_wndReportCtrl.AddRecord(pRecord);
7. 显示
m_wndReportCtrl.Populate();
8. 添加报表行焦点改变事件：
（1）在报表所在对话框的头文件中添加消息映射函数：
afx_msg void OnReportFocusChanging(NMHDR* pNMHDR, LRESULT* result);
（2）在报表所在对话框的源文件中将消息映射函数和报表控件联系起来，即在BEGIN_MESSAGE_MAP和END_MESSAGE_MAP之间添加：
ON_NOTIFY(XTP_NM_REPORT_FOCUS_CHANGING, IDC_REPORTCTRL_LIST, OnReportFocusChanging)
（3）实现消息映射函数，如下：
//表中焦点行改变时的事件（包括用鼠标单击和用键盘的方向键）
void CWEReportDlg::OnReportFocusChanging(NMHDR * pNotifyStruct, LRESULT * /*result*/)
{
XTP_NM_REPORTRECORDITEM* pItemNotify = (XTP_NM_REPORTRECORDITEM*) pNotifyStruct;
if (!pItemNotify) return;
CXTPReportRow* pRowSel=pItemNotify->pRow;
if (!pRowSel) return;
TRACE(_T("Click on row %d\n"),pRowSel->GetIndex());
CXTPReportRecord* pRecordSel=pRowSel->GetRecord();
if(!pRecordSel) return;
CXTPReportRecordItemText* pText=(CXTPReportRecordItemText*)(pRecordSel->GetItem(0));
if(!pText) return;
if (pText->GetValue().Trim()==m_sTableNameNow)
{
return;//如果单击的行和上一次是同一行，就不用进行下面的操作
}
//更新当前记录和ATC
m_sTableNameNow=pText->GetValue().Trim();
if (m_sTableNameNow!="")
{
FindTableByName(m_sTableNameNow);
//更改选择的报表后，更新相应的已选框和待选框中的内容
UpdateReportTable();
}
}
