标签：
原文:【Win10应用开发】自定义打印选项老周在前一篇烂文中已经给大伙伴们演示了如何打印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
标签：
原文地址：http://www.cnblogs.com/lonelyxmas/p/4712562.html
