C#进行Visio二次开发之文件导出及另存Web页面
在我前面很多关于Visio的开发过程中,介绍了各种Visio的C#开发应用场景,包括对Visio的文档、模具文档、形状、属性数据、各种事件等相关的基础处理,以及Visio本身的整体项目应用,虽然时间过去很久,不过这些技术依旧还在使用中,最近应客户培训的需要,我对所有的内容进行了重新整理,把一些没有介绍的很详细或者很少的内容进行了丰富,因此本文介绍的主题-Visio二次开发之文件导出及另存Web页面,介绍一下Visio文件另存为其他几种格式的处理,以及另存为Web文件等相关操作。
1、Visio导出为PDF格式
在一般情况下,PDF格式是较为常用的内容格式,因此Visio文档(Vsd格式)导出为PDF也是很常见的一件事情,Office文档本身很好支持PDF格式的输出,因此对于Visio来说,也不是什么难事,基本上利用它现有的API就可以导出为PDF格式了。
在Visio的Document文档对象中,就有ExportAsFixedFormat这个方法,可以导出为PDF或者XPS的格式的,这个格式有很多参数,用来确定导出那页,以及格式等设置。
expression
.ExportAsFixedFormat(
FixedFormat
,
OutputFileName
,
Intent
,
PrintRange
,
FromPage
,
ToPage
,
ColorAsBlack
,
IncludeBackground
,
IncludeDocumentProperties
,
IncludeStructureTags
,
UseISO19005_1
,
FixedFormatExtClass
)
同时,这些参数的相关说明如下所示。
Name | Required/Optional | Data Type | Description |
---|---|---|---|
FixedFormat | Required | VisFixedFormatTypes | The format type in which to export the document. See Remarks for possible values. |
OutputFileName | Optional | String | The name and path of the file to which to output, enclosed in quotation marks. |
Intent | Required | VisDocExIntent | The output quality. See Remarks for possible values. |
PrintRange | Required | VisPrintOutRange | The range of document pages to be exported. See Remarks for possible values. |
FromPage | Optional | Long | If PrintRange is visPrintFromTo , the first page in the range to be exported. The default is 1, which indicates the first page of the drawing. |
ToPage | Optional | Long | If PrintRange is visPrintFromTo , the last page in the range to be exported. The default is -1, which indicates the last page of the drawing. |
ColorAsBlack | Optional | Boolean | True to render all colors as black to ensure that all shapes are visible in the exported drawing. False to render colors normally. The default is False . |
IncludeBackground | Optional | Boolean | Whether to include background pages in the exported file. The default is True . |
IncludeDocumentProperties | Optional | Boolean | Whether to include document properties in the exported file. The default is True . |
IncludeStructureTags | Optional | Boolean | Whether to include document structure tags to improve document accessibility. The default is True . |
UseISO19005_1 | Optional | Boolean | Whether the resulting document is compliant with ISO 19005-1 (PDF/A). The default is False . |
FixedFormatExtClass | Optional | [UNKNOWN] | A pointer to a class that implements the IMsoDocExporter interface for purposes of creating custom fixed output. The default is a null pointer. |
我们在代码里面导出PDF如下所示。
SaveFileDialog dlg = newSaveFileDialog();
dlg.FileName= "";
dlg.Filter= "Pdf文件 (*.pdf)|*.pdf|AutoCAD 绘图 (*.dwg)|*.dwg|所有文件(*.*)|*.*";
dlg.FilterIndex= 1;if (dlg.ShowDialog() ==DialogResult.OK)
{if (dlg.FileName.Trim() != string.Empty)
{
VisDocument.ExportAsFixedFormat(Visio.VisFixedFormatTypes.visFixedFormatPDF,
dlg.FileName,
Visio.VisDocExIntent.visDocExIntentScreen,
Visio.VisPrintOutRange.visPrintAll,1, VisDocument.Pages.Count, false, true, true, true, true,
System.Reflection.Missing.Value);
}
}
这样,我们通过指定PDF格式,以及导出文件名,以及起止页码等信息后,就可以顺利导出对应的Visio文档了,这种方式导出的Visio文档,效果非常好,可以放大到最大清晰都很好的。
2、Visio另存为CAD格式
Visio和CAD之间是比较好的兼容模式的,Visio和CAD本身都是基于矢量图形的绘制,因此转换为CAD在继续进行编辑也是很常见的事情,因此在较早时期,Visio本身就对CAD格式(dwg格式)就提供了很好的支持,它可以通过下面代码进行CAD格式的导出。
SaveFileDialog dlg = newSaveFileDialog();
dlg.FileName= "";
dlg.Filter= "AutoCAD 绘图 (*.dwg)|*.dwg|所有文件(*.*)|*.*";
dlg.FilterIndex= 1;if (dlg.ShowDialog() ==DialogResult.OK)
{if (dlg.FileName.Trim() != string.Empty)
{
VisApplication.ActivePage.Export(dlg.FileName);
}
}
如果CAD文件顺利导出,那么会有一个日志文件提示用户操作的结果的,如下所示。
Visio还可以导出为JPG格式,这个和CAD操作类似,都是通过Page对象的Export方法进行导出,操作代码如下所示。
SaveFileDialog dlg = newSaveFileDialog();
dlg.FileName= "";
dlg.Filter= "JPEG文件 (*.jpg)|*.jpg|所有文件(*.*)|*.*";
dlg.FilterIndex= 1;if (dlg.ShowDialog() ==DialogResult.OK)
{if (dlg.FileName.Trim() != string.Empty)
{
VisApplication.ActivePage.Export(dlg.FileName);
}
}
虽然这个导出的JPG格式,也是比较不错的,不过相对PDF的矢量效果来说,JPG放大的话,一般来说没有PDF格式那么清晰,但总体效果也还是可以。
3、Visio文档另存Web页面
对于Visio文档的另存为Web页面的操作,就没有上述几个方法那么简单了,一般需要更加复杂一点的处理方式。
虽然对于Visio文档来说,在IE上可以通过ActiveX的Visio Viewer来进行查看,不过其他浏览器都不支持,因此对于另存为Web页面的文件,这种方式显得比较通用一些,可以在各个浏览器上查看HTML页面,里面就包含了对Visio文件的显示了。
Visio的文档另存为Web页面的操作,主要思路是利用Application对象的SaveAsWebObject属性,并通过VisWebPageSettings对象进行一些导出属性的设置,如页面范围,文档分辨率等属性设置,以及是否在完成后使用浏览器打开文件等设置。
如获得对象的操作如下所示。
//获取文档的Application对象 targetApplication =targetDocument.Application;//获取并转换SaveAsWebObject对象 saveAsWebAddon =(VisSaveAsWeb)targetApplication.SaveAsWebObject;//获取保存Web页面的参数设置对象 saveAsWebSetting = (VisWebPageSettings)saveAsWebAddon.WebPageSettings;
通过获得页面参数对象,我们可以设定导出的起始页面,如下所示。
saveAsWebSetting.StartPage =startPage;
saveAsWebSetting.EndPage= endPage;
然后在绑定到具体导出的文档里面就确定对应
导出
的
文档了。
//使用AttachToVisioDoc指定那个文档作为保存页面的对象 saveAsWebAddon.AttachToVisioDoc(targetDocument);
为了提高导出Web页面的Visio清晰度,我们需要设置文档的显示比例,如下所示为使用源格式大小。
//设置其中的相关参数 saveAsWebSetting.DispScreenRes = VISWEB_DISP_RES.resSource;//显示比例
这个VISWEB_DISP_RES里面有很多参数可以设置的。
Constant | Value | Description |
---|---|---|
resSource |
0 |
Use resolution of the source image for output. |
res180x260 |
1 |
180 x 260 pixels |
res544x376 |
2 |
544 x 376 pixels |
res640x480 |
3 |
640 x 480 pixels |
res720x512 |
4 |
720 x 512 pixels |
res768x1024 |
5 |
768 x 1024 pixels |
res800x600 |
6 |
800 x 600 pixels |
res1024x768 |
7 |
1024 x 768 pixels |
res1152x882 |
8 |
1152 x 882 pixels |
res1152x900 |
9 |
1152 x 900 pixels |
res1280x1024 |
10 |
1280 x 1024 pixels |
res1600x1200 |
11 |
1600 x 1200 pixels |
res1800x1440 |
12 |
1800 x 1440 pixels |
res1920x1200 |
13 |
1920 x 1200 pixels |
resINVALID |
14 |
Reserved. |
另外还有一个参数确定是批处理方式(静默方式)还是完成后通过浏览器打开文件的方式,如下所示。
//判断是否为批处理模式 if ((flags & RunInBatchMode) != 0)
{//如果为批处理模式,那么浏览器窗口不会自动打开 saveAsWebSetting.OpenBrowser = 0;
saveAsWebSetting.SilentMode= 1;
}else{//否则保存完毕后打开对应给的浏览器显示文件 saveAsWebSetting.OpenBrowser = 1;
saveAsWebSetting.QuietMode= 1;
}
如果一切顺利,那么通过方法直接创建页面就可以了,如下所示。
saveAsWebAddon.CreatePages();//创建页面
以上的方法处理,我们一般封装在一个类里面,方便调用处理,那么在界面上,我们处理的方法就可以简单化一些。
var fileName = System.IO.Path.Combine(System.Environment.CurrentDirectory, "test.html");var success = SaveAsWebApi.SaveDocAsWebPage(this.axDrawingControl1.Document, -1, -1, fileName,
SaveAsWebApi.ShowPropertiesWindow| SaveAsWebApi.ShowNavigationBar |SaveAsWebApi.ShowSearchTool|SaveAsWebApi.ShowPanAndZoom);
MessageBox.Show(success? "成功生成Web文件" : "生成Web文件操作失败");
最后,我们就可以在各个浏览器里面查看相关的Visio文件了,这种方式比Visio Viewer的处理更通用,效果也很不错哦。