Spread for Windows Forms高级主题(7)

表单打印的多个部分都可以进行自定义，大多数的自定义选项存在于PrintInfo对象中。大多数打印选项是在PrintInfo对象上进行设置，并在表单级别上应用。当你执行打印操作时，你将一个特定的表单发送给使用这些设置的打印机。如果你想为不同的表单使用不同的打印设置，那么你可能需要重置PrintInfo对象，然后在表单打印的间隔内做必要的修改。

深入理解打印选项

你可以通过设置PrintInfo对象的 属性，并将表单的PrintInfo属性值设置为该对象，来自定义打印设置。PrintInfo对象提供了以下属性用来自定义打印：

属性

描述

AbortMessage

获取或设置退出对话框显示的信息。

BestFitCols

获取或设置列宽是否为满足打印最长字符串的宽度而调整。

BestFitRows

获取或设置行高是否为满足打印最高字符串的高度而调整。

Centering

获取或设置打印输出是否居中。

Colors

获取或设置可在自定义页眉或页脚文本中使用的颜色列表。

ColStart和 ColEnd

用来打印表单的一部分。

FirstPageNumber

获取或设置打印在首页上的页码。

Footer

为打印页面提供页脚。

Header

为打印的页面提供页眉。

Images

获取或设置可在自定义页眉或页脚中使用的图片列表。

JobName

获取或设置打印作业的名称。

Margin

获取或设置打印的页面空白。

Opacity

获取或设置打印表单时所使用的不透明度； 它可以用来首先打印一个水印，然后再打印表单的内容。

Orientation

获取或设置打印时的页面方向。

PageStart和 PageEnd

用来打印一个页面区域。

PageOrder

获取或设置页面打印的顺序。

PaperSize

获取或设置所使用的纸张大小。

PaperSource

获取或设置所使用的纸张来源。

Preview

用来提供打印预览。

Printer

获取或设置用来打印的打印机名称。

PrintNotes

获取或设置是否打印单元格注释。

PrintShapes

获取或设置是否打印浮动对象。

PrintType

获取或设置需要打印的内容。

RepeatColStart和 RepeatColEnd

获取或设置是否在每一个页面上打印相同的列集。

RepeatRowStart 和 RepeatRowEnd

获取或设置是否在每一个页面上打印相同的行集。

RowStart和 RowEnd

用来打印表单的一部分。

ShowBorder

获取或设置是否在表单的四周打印边界。

ShowColor

获取或设置是否打印在屏幕上出现的颜色。

ShowColumnHeader 和 ShowRowHeader

获取或设置是否打印列标题和行标题。

ShowGrid

获取或设置是否打印表单的网格线。

ShowPrintDialog

获取或设置打印前是否显示打印对话框。

ShowShadows

获取或设置是否打印标题阴影。

SmartPrintPagesTall

获取或设置打印的页高。

SmartPrintPagesWide

获取或设置打印的页宽。

SmartPrintRules

用来设置打印优化的规则。

UseMax

获取或设置是否只打印包含数据的行。

UseSmartPrint

用来开启打印优化的规则。

ZoomFactor

获取或设置打印页面时使用的缩放因子。

示例代码创建了一个PrintInfo对象，并设置属性指定不打印网格线或行标题，并且只打印包含数据的单元格。

1   //创建PrintInfo对象并设置属性。  
2  
3  
4  
5  
6  
7 
8  
9 
10  
11 
12   
13   FarPoint.Win.Spread.PrintInfo printset = new FarPoint.Win.Spread.PrintInfo();  
14  
15  
16  
17  
18  
19 
20  
21 
22  
23 
24   
25   printset.ShowGrid = false;  
26  
27  
28  
29  
30  
31 
32  
33 
34  
35 
36   
37   printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide;  
38  
39  
40  
41  
42  
43 
44  
45 
46  
47 
48   
49   printset.UseMax = true;  
50  
51  
52  
53  
54  
55 
56  
57 
58  
59 
60   
61   //为第一个表单设置PrintInfo属性。 fpSpread1.Sheets[0].PrintInfo = printset;  
62  
63  
64  
65  
66  
67 
68  
69 
70  
71 
72   
73   //打印表单。  
74  
75  
76  
77  
78  
79 
80  
81 
82  
83 
84   
85   fpSpread1.PrintSheet(0); 
86 
87 
88 
89 
90 
91
92 
93
94 
95
96  
97  

自定义打印作业设置

如果你没有指定其他打印机的话，表单会使用你的Windows系统环境中当前的默认打印机进行打印。你可以在任意支持Windows的打印机上打印表单。

你可以自定义的打印作业设置项包括打印机、纸张来源、以及纸张大小。相对应的，可以设置PrintInfo对象中的Printer，PaperSource，或PaperSize属性。

