Андрей Попов - Windows Script Host для Windows 2000/XP

□ элемент может содержать один или несколько элементов , или .

Обязательными для создания компонента-сценария являются элементы , , и .

Опишем теперь элементы XML, использующиеся в WSC-файлах, более подробно.

В WSC-файлы можно вставлять комментарии двумя разными способами: с помощью элемента или элемента . Например:

или

Второй комментарий

Напомним, что эти элементы являются стандартными для разметки W3C XML 1.0 (см. главу 3). Для того чтобы использовать символы кириллицы в файлах компонентов-сценариев, нужно обязательно в элементе указать атрибут encodingсо значением, соответствующим используемой кодировке, например:

Этот элемент необходим в тех WSC-файлах, в которых с помощью элементов определено более одного компонента. В этом случае является контейнером для элементов .

Если же в WSC-файле описан только один компонент, то элемент можно не использовать.

Внутри элемента описывается один компонент-сценарий (СОМ-объект). Необязательный атрибут idопределяет идентификатор объекта (это может понадобиться в том случае, когда в одном WSC-файле находится несколько СОМ-объектов).

В элементе приводится информация, которая необходима для регистрации в системе компонента-сценария в качестве СОМ-объекта.

Атрибуты progidи classidзадают соответственно программный идентификатор и глобальный код, с помощью которых компонент -сценарий может быть использован в других приложениях (например, progid="MyClass.MyObject"и classid="{424ac2bc-5732-4dea-be17-0211af99cd79}"). Из этих двух атрибутов обязательно должен быть указан хотя бы один (можно указать и оба). Если в элементе приведен только атрибут progid, то глобальный код (GUID) для описываемого объекта будет сгенерирован автоматически при регистрации объекта в системе. Рекомендуется, однако, явно указывать глобальный код объекта, т.к. в противном случае этот код может оказаться различным при регистрации объекта на разных машинах.

Глобальный код объекта может быть сгенерирован с помощью описанной ниже программы Windows Script Component Wizard.

С помощью атрибута descriptionможно задать краткое описание объекта, которое будет занесено в системный реестр при регистрации объекта.

Атрибут versionпозволяет указать номер версии описываемого объекта. Этот номер позволяет запрашивать из приложения определенную версию СОМ-объекта (он должен быть указан через точку после программного идентификатора объекта, например "Myclass.MyObject.1").

С помощью элемента внутри контейнера можно указать две функции, одна из которых будет вызываться при регистрации объекта в системе (эта функция должна иметь имя Register()), а другая — при удалении объекта из системы (эта функция должна иметь имя Unregister()).

В элементе описываются те свойства, методы и события объекта, которые после его регистрации будут доступны извне другим приложениям (клиентам автоматизации). Другими словами, этот элемент является контейнером для элементов , и .

Элемент объявляет свойство СОМ-объекта, которое будет доступно для клиентов автоматизации.

Атрибут nameопределяет имя этого свойства (в дальнейшем внутри элемента должна быть объявлена глобальная переменная с тем же именем, с помощью которой можно будет изменять значение свойства). Объявляемое свойство может быть доступно либо только для чтения (внутри контейнера указан только элемент ), либо только для записи (внутри указан только элемент ), либо и для чтения и для записи (внутри указаны как элемент , так и элемент ).

Атрибут internalNameв элементах и задает имена функций, которые будут использоваться для чтения и записи свойства соответственно (эти функции описываются внутри контейнера ). Если же атрибут internalNameне указан, то чтение (запись) свойства производится в функции с именем get_ PropertyName (put_ PropertуName ), где PropertyName — имя свойства (атрибут ).

Элемент объявляет метод СОМ-объекта, который будет доступен для внешних клиентов автоматизации.

Атрибут nameопределяет имя этого метода. В дальнейшем, если не указан атрибут internalName, внутри контейнера должна быть описана функция или процедура с таким же именем

Задание атрибута internalNameпозволяет внутри контейнера использовать для реализации метода функцию или процедуру с именем, отличным от значения аргумента name.

Список параметров метода (если они имеются) задается внутри элемента с помощью элементов , каждый из которых должен содержать аргумент name, определяющий имя параметра.

Элемент объявляет событие, которое может возникать в СОМ-объекте и обрабатываться клиентами автоматизации.

Аргумент name, как обычно, определяет имя этого события. С помощью аргумента dispidможно указать числовой идентификатор интерфейса события. Этот идентификатор компилируется в библиотеку типов объекта и используется в клиентском приложении для обработки нужного события.

Для того чтобы вызвать наступление события, внутри элемента используется функция fireEvent()с именем нужного события в качестве параметра.

Элементы , и имеют тот же смысл, что и в модели WS XML (см. описание этих элементов в главе 3).

В элементе приводится сценарий на языках JScript или VBScript, который определяет поведение создаваемого СОМ-объекта — здесь нужно задать глобальные переменные, соответствующие объявленным в элементах свойствам объекта, описать функции или процедуры для объявленных с помощью элементов методов объекта и т.д.

Перейдем теперь к рассмотрению конкретного примера, для которого мы подробно опишем создание компонента-сценария, регистрацию его в системе в качестве СОМ-объекта и использование этого объекта в JScript-сценарии.

Представим себе следующую ситуацию. Имеется несколько каталогов на жестком диске, в которых хранятся рабочие файлы разных пользователей. Необходимо каждый день с помощью программы-архиватора arj.exe делать архивы этих файлов в заданный каталог, при этом имя архивного файла должно соответствовать шаблону ппММДД.arj", где пп — уникальный для каждого пользователя префикс, ММ — текущий месяц, ДД — текущий день.

Мы создадим компонент-сценарий DateArc.WSC, с помощью свойств и методов которого можно будет выполнить поставленную задачу.