通过

GetObject 函数 (JScript 8.0)

  • 项目

更新：2007 年 11 月

从文件中返回对自动化对象的引用。该函数有两种形式。

function GetObject(class : String)
function GetObject(pathname : String [, class : String])

参数

  • class
    必需。“appName.objectType”形式的字符串，其中 appName 是提供该对象的应用程序的名称，objectType 是要创建的对象的类型或类。

  • pathname
    必需。包含要检索对象的文件的完整路径和名称。如果省略 pathname，则必须提供 class。

备注

使用 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 将根据所提供的文件名来确定要启动的应用程序和要激活的对象。但是某些文件可能支持多个类的对象。例如，一幅图形可能支持三种不同类型的对象：Application 对象、Drawing 对象和 Toolbar 对象，所有这些对象都是同一文件的组成部分。若要指定要在文件中激活的对象，请使用可选的 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 时，GetObject 始终返回同一实例，如果省略 pathname 参数，则会导致错误。

要求

版本 5

请参见

参考

ActiveXObject 对象