下面的示例代码从一个复选框中选择了纸张来源，并在打印所有表单前设置了纸张的大小。

1   private void Form1_Load(object sender, System.EventArgs e) {  
2  
3  
4  
5  
6  
7 
8  
9 
10  
11 
12   
13   int i;  
14  
15  
16  
17  
18  
19 
20  
21 
22  
23 
24   
25   System.Drawing.Printing.PrinterSettings ps = new System.Drawing.Printing.PrinterSettings();  
26  
27  
28  
29  
30  
31 
32  
33 
34  
35 
36   
37   for (i = 0; i <= ps.PaperSources.Count - 1; i++)  
38  
39  
40  
41  
42  
43 
44  
45 
46  
47 
48   
49   {  
50  
51  
52  
53  
54  
55 
56  
57 
58  
59 
60   
61   comboBox1.Items.Add(ps.PaperSources[i].SourceName);  
62  
63  
64  
65  
66  
67 
68  
69 
70  
71 
72   
73   }  
74  
75  
76  
77  
78  
79 
80  
81 
82  
83 
84   
85   comboBox1.Text = ps.PaperSources[0].SourceName;  
86  
87  
88  
89  
90  
91 
92  
93 
94  
95 
96   
97   }  
98  
99  
100  
101  
102  
103 
104  
105 
106  
107 
108   
109    
110  
111  
112  
113  
114  
115 
116  
117 
118  
119 
120   
121   private void button1_Click(object sender, System.EventArgs e)  
122  
123  
124  
125  
126  
127 
128  
129 
130  
131 
132   
133   {  
134  
135  
136  
137  
138  
139 
140  
141 
142  
143 
144   
145   FarPoint.Win.Spread.PrintInfo pi = new FarPoint.Win.Spread.PrintInfo();  
146  
147  
148  
149  
150  
151 
152  
153 
154  
155 
156   
157   System.Drawing.Printing.PrinterSettings ps = new System.Drawing.Printing.PrinterSettings();  
158  
159  
160  
161  
162  
163 
164  
165 
166  
167 
168   
169   pi.PaperSize = new System.Drawing.Printing.PaperSize("Letter", 600, 300);  
170  
171  
172  
173  
174  
175 
176  
177 
178  
179 
180   
181   pi.PaperSource = ps.PaperSources[comboBox1.SelectedIndex];  
182  
183  
184  
185  
186  
187 
188  
189 
190  
191 
192   
193   fpSpread1.Sheets[0].PrintInfo = pi;  
194  
195  
196  
197  
198  
199 
200  
201 
202  
203 
204   
205   fpSpread1.PrintSheet(-1);  
206  
207  
208  
209  
210  
211 
212  
213 
214  
215 
216   
217   } 
218 
219 
220 
221 
222 
223
224 
225
226 
227
228  
229  

自定义打印页眉或页脚

你可以在打印页面上显示页眉和页脚。使用PrintInfo类的 Header属性和 Footer属性，可能包含特殊的控制指令，你可以指定文本和变量，如页数，也可以指定字体的设置。与字体相关的指令以"f"开头。

下面的表中列出了可插入到页眉和页脚中的控制指令。

控制字符

完整的命令

打印页面的页眉或页脚的行为

/

/

插入正斜杠字符(/)

/c

/c

调整项目居中

/cl

/cl"n"

设置文本的字体颜色，使用以0为基准的颜色索引，n，在引号中（n可以是0或更大）； 请参考Colors属性。

/dl

/dl

使用长格式，插入日期

/ds

/ds

使用短格式，插入日期

/f

/f"n"

重新调用先前保存的字体设置（查看表中的/fs），使用以0为基准的索引，n，在引号中（n可以是0或更大）。

/fb

/fb0

关闭加粗字体类型

/fb1

打开加粗字体类型

/fi

/fi0

关闭斜体字体类型

/fi1

打开斜体字体类型

/fk

/fk0

关闭删除线

/fk1

打开删除线

/fn

/fn"name"

使用引号中字体的名称，设置字体的名称。

/fs

/fs"n"

保存字体设置以便重复使用，使用以0为基准的字体设置索引，n，在引号中（查看表中的/f）

/fu

/fu0

关闭下划线

/fu1

打开下划线

/fz

/fz"n"

设置字体的大小

/g

/g"n"

插入一张图形（图片），以0为基准的图片索引，n，在引号中（n可以为0或更大） 请参考Images属性。

/l

/l

左对齐该项目（这是字母l或L，与Left等价）

/n

/n

插入一个新行

/p

/p

插入页码

/pc

/pc

插入页数（打印作业中的总页面数）

/r

/r

右对齐该项目

