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();
	}
}