Documents.AddEx 方法 (Visio)

将新的模具或绘图添加到 Documents 集合，并允许通过参数传递额外信息。

语法

expression。 AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )

表达 一个代表 Documents 对象的变量。

参数

名称	必需/可选	数据类型	说明
FileName	必需	字符串	要添加的文档的类型或文件名;如果未包含路径，Microsoft Visio 将搜索 在 Application 对象的 TemplatePaths 属性中指定的文件夹和所有已发布的模板，包括已发布的第三方模板。
MeasurementSystem	可选	VisMeasurementSystem	要在新文档中使用的度量单位。 请参阅“说明”来了解可能的值。
Flags	可选	Long	指明如何打开新文档的标志。 请参阅“说明”来了解可能的值。
LangID	可选	Long	文档的语言 ID。 请参阅注解。

返回值

文档

备注

在应用于 Documents 集合时，AddEx 方法和 Add 方法类似，不同之处是 AddEx 提供了几个附加参数，调用方可在其中指定如何创建文档。

MeasurementSystem 参数应该是在 Visio 类型库中声明的 VisMeasurementSystem 的下列成员之一。

常量	值	说明
visMSDefault	0	根据“控制面板”中的区域选项设置选择公制或美制单位。
visMSMetric	1	公制度量系统。
visMSUS	2	美制单位度量系统。

Flags 参数应该是在 Visio 类型库中声明的 VisOpenSaveArgs 的下列成员中一个或多个的组合。

常量	值	说明
visAddDocked	4	在固定窗口中添加文档。
visAddHidden	64	在隐藏窗口中添加文档。
visAddMacrosDisabled	128	添加禁用了宏的文档。
visAddMinimized	16	在最小化的窗口中添加文档。
visAddNoWorkspace	256	添加不具有工作区信息的文档。
visAddStencil	512	添加新的模具文件。

LangID 参数应该是 Windows 用于对不同语言版本进行编码的标准 ID 之一。 例如，Visio 美国英语版本的语言 ID 是 &H0409。 要查看语言 ID 的列表，请在 MSDN 上的 Microsoft Platform SDK 中搜索“VERSIONINFO”。

要创建一个不基于模板的新绘图，请将空字符串 (" ") 传递给 AddEx 方法。

要创建一个基于模板的新绘图，请将“templatename.vst”传递给 AddEx 方法。 Visio 打开属于模板工作区的模具，并将与模板相关联的样式和其他设置复制到新文档。 如果模板文件名无效，则不返回任何文档并且生成错误。

要创建不基于模具的新模具，请传递 ("vss")。

要打开模具的副本，请传递 ("stencilname.vss")。

要打开绘图的副本，请传递 ("drawingname.vsd")。

注意

打开模具或绘图的副本等效于选择“打开”对话框的“打开”列表中的“以副本方式打开”，或使用带有 visOpenCopy 标志的 OpenEx 方法。

示例

以下 Microsoft Visual Basic for Applications (VBA) 宏显示如何使用 AddEx 方法创建一个基于使用默认度量系统单位的“BASICD_U.VST”模板的文档。

Public Sub AddEx_Example() 
 
 Application.Documents.AddEx "BASICD_U.VST", visMSDefault 
 
End Sub

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。