/tl

/tl

使用长格式插入时间

/ts

/ts

使用短格式插入时间

如果你使用了多个控制字符，不要在字符之间留空格。字符可以为小写或大写格式； 为了简单起见，显示在这里的所有命令和示例都使用小写格式。

打印表单(运行PrintSheet 方法)前定义页眉和页脚(设置 Header 和 Footer 属性)。

如果颜色已经在Colors属性中进行了预定义，那么你可以从颜色列表中为文本指定一个颜色。

如果图片已经在Images属性中进行了预定义，你可以指定一个图片。

你可以添加文本包括页数和总的打印页数。

你可以保存页眉或页脚中的字体设置，以便重复使用。

这个是下面代码运行的结果。

下面的示例代码打印带有指定页眉和页脚文本的表单：

1   //创建PrintInfo对象并设置属性。  
2  
3  
4  
5  
6  
7 
8  
9 
10  
11 
12   
13   FarPoint.Win.Spread.PrintInfo printset = new FarPoint.Win.Spread.PrintInfo();  
14  
15  
16  
17  
18  
19 
20  
21 
22  
23 
24   
25   printset.Colors = new Color[] {Color.Green, Color.Yellow, Color.Gold, Color.Indigo, Color.Brown};  
26  
27  
28  
29  
30  
31 
32  
33 
34  
35 
36   
37   printset.Images = new Image[] {Image.FromFile("C:\\images\\point.jpg"), Image.FromFile("C:\\images\\logo.gif"), Image.FromFile("C:\\images\\icon.jpg")};  
38  
39  
40  
41  
42  
43 
44  
45 
46  
47 
48   
49   printset.Header = ""/fn\"Book Antiqua\" /fz\"14\" Print job for FarPoint Inc./n ";  
50  
51  
52  
53  
54  
55 
56  
57 
58  
59 
60   
61   printset.Footer = "/g\"1\"/r/cl\"4\"This is page /p of /pc";  
62  
63  
64  
65  
66  
67 
68  
69 
70  
71 
72   
73   //为第一个表单设置PrintInfo属性。 fpSpread1.Sheets[0].PrintInfo = printset;  
74  
75  
76  
77  
78  
79 
80  
81 
82  
83 
84   
85   //打印表单。  
86  
87  
88  
89  
90  
91 
92  
93 
94  
95 
96   
97   fpSpread1.PrintSheet(0); 
98 
99 
100 
101 
102 
103
104 
105
106 
107
108  
109  

在打印页面上循环打印行或列

你可以指定出现在每一个打印页顶部的行或左边的列。使用PrintInfo对象的RepeatRowStart，RepeatRowEnd，RepeatColStart，和RepeatColEnd属性。

下面的示例代码设置了循环选项，并使用了预览对话框。

1   FarPoint.Win.Spread.PrintInfo printset = new FarPoint.Win.Spread.PrintInfo();  
2  
3  
4  
5  
6  
7 
8  
9 
10  
11 
12   
13   printset.RepeatColStart = 0;  
14  
15  
16  
17  
18  
19 
20  
21 
22  
23 
24   
25   printset.RepeatColEnd = 2;  
26  
27  
28  
29  
30  
31 
32  
33 
34  
35 
36   
37   printset.RepeatRowStart = 0;  
38  
39  
40  
41  
42  
43 
44  
45 
46  
47 
48   
49   printset.RepeatRowEnd = 2;  
50  
51  
52  
53  
54  
55 
56  
57 
58  
59 
60   
61   printset.Preview = true;  
62  
63  
64  
65  
66  
67 
68  
69 
70  
71 
72   
73   fpSpread1.Sheets[0].PrintInfo = printset;  
74  
75  
76  
77  
78  
79 
80  
81 
82  
83 
84   
85   fpSpread1.PrintSheet(0); 
86 
87 
88 
89 
90 
91
92 
93
94 
95
96  
97  

添加分页符

你可以在指定的行或列前添加强制分页符。分页符不会在屏幕上显示，但是在打印表单时会强制分页。列的分页符位于指定列的左边。行的分页符位于指定行的上方。要添加或设置分页符，使用SetRowPageBreak 和SetColumnPageBreak方法。

你也可以检索到表单中位于分页符后的下一行或列。要查看已经设置的分页符，使用GetRowPageBreaks方法返回行分页符的数量，使用GetColumnPageBreaks方法返回列分页符的数量。

你可以使用GetPrintPageCount方法 计算表单的打印页数。

下面的示例代码设置了行分页符，并为行分页符返回了总行数。

