老周在前一篇烂文中已经给大伙伴们演示了如何打印UI元素，今天的烂文就向各位介绍一下，如何向打印对话框添加自定义选项。如果只是讲如何实现，会比较抽象，也比较枯燥，而且相当无聊，更是说不清楚，毕竟这打印API用起来要比其他API稍稍复杂了一点。所以老周就做了一个打印图片的垃圾应用，在打印对话框中，你可以选择设置要打印图片的不透明度、旋转角度（0度，90度，180度，270度）。
OK，为环保事业做贡献，老周今天也节约一点口水。下面咱们开始干活。
1、先来设计一些UI，该UI简单大方朴素美丽极致，其XAML代码如下：
<Grid> <Grid.RowDefinitions> <RowDefinition Height="auto"/> <RowDefinition Height="*"/> </Grid.RowDefinitions> <Button Content="打印" Click="OnClick"/> <Image Grid.Row="1" Width="300" Height="200" VerticalAlignment="Center" HorizontalAlignment="Center" Name="img" Source="Assets/03.jpg"/> </Grid>
按钮的作用就是打开打印对话框，Image显示要打印的图片。不过呢，为了打印过程中设置选项（就是老周上面讲的什么不透明度等）时不会干扰界面上的Image，我打算在代码中再声明一个Image对象，专门用来打印。代码是这样的：
Image copyImage = null; public MainPage() { this.InitializeComponent(); copyImage = new Image(); copyImage.Source = img.Source; copyImage.Stretch = Stretch.Uniform; rotateTrsf = new RotateTransform() { Angle = 0d }; copyImage.RenderTransformOrigin = new Point(0.5, 0.5); this.copyImage.RenderTransform = rotateTrsf; }
大家会看到我弄了个RotateTransform对象，干啥用的呢？你忘了吗，我刚说了要在打印对话框中选择图片的旋转角度的，对了，就是用来让copyImage进行旋转的。
2、接下来实现打印，基本过程我在前一篇烂文中说过，获取PrintManager实例，处理PrintTaskRequested事件，当有新的打印任务请求时，会发生该事件。看：
private void PrintMgr_PrintTaskRequested(PrintManager sender, PrintTaskRequestedEventArgs args) { PrintTask task = null; task = args.Request.CreatePrintTask("打印图像", async printSrcrqtArgs => { task.Completed += async (ps, pe) => { await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () => { MessageDialog msgdlg = new MessageDialog(""); if (pe.Completion == PrintTaskCompletion.Canceled) { msgdlg.Content = "打印被取消。"; } else if (pe.Completion == PrintTaskCompletion.Abandoned) { msgdlg.Content = "已放弃打印。"; } else if (pe.Completion == PrintTaskCompletion.Submitted) { msgdlg.Content = "已提交打印。"; } await msgdlg.ShowAsync(); }); }; await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () => { printSrcrqtArgs.SetSource(_printdoc?.DocumentSource); }); }); task.Options.Orientation = PrintOrientation.Landscape; // 创建自定义选项 PrintTaskOptionDetails optionDetails = PrintTaskOptionDetails.GetFromPrintTaskOptions(task.Options); // 清除所有选项 optionDetails.DisplayedOptions.Clear(); // 添加标准项：页面方向 optionDetails.DisplayedOptions.Add(StandardPrintTaskOptions.Orientation); // 添加自定义选项 // 不透明度 PrintCustomItemListOptionDetails list = optionDetails.CreateItemListOption(OPTION_OPACITY, "不透明度"); list.AddItem(OPACITY_50PC, "50 %"); list.AddItem(OPACITY_75PC, "75 %"); list.AddItem(OPACITY_100PC, "100 %"); optionDetails.DisplayedOptions.Add(OPTION_OPACITY); // 旋转角度 list = optionDetails.CreateItemListOption(OPTION_ANGLE, "旋转角度"); list.AddItem(ANGLE_0, "0 度"); list.AddItem(ANGLE_90, "90 度"); list.AddItem(ANGLE_180, "180 度"); list.AddItem(ANGLE_270, "270 度"); optionDetails.DisplayedOptions.Add(OPTION_ANGLE); // 处理选项更改事件 optionDetails.OptionChanged += OptionDetails_OptionChanged; }
为了节约代码行数，同时为了展现C#语言的风采，我这里套用了几层Lambda表达式。
请大伙注意后半段代码，前半段代码你应该在前一篇烂文中见过，但后半段代码是小鲜肉，在本文中才出现，它的作用是向打印对话框中添加标准的，以及自定义的选项。
何为标准选项？就是一般打印参数（通用级别），这些选项的ID名称都由Windows.Graphics.Printing.StandardPrintTaskOptions类的静态属性所公开。
自定义选项就咱们自己定的选项，本例中，图片透明度、旋转角度就是自定义选项。
a、PrintTaskOptionDetails.GetFromPrintTaskOptions方法获取一个PrintTaskOptionDetails对象，可用它来操作选项集合。
b、PrintTaskOptionDetails对象有个DisplayedOptions属性，它是一个字符串列表，表示要在打印对话框上显示哪些选项，就把这些选项的ID放进去。没有在这个列表中的项就只有当用户点击“更多设置”时才会显示。
c、这行代码是把标准选项中的页面方向选项加到显示列表中，因为刚才用Clear方法把DisplayedOptions清空了，所以要加入一下。
optionDetails.DisplayedOptions.Add(StandardPrintTaskOptions.Orientation);
d、调用CreateItemListOption方法可以创建一个新的自定义选项，方法有两个字符串类型的参数，第一个参数是这组选项的ID，第二个参数是显示的内容，即要显示在打印对话框上的选项标题，ID是不显示出来的。
e、用AddItem方法添加子选项时也是如此，一个ID值和一个显示值。
注意：CreateItemListOption方法创建的是整个选项组，比如“旋转方向”，而AddItem方法才是向选项组添加列表项，比如90度、180度等。
f、选项列表是添加了，但为了在打印对话框中能够实时看到预览效果，应该处理Windows.Graphics.Printing.OptionDetails.PrintTaskOptionDetails对象的OptionChanged事件，当这些选项集合中的任意一组选项发生改变时就会触发事件。
private async void OptionDetails_OptionChanged(PrintTaskOptionDetails sender, PrintTaskOptionChangedEventArgs args) { if (args.OptionId == null) return; string optID = args.OptionId as string;
await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () => { _printdoc.InvalidatePreview(); }); }
事件参数中的OptionId属性就是返回被更改的选项组的ID。注意是某个组选项的ID，不是单个子项的ID。
调用PrintDocument的InvalidatePreview方法是让PrintDocument中的UI元素重新呈现，和刷新差不多。
==================================================
和上一篇烂文中的一样，需要处理PrintDocument对象的几个事件，以处理打印和预览中相关的操作。
private void _printdoc_Paginate(object sender, PaginateEventArgs e) { // 根据打印对话框选项的变化来修改可视化对象 PrintTaskOptionDetails optdetails = PrintTaskOptionDetails.GetFromPrintTaskOptions(e.PrintTaskOptions); // 不透明度 IPrintOptionDetails opaOpt = optdetails.Options[OPTION_OPACITY]; string opacity = opaOpt.Value as string; switch (opacity) { case OPACITY_50PC: copyImage.Opacity = 0.5d; break; case OPACITY_75PC: copyImage.Opacity = 0.75d; break; case OPACITY_100PC: copyImage.Opacity = 1d; break; default: copyImage.Opacity = 1d; break; } // 旋转角度 IPrintOptionDetails angleOpt = optdetails.Options[OPTION_ANGLE]; string angle = angleOpt.Value as string; switch (angle) { case ANGLE_0: rotateTrsf.Angle = 0d; break; case ANGLE_90: rotateTrsf.Angle = 90d; break; case ANGLE_180: rotateTrsf.Angle = 180d; break; case ANGLE_270: rotateTrsf.Angle = 270d; break; default: rotateTrsf.Angle = 0d; break; } // 设置预览页面数 _printdoc.SetPreviewPageCount(1, PreviewPageCountType.Final); } private void _printdoc_GetPreviewPage(object sender, GetPreviewPageEventArgs e) { // 呈现预览 try { _printdoc.SetPreviewPage(e.PageNumber, copyImage); } catch { // 发生异常时忽略 } } private void _printdoc_AddPages(object sender, AddPagesEventArgs e) { // 添加要打印的页面 _printdoc.AddPage(copyImage); // 报告添加完成 _printdoc.AddPagesComplete(); }
在GetPreviewPage事件处理中把代码放在try...catch中，是防止发生异常。因为标准打印选项的更改本身就会引发重绘行为，但我们这里是把标准项和自定义项混在一起用，有发生异常的可能性，所以放到try中安全一些。
如果不把代码放在try块中，其实还有一种方法：就是在刚才的OptionChanged事件的处理过程中，只判断当OptionId是我们自定义的选项组时才调用PrintDocument的InvalidatePreview方法，如果是标准选项就会忽略，这样就不会发生异常。即
private async void OptionDetails_OptionChanged(PrintTaskOptionDetails sender, PrintTaskOptionChangedEventArgs args) { if (args.OptionId == null) return; string optID = args.OptionId as string; if (optID == OPTION_OPACITY || optID == OPTION_ANGLE) { await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () => { _printdoc.InvalidatePreview(); }); } }
=====================================================
不知不觉中，示例已经完成了，现在来运行一下。
运行后如下图：
点打印按钮，打开打印对话框。在打印对话框中，你可以进行参数设置。
最后看看打印结果。
好了，今天咱们就聊到这儿，下次有空咱们继续吹牛。
示例下载地址：http://files.cnblogs.com/files/tcjiaan/customPrintOptionSample.zip
