Функция GetObject (JScript 10.0)
Возвращает ссылку на объект Automation из файла. Существует две формы этой функции.
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");
Если не указать класс объекта, система автоматизации определяет приложение для запуска и объект для активации на основе указанного имени файла. Однако некоторые файлы могут поддерживать несколько классов объектов. Так, рисунок может поддерживать три разных типа объектов: объект "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 всегда возвращает один и тот же экземпляр объекта, когда вызывается со строкой нулевой длины ("") в качестве аргумента, а при вызове функции без аргумента pathname возникает ошибка.