1   //为窗体的Load事件添加如下代码。  
2  
3  
4  
5  
6  
7 
8  
9 
10  
11 
12   
13   FarPoint.Win.Spread.PrintInfo pi = new FarPoint.Win.Spread.PrintInfo();  
14  
15  
16  
17  
18  
19 
20  
21 
22  
23 
24   
25   pi.UseMax =false;  
26  
27  
28  
29  
30  
31 
32  
33 
34  
35 
36   
37   fpSpread1.Sheets[0].PrintInfo = pi;  
38  
39  
40  
41  
42  
43 
44  
45 
46  
47 
48   
49   fpSpread1.Sheets[0].SetRowPageBreak(5,true);  
50  
51  
52  
53  
54  
55 
56  
57 
58  
59 
60   
61   //为按钮的Click事件添加如下代码。  
62  
63  
64  
65  
66  
67 
68  
69 
70  
71 
72   
73   int []i;  
74  
75  
76  
77  
78  
79 
80  
81 
82  
83 
84   
85   i = fpSpread1.GetRowPageBreaks(0);  
86  
87  
88  
89  
90  
91 
92  
93 
94  
95 
96   
97   foreach (object o in i)  
98  
99  
100  
101  
102  
103 
104  
105 
106  
107 
108   
109   {  
110  
111  
112  
113  
114  
115 
116  
117 
118  
119 
120   
121   listBox1.Items.Add(o);  
122  
123  
124  
125  
126  
127 
128  
129 
130  
131 
132   
133   } 
134 
135 
136 
137 
138 
139
140 
141
142 
143
144  
145  

为打印页面添加水印

在打印表单时，你可以打印一张背景图片或水印。打印时，触发PrintBackground事件，然后在该事件中指定背景图片，并使用PrintInfo.Opacity属性设置不透明度； 打印表单时，如果不透明度最高（透明度最低），则没有水印；而如果不透明度低（透明度高）时，则会显示水印。

下面的代码示例展示了如何打印水印。

1   private void fpSpread1_PrintBackground(object sender, FarPoint.Win.Spread.PrintBackgroundEventArgs e)  
2  
3  
4  
5  
6  
7 
8  
9 
10  
11 
12   
13   {  
14  
15  
16  
17  
18  
19 
20  
21 
22  
23 
24   
25   FarPoint.Win.Picture pic = new FarPoint.Win.Picture(System.Drawing.Image.FromFile("C:\\Spread70\\Samples\\Files\\cover.jpg"), FarPoint.Win.RenderStyle.Normal);  
26  
27  
28  
29  
30  
31 
32  
33 
34  
35 
36   
37   pic.AlignHorz = FarPoint.Win.HorizontalAlignment.Left;  
38  
39  
40  
41  
42  
43 
44  
45 
46  
47 
48   
49   pic.AlignVert = FarPoint.Win.VerticalAlignment.Top;  
50  
51  
52  
53  
54  
55 
56  
57 
58  
59 
60   
61   pic.Paint(e.Graphics, e.SheetRectangle);  
62  
63  
64  
65  
66  
67 
68  
69 
70  
71 
72   
73   }  
74  
75  
76  
77  
78  
79 
80  
81 
82  
83 
84   
85    
86  
87  
88  
89  
90  
91 
92  
93 
94  
95 
96   
97   private void button1_Click(object sender, System.EventArgs e)  
98  
99  
100  
101  
102  
103 
104  
105 
106  
107 
108   
109   {  
110  
111  
112  
113  
114  
115 
116  
117 
118  
119 
120   
121   FarPoint.Win.Spread.PrintInfo pi = new FarPoint.Win.Spread.PrintInfo();  
122  
123  
124  
125  
126  
127 
128  
129 
130  
131 
132   
133   pi.Opacity = 100;  
134  
135  
136  
137  
138  
139 
140  
141 
142  
143 
144   
145   fpSpread1.ActiveSheet.PrintInfo = pi;  
146  
147  
148  
149  
150  
151 
152  
153 
154  
155 
156   
157   fpSpread1.PrintSheet(0);  
158  
159  
160  
161  
162  
163 
164  
165 
166  
167 
168   
169   } 
170 
171 
172 
173 
174 
175
176 
177
178 
179
180  
181  

Spread for Windows Forms 5.0 中文版下载地址

附：Spread for Windows Forms高级主题系列文章

Spread for Windows Forms高级主题(1)---底层模型

Spread for Windows Forms高级主题(2)---理解单元格类型

Spread for Windows Forms高级主题(3)---理解单元格的编辑模式

Spread for Windows Forms高级主题(4)---自定义用户交互

Spread for Windows Forms高级主题(5)---数据处理

Spread for Windows Forms高级主题(6)---数据绑定管理

本文出自 “葡萄城控件博客” 博客，请务必保留此出处http://powertoolsteam.blog.51cto.com/2369428/645955