GetObject 函数

从文件中返回对 Automation 对象 的一个引用。

GetObject([pathname] [, class])

参数

pathname

可选项。 完整的文件路径和名称，文件中包含了要检索的对象。 如果忽略了 pathname ，那么需要 class 。

class

可选项。 对象的类。

类参数采用的语法是 appname.objectype ，包括了以下部分：

appname

必选项。 提供对象的应用程序名称。

objectype

必选项。 要创建的对象的类的类型。

说明

使用 GetObject 函数可以从文件中访问一个 Automation 对象。 可以将由 GetObject 返回的对象赋值给对象变量。 例如：

var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");

在执行这段代码时，将启动与指定的 pathname 相关的应用程序，所指定文件中的对象将被激活。 如果 pathname 是长度为零的字符串 ("") ，那么 GetObject 将返回指定类型的一个新实例。 如果忽略了 pathname 参数，那么 GetObject 将返回指定类型的当前活动实例。 如果不存在指定类型的对象，那么将出错。

一些应用程序允许激活文件的一部分。要实现此功能，可以在文件名的尾部添加一个感叹号 (!) ，然后在感叹号后跟上一个字符串来指定要激活的文件部分。关于如何创建这个字符串的详细信息，请参阅创建该对象的应用程序的文档。

例如，在一个绘画应用程序中，可能在文件中存储了绘画的很多层次。 可以使用下面的代码激活名为 SCHEMA.CAD 的图画中的一层。

var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3");

如果没有指定对象的类， Automation 将根据所提供的文件名来决定要启动的应用程序和要激活的对象。 但是，一些文件可能支持不止一种对象的类。 例如，一个图画可能支持三种不同的对象类型：应用程序对象、绘画对象，以及工具栏对象，所有这些都是同一个文件中的部分。 要指定文件中希望激活的对象，可以使用可选的 class 参数。 例如：

var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");

在前面的例子中，FIGMENT 是绘画应用程序的名称，而 DRAWING 是它支持的一种对象类型。 对象被激活后，可以使用定义的对象变量来引用它。 在前面的例子中，可以通过对象变量 MyObject 来访问新对象的属性和方法。 例如：

MyObject.Line(9, 90);
MyObject.InsertText(9, 100, "Hello, world.");
MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW");

注意 如果当前已经有了对象的实例，或者想要由已经加载了的文件创建对象，那么可以使用 GetObject 函数。 如果没有当前的实例，而且也不想由已经加载的文件来启动对象，那么可以使用 ActiveXObject 对象。

如果对象自身已经注册为单实例对象了，那么无论执行多少次 ActiveXObject 也只会创建对象的一个实例。 对于单实例对象， GetObject 在用长度为零的字符串 ("") 语法调用时总是返回相同的实例，而如果忽略了 pathname 参数就会出错。

要求

版本 5

请参阅

ActiveXObject 对象