Чтение онлайн

элемент

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

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

, , и .

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

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

или элемента . Например:

или

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

указать атрибут со значением, соответствующим используемой кодировке, например:

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

определено более одного компонента. В этом случае является контейнером для элементов .

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

можно не использовать.

Внутри элемента

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

В элементе

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

Атрибуты

и задают соответственно программный идентификатор и глобальный код, с помощью которых компонент– сценарий может быть использован в других приложениях (например, и ). Из этих двух атрибутов обязательно должен быть указан хотя бы один (можно указать и оба). Если в элементе приведен только атрибут , то глобальный код (GUID) для описываемого объекта будет сгенерирован автоматически при регистрации объекта в системе. Рекомендуется, однако, явно указывать глобальный код объекта, т.к. в противном случае этот код может оказаться различным при регистрации объекта на разных машинах.

Замечание

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

С помощью атрибута

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

Атрибут

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

С помощью элемента

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

В элементе

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

Элемент

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

Атрибут

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

Атрибут

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

PropertyName

— имя свойства (атрибут ).

Элемент

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

Атрибут

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

Задание атрибута

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

Список параметров метода (если они имеются) задается внутри элемента

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

Элемент

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

Аргумент

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