Autodesk.Revit.DB.PrintSetting技术文档

简介

Autodesk.Revit.DB.PrintSetting 是Revit API中的一个类，用于表示图纸的打印设置。PrintSetting 对象存储了用于打印图纸的所有参数，如纸张大小、打印机、打印范围和打印设置等。

构造函数

创建PrintSetting对象的方法有两种：

1.通过Document.PrintManager.PrintSetup.CurrentPrintSetting属性获取当前活动的 PrintSetting 对象。

2.通过Document.PrintManager.PrintSetup.PrintSettings属性添加新的PrintSetting对象。

属性列表

• ActualPaperSizes：获取打印机实际支持的纸张尺寸。
• ColorDepth：获取或设置打印色彩深度。
• Copies：获取或设置每份副本的打印数量。
• IsVirtual：获取或设置是否为虚拟输出打印设置。
• Name：获取或设置打印设置的名称。
• PaperPlacement：获取或设置纸张在打印过程中的位置。
• PrintDepth：获取或设置打印深度。
• PrintRange：获取或设置图纸的打印范围，可以是全部、选定的视图和区域等。
• PrintSetup：获取该PrintSetting对象所属的PrintSetup对象。
• PrinterName：获取或设置打印机名称。
• RasterQuality：获取或设置栅格图形的质量。
• RenderSettingsId：获取或设置用于渲染图形的RenderSettings的ID。
• Resolution：获取或设置打印分辨率。
• Scale：获取或设置图纸的打印比例。
• Transform：获取或设置用于转换图形的转换矩阵。

方法列表

• Clone()：克隆当前的PrintSetting对象。
• Equals(Object obj)：确定指定的对象是否等于当前对象。
• GetHashCode()：用作默认哈希函数。
• IsValidForDocument(Document document)：检查该打印设置是否与指定的文档兼容。
• ReleaseUnmanagedResources()：释放非托管资源。

使用示例

//获取当前文档的打印设置
PrintSetting currentPrintSetting = doc.PrintManager.PrintSetup.CurrentPrintSetting;

//设置纸张大小和打印机名称
currentPrintSetting.PrinterName = "Microsoft Print to PDF";
currentPrintSetting.PrintRange = PrintRange.Views;
currentPrintSetting.PaperPlacement = PaperPlacement.MiddleCenter;
currentPrintSetting.Scale = new Scale(1.0);

//将更改应用于打印设置
doc.PrintManager.Apply();

//将打印设置保存为新的打印设置
PrintSetting newPrintSetting = doc.PrintManager.PrintSetup.CurrentPrintSetting.Clone();
newPrintSetting.Name = "Custom Print Settings";
doc.PrintManager.PrintSetup.PrintSettings.Append(newPrintSetting);
doc.PrintManager.Apply();

总结

Autodesk.Revit.DB.PrintSetting类是Revit API中与打印操作紧密相关的一个类。通过该类的属性和方法，开发人员可以对图纸的打印设置进行灵活的控制，满足不同用户对打印输出的需求。在调用PrintManager对象的Apply()方法前，所有对PrintSetting对象的更改都不会影响打印输出。