最近项目中需要实现单据套打的功能,实现后,留此日记以备忘,同时为有类似需求的同学提供一种解决方案.
原始需求:
1. 打印模板支持灵活自定义,支持可视化设置(含设置打印项是否打印,及位置,大小,字体等…).
2. 支持自定义打印项.
3. 常规的打印项设置(如自动打印小计/合计,表头表尾等…)
4. 在设置模板的时候,支持实时预览.
首先,先上个图, 给大家看一下打印套打模板的大致效果图,各位同学看着顺眼再往下看.
接下来,我们简单的来讨论一下如何实现这个需求,简单分析一下,在这个功能中,可能需要存在以下角色对象.
1. 打印项: 姑且暂称为 PrintItem
2. 打印模板数据: 姑且暂称为 BillPrintData 为了简单起见,我们可以将这个打印模板数据拆分为 表头, 表体, 表尾,因为表头和表尾在控制上行为基本上是一致的,由此我们很自然的衍生出来了 表头表尾 以及 中间的”表体 ”这两个对象.
3. 表头表尾: 姑且暂称为 BillHeaderOrBottom
4. 表体即中间表格部分,姑且暂称为 BillGridBody, 具有和 BillHeaderOrBottom
5. 打印控制器,姑且暂称为 BillPrinter
有了上面的简单分析,我们来简单画一下这个需求的类结构图.
有了上面这些分析,下面我们一起来看下如何来实现这个功能.我们先来实现一个可运行状态随意拖动的容器控件.
为了简单起见,这里我们不妨就暂称我们将要扩展的Panel容器名称为 MoveControlPanel,该容器至少需要实现以下功能
1. 识别当前鼠标位置,是否处于某个内部组件的边框位置,以让鼠标显示出对应的图标(拉伸,移动…)
2.移动鼠标以改变内部某个组件的大小及坐标,
3.保存容器内每个组件的当前坐标及大小.
为了便于描述当前光标状态,我们不妨定义一个枚举.姑且称其为 EMousePointPosition, 其至少应该具有如下定义.
/// <summary>
/// 光标状态
/// </summary>
private enum EMousePointPosition
{
/// <summary>
/// 无
/// </summary>
None = 0,
/// <summary>
/// 处于拉伸右边框位置
/// </summary>
MouseSizeRight = 1,
/// <summary>
/// 处于拉伸左边框位置
/// </summary>
MouseSizeLeft = 2,
/// <summary>
/// 处于拉伸下边框位置
/// </summary>
MouseSizeBottom = 3,
/// <summary>
/// 处于拉伸上边框位置
/// </summary>
MouseSizeTop = 4, /// <summary> /// 处于拉伸左上角位置 /// </summary> MouseSizeTopLeft = 5, /// <summary> /// 处于拉伸右上角位置 /// </summary> MouseSizeTopRight = 6, /// <summary> /// 处于拉伸左小角位置 /// </summary> MouseSizeBottomLeft = 7, /// <summary> /// 处于拉伸右下角位置 /// </summary> MouseSizeBottomRight = 8, /// <summary> /// 鼠标拖动状态 /// </summary> MouseDrag = 9 }
接下来,我们需要通过处理容器内控件的 鼠标按下/鼠标移动/鼠标离开 三个事件,来实现对容器内各个控件的大小/位置的改变.
/// <summary>
/// 初始化鼠标事件
/// </summary>
public void InitMouseEvent()
{
for (int i = 0; i < this.Controls.Count; i++)
{
this.Controls[i].MouseDown += new System.Windows.Forms.MouseEventHandler(ctrl_MouseDown);
this.Controls[i].MouseLeave += new System.EventHandler(ctrl_MouseLeave);
this.Controls[i].MouseMove += new System.Windows.Forms.MouseEventHandler(ctrl_MouseMove);
}
}
接下来我们去尝试实现以下鼠标移动事件,
1) 如果当前没有按下鼠标按键,则去尝试获取当前鼠标的状态,并设置当前光标样式
2) 当按下了鼠标左键,此时需要根据光标状态来改变当前控件的坐标/大小.
private const int Band = 5; //边框大小
private const int MinWidth = 10; //最小宽度
private const int MinHeight = 10; //最小高度
private EMousePointPosition _currentMousePointPosition; //当前鼠标状态
private Point p, p1; //临时变量,缓存改变前后鼠标坐标
/// <summary>
/// 获取鼠标坐标状态
/// </summary>
/// <param name="size">当前控件大小</param>
/// <param name="e">当前鼠标坐标位置</param>
/// <returns></returns>
private EMousePointPosition GetMousePointPosition(Size size, Point e)
{
if ((e.X >= -1 * Band) | (e.X <= size.Width) | (e.Y >= -1 * Band) | (e.Y <= size.Height))
{
if (e.X < Band)
{
if (e.Y < Band)
{
return EMousePointPosition.MouseSizeTopLeft;
}
else { if (e.Y > -1 * Band + size.Height) { return EMousePointPosition.MouseSizeBottomLeft; } else { return EMousePointPosition.MouseSizeLeft; } } } else { if (e.X > -1 * Band + size.Width) { if (e.Y < Band) { return EMousePointPosition.MouseSizeTopRight; } else { if (e.Y > -1 * Band + size.Height) { return EMousePointPosition.MouseSizeBottomRight; } else { return EMousePointPosition.MouseSizeRight; } } } else { if (e.Y < Band) { return EMousePointPosition.MouseSizeTop; } else { if (e.Y > -1 * Band + size.Height) { return EMousePointPosition.MouseSizeBottom; } else { return EMousePointPosition.MouseDrag; } } } } } else { return EMousePointPosition.None; } }
/// <summary>
/// 设置光标状态
/// </summary>
/// <param name="e">当前引发的鼠标事件参数</param>
/// <param name="tempCtrl">当前控件大小</param>
private void SetCursorStyle(MouseEventArgs e, Control tempCtrl)
{
_currentMousePointPosition = GetMousePointPosition(tempCtrl.Size, e.Location); //判断光标的位置状态
//根据光标位置状态设置当前鼠标状态
switch (_currentMousePointPosition)
{
case EMousePointPosition.None:
this.Cursor = Cursors.Arrow;
break;
case EMousePointPosition.MouseDrag: //移动效果
this.Cursor = Cursors.SizeAll; break; case EMousePointPosition.MouseSizeBottom: //上下边框 case EMousePointPosition.MouseSizeTop: this.Cursor = Cursors.SizeNS; break; case EMousePointPosition.MouseSizeLeft: //左右边框 case EMousePointPosition.MouseSizeRight: this.Cursor = Cursors.SizeWE; break; case EMousePointPosition.MouseSizeBottomLeft: //左上/右下 case EMousePointPosition.MouseSizeTopRight: this.Cursor = Cursors.SizeNESW; break; case EMousePointPosition.MouseSizeBottomRight: //右下左上 case EMousePointPosition.MouseSizeTopLeft: this.Cursor = Cursors.SizeNWSE; break; default: break; } }
/// <summary>
/// 处理鼠标移动事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void ctrl_MouseMove(object sender, MouseEventArgs e)
{
Control tempCtrl = sender as Control;
if (e.Button == MouseButtons.Left)
{
switch (_currentMousePointPosition)
{
case EMousePointPosition.MouseDrag:
tempCtrl.Left = tempCtrl.Left + e.X - p.X; tempCtrl.Top = tempCtrl.Top + e.Y - p.Y; break; case EMousePointPosition.MouseSizeBottom: tempCtrl.Height = tempCtrl.Height + e.Y - p1.Y; p1.X = e.X; p1.Y = e.Y; //记录光标拖动的当前点 break; case EMousePointPosition.MouseSizeBottomRight: tempCtrl.Width = tempCtrl.Width + e.X - p1.X; tempCtrl.Height = tempCtrl.Height + e.Y - p1.Y; p1.X = e.X; p1.Y = e.Y; //记录光标拖动的当前点 break; case EMousePointPosition.MouseSizeRight: tempCtrl.Width = tempCtrl.Width + e.X - p1.X; // lCtrl.Height = lCtrl.Height + e.Y - p1.Y; p1.X = e.X; p1.Y = e.Y; //'记录光标拖动的当前点 break; case EMousePointPosition.MouseSizeTop: tempCtrl.Top = tempCtrl.Top + (e.Y - p.Y); tempCtrl.Height = tempCtrl.Height - (e.Y - p.Y); break; case EMousePointPosition.MouseSizeLeft: tempCtrl.Left = tempCtrl.Left + e.X - p.X; tempCtrl.Width = tempCtrl.Width - (e.X - p.X); break; case EMousePointPosition.MouseSizeBottomLeft: tempCtrl.Left = tempCtrl.Left + e.X - p.X; tempCtrl.Width = tempCtrl.Width - (e.X - p.X); tempCtrl.Height = tempCtrl.Height + e.Y - p1.Y; p1.X = e.X; p1.Y = e.Y; //记录光标拖动的当前点 break; case EMousePointPosition.MouseSizeTopRight: tempCtrl.Top = tempCtrl.Top + (e.Y - p.Y); tempCtrl.Width = tempCtrl.Width + (e.X - p1.X); tempCtrl.Height = tempCtrl.Height - (e.Y - p.Y); p1.X = e.X; p1.Y = e.Y; //记录光标拖动的当前点 break; case EMousePointPosition.MouseSizeTopLeft: tempCtrl.Left = tempCtrl.Left + e.X - p.X; tempCtrl.Top = tempCtrl.Top + (e.Y - p.Y); tempCtrl.Width = tempCtrl.Width - (e.X - p.X); tempCtrl.Height = tempCtrl.Height - (e.Y - p.Y); break; default: break; } if (tempCtrl.Width < MinWidth) tempCtrl.Width = MinWidth; if (tempCtrl.Height < MinHeight) tempCtrl.Height = MinHeight; } else { SetCursorStyle(e, tempCtrl); } }
接下来,我们在处理一下鼠标按下及鼠标离开事件,
1) 鼠标按下,记录当前坐标
2) 鼠标离开,还原光标状态
/// <summary>
/// 处理鼠标按下事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void ctrl_MouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
{
if (e.Button == System.Windows.Forms.MouseButtons.Left)
{
p.X = e.X;
p.Y = e.Y;
p1.X = e.X;
p1.Y = e.Y; } } /// <summary> /// 处理鼠标离开 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void ctrl_MouseLeave(object sender, EventArgs e) { _currentMousePointPosition = EMousePointPosition.None; this.Cursor = Cursors.Arrow; }
ok, 截止到这里,这个控件基本上就已完成了,已实现在界面中实时拖拽,改变大小功能.
此功能简略的讲解到这里,我想若有类似需求的朋友已经能知道后面的路怎么走了.剩下无非就是在一个设计器界面中引入这个控件,然后根据用户拖动的位置将坐标记录下来,在打印的时候,将数据源这个格式一起绑定后交给打印控制处理器负责打印即可.