Использование Microsoft ScriptControl

Анатолий Тенцер

Введение

Добавление TScriptControl в программу

   Импорт ActiveX-сервера

   Настройка свойств и вызов скриптов

Интеграция TScriptControl с VCL

   Модель расширения TScriptControl

   Интерфейс IDispatch

   function GetIdsOfNames

   function Invoke

   Информация RTTI Delphi

   Сводим воедино

   Пишем GetIdsOfNames

   Пишем Invoke

Оператор For Each

   Интерфейс IEnumVariant

   Класс TVCLEnumerator

Компонент TVCLScriptControl

Заключение

Введение

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

В то же время в Windows, как правило, уже имеется достаточно качественный интерпретатор, который может быть легко встроен в вашу программу. Речь идет о Microsoft ScriptControl. Он устанавливается вместе  с Microsoft Internet Explorer, входит в Windows 2000 и Windows 98, а для младших версий доступен в виде свободно распространяемого отдельного дистрибутива, объем которого составляет около 200 Кбайт. Его можно получить по адресу http://msdn.microsoft.com/scripting или установить с нашего компакт-диска. В дистрибутив входят ActiveX-компонент и файл помощи с описанием его свойств и методов.

В начало В начало

Добавление TScriptControl в программу

Импорт ActiveX-сервера

Чтобы добавить Microsoft ScriptControl на палитру компонентов Delphi, необходимо импортировать компонент ActiveX под названием Microsoft ScriptControl.

После этого на закладке ActiveX появится невизуальный компонент TScriptControl, который можно разместить на форме.

В начало В начало

Настройка свойств и вызов скриптов

Рассмотрим ключевые свойства и методы TScriptControl.

property Language: String

Задает язык, интерпретатор которого будет реализовывать компонент. В стандартной поставке доступны VBScript и JScript, однако, если в вашей системе установлены расширения Windows Scripting, возможно использование других языков, таких как Perl или Rexx.

property Timeout: Integer

Задает интервал исполнения скрипта, по истечении которого генерируется ошибка. Значение –1 позволяет отключить ошибки, связанные с истечением отведенного времени (timeout), что  позволит скрипту исполняться неограниченное время.

property UseSafeSubset: Boolean

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

procedure AddCode(const Code: WideString);

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

  ScriptControl1.AddCode(Memo1.Text);  

function Eval(const Expression: WideString): OleVariant

Выполняет код, заданный в параметре Expression, и возвращает результат исполнения. Позволяет выполнить код без добавления его к списку процедур компонента.

procedure AddObject(const Name: WideString; Object_: IDispatch; AddMembers: WordBool);

Добавляет объект к пространству имен компонента. Объект должен быть сервером автоматизации. Добавленный объект доступен как объект в коде скрипта. Например, если в программе создан сервер автоматизации  External, реализующий метод DoSomething(Value: Integer), то, добавив объект

 ScriptControl1.AddObject(‘External’, TExternal as IDispatch, FALSE);  

мы можем в коде скрипта использовать его следующим образом:

Dim I
 I = 8 + External.DoSomething(8)  

function Run(const ProcedureName: WideString; var Parameters: PSafeArray): OleVariant;

Выполняет именованную процедуру из числа ранее добавленных при помощи метода AddCode. В массиве Parameters могут быть переданы параметры.

procedure Reset;

Сбрасывает компонент в начальное состояние, удаляя все добавленные ранее объекты и код.

Таким образом, TScriptControl представляет собой достаточно гибкую исполняющую систему с возможностями расширения путем добавления в ее пространство имен серверов автоматизации.

В начало В начало

Интеграция TScriptControl с VCL

В существующем виде возможности TScriptControl сильно ограничены сложным доступом к классам VCL. Исполнение интерпретируемого кода – это хорошо, однако хотелось бы иметь возможность обращаться из него к компонентам в программе, получать и устанавливать их свойства, обрабатывать возникающие в них события, например, следующим образом:

Sub Main()
   Dim Control
   Control = Self.Controls("Panel2")
   Control.Add "Panel3", "TPanel"
   With Panel3
     .Align = "alTop"
     .BevelOuter = "bvNone"
     .Height = 40
     .Caption = ""
     .Add "Btn", "TButton", True
     With Btn
      .Top = 10
      .Left = .Top
      .Caption = "Click me"
     End With
 
   End With
 End Sub  
Sub Btn_OnClick()
   Dim StatusBar
   Dim Panel
   Dim I
   I = 0
   For Each Panel in StatusBar.Panels
     I = I + 1
     with Panel
       .Text = .Text & " " & CStr(I)
     End With
   Next
 End Sub  

Следующая часть главы посвящена реализации такой функциональности, однако прежде чем приступить к ее исполнению, необходимо более подробно рассмотреть некоторые механизмы, лежащие в основе модели расширения TScriptControl и VCL.

В начало В начало

Модель расширения TScriptControl

Как уже было сказано выше, Microsoft ScriptControl позволяет сделать доступными из скрипта объекты, реализованные в программе при помощи метода AddObject. При обращении к таким объектам он предполагает, что они реализуют интерфейс IDispatch и являются, таким образом, серверами автоматизации. В Delphi в качестве таких объектов могут выступать наследники TAutoObject, создать которые можно при помощи мастера, вызываемого из меню File -> New -> ActiveX -> Automation Object. При вызове методов этих объектов ScriptControl последовательно вызывает методы GetIdsOfNames и Invoke их интерфейса IDispatch, что обеспечивает вызовы соответствующих методов объекта. Однако здесь имеются определенные сложности:

  1. По окончании работы с объектом (например, при выходе его за пределы области видимости процедуры скрипта) TScriptControl автоматически вызывает его метод _Release, что приводит к уничтожению класса Delphi. Таким образом, для каждого класса приходится создавать некий объект-представитель, который бы транслировал вызовы TScriptControl в методы и свойства класса Delphi, а став ненужным — уничтожался, не уничтожая самого класса.
  2. Функциональность наследников TAutoObject задается на этапе компиляции и не может быть расширена в процессе исполнения программы. Это требует создания отдельных представителей для каждого класса VCL, что очень сложно осуществить, к тому же при этом нельзя использовать классы, не имеющие соответствующего представителя.

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

В начало В начало

Интерфейс IDispatch

Интерфейс IDispatch обеспечивает возможность позднего связывания, то есть вызовов методов объектов не по адресам, а по именам на этапе выполнения программы. Интерфейс определен как:

  IDispatch = (IUnknown)
       ['{00020400-0000-0000-C000-000000000046}']
       GetTypeInfoCount( Count: Integer): Integer; ;
       GetTypeInfo(Index, LocaleID: Integer;
         TypeInfo): Integer; ;
       GetIDsOfNames( IID: TGUID; Names: Pointer;
         NameCount, LocaleID: Integer; DispIDs: Pointer):    Integer;
         ;
       Invoke(DispID: Integer; IID: TGUID;
         LocaleID: Integer; Flags: Word; var Params; VarResult,
         ExcepInfo, ArgErr: Pointer): Integer; ;
     ; 

Ключевыми методами интерфейса являются GetIdsOfNames и Invoke.

В начало В начало

function GetIdsOfNames

Этот метод осуществляет трансляцию имен методов и свойств объекта автоматизации в целочисленные идентификаторы. Если OLE пытается разрешить ссылку вида:

SomeObject.DoSomeThing

то у SomeObject  запрашивается интерфейс IDispatch,  вызывается метод GetIdsOfNames, которому передаются ссылка на массив имен, требующих разрешения в параметре Names, количество имен в параметре NameCount и региональный контекст в параметре LocaleId. Метод должен заполнить массив, на который указывает параметр DispIds, значениями идентификаторов имен. Объект имеет возможность предоставить разные имена методов для каждого поддерживаемого языка. Если это не требуется — параметр LocaleId можно игнорировать.

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

В начало В начало

function Invoke

После получения идентификатора запрошенного метода OLE вызывает функцию Invoke, передавая в нее:

DispID

Идентификатор вызываемого метода или свойства, полученный от GetIdsOfNames.

LocaleId

Региональный контекст (тот же, что и в GetIdsOfNames).

Flags

Битовая маска, состоящая из следующих флагов:

DISPATCH_METHOD Вызывается метод. Если у объекта есть свойство с таким же именем, то будет установлен также флаг DISPATCH_PROPERTYGET
DISPATCH_PROPERTYGET Запрашивается значение свойства
DISPATCH_PROPERTYPUT Устанавливается значение свойства
DISPATCH_PROPERTYPUTREF Параметр передается по ссылке. Если флаг не установлен – по значению.

Params

Структура DISPPARAMS, содержащая массив параметров, массив идентификаторов для именованных параметров и количества элементов в этих массивах. Параметры передаются в порядке, обратном порядку их следования в функции, как это принято в Visual Basic.

VarResult

Адрес переменной типа OleVariant, в которую должны быть помещены результат вызова метода, или значение свойства, или , если возвращаемое значение не требуется.

ExcepInfo

Адрес структуры EXCEPTINFO, которую метод должен заполнить информацией об ошибке, если она возникнет.

ArgErr

Адрес массива, в который должны быть помещены индексы неверных параметров, в случае если такая ситуация будет обнаружена.

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

Как видно из описания Idispatch, имеется возможность самостоятельно реализовать этот интерфейс, динамически преобразуя обращения к объекту автоматизации в обращения к соответствующим свойствам классов Delphi.

В начало В начало

Информация RTTI Delphi

Delphi имеет свой внутренний протокол, позволяющий осуществлять обращение к опубликованным (объявленным в секции published) свойствам и методам класса. Этой цели служат функции модуля TypInfo.pas. Ключевой является функция

 GetPropInfo(TypeInfo: PTypeInfo;
    PropName: ): PPropInfo;  

которая позволяет по имени свойства получить адрес структуры PPropInfo, содержащей информацию о свойстве. В дальнейшем можно получить значение этого свойства при помощи функций GetXXXProp или установить его функциями SetXXXProp. При этом будут корректно вызваны функции получения или установки свойства. Таким образом, по имени свойства можно определить его наличие и установить или получить его значение. Такая возможность позволяет создать реализацию IDispatch, динамически транслирующую обращения к свойствам зарегистрированного в TScriptControl объекта автоматизации в обращения к свойствам связанного с ним экземпляра класса VCL.

В начало В начало

Сводим воедино

Итак, как показано выше, RTTI Delphi предоставляет достаточную функциональность для того, чтобы обеспечить трансляцию вызовов OLE-Automation в обращения к свойствам компонентов VCL. Для этого необходимо:

  1. В методе GetIdsOfNames проверить существование свойства при помощи функции GetPropInfo и, если такое свойство найдено, вернуть какой-нибудь числовой идентификатор. В роли такого идентификатора удобно использовать результат, возвращаемый функцией GetPropInfo.
  2. В методе Invoke установить или получить значение свойства, используя функции GetXXXProp или SetXXXProp.

Для трансляции вызовов OLE в VCL создадим класс TVCLProxy:

  // Этот интерфейс понадобится для получения ссылки на
   // класс VCL из методов, в которые передается его
   // интерфейс IDispatch
   IQueryPersistent = 
  ['{26F5B6E1-9DA5-11D3-BCAD-00902759A497}']
      GetPersistent: TPersistent;
   ;
 
   TVCLProxy = (TInterfacedObject, IDispatch, IQueryPersistent)
   
     FOwner: TPersistent;
     FScriptControl: TVCLScriptControl;
      DoCreateControl(AName, AClassName: WideString;
       WithEvents: Boolean);
      SetVCLProperty(PropInfo: PPropInfo;
       Argument: TVariantArg): HRESULT;
     GetVCLProperty(PropInfo: PPropInfo; dps: TDispParams;
       PDispIds: PDispIdList; var Value: OleVariant): HRESULT;
     { IDispatch }
      GetTypeInfoCount(out Count: Integer): HResult; ;
      GetTypeInfo(Index, LocaleID: Integer;
        TypeInfo): HResult; ;
      GetIDsOfNames( IID: TGUID; Names: Pointer;
       NameCount, LocaleID: Integer;
       DispIDs: Pointer): HResult; ;
      Invoke(DispID: Integer;  IID: TGUID;
       LocaleID: Integer; Flags: Word;  Params;
       VarResult, ExcepInfo, ArgErr: Pointer): HResult; ;
     { IQueryPersistent }
      GetPersistent: TPersistent;
   
      DoInvoke (DispID: Integer;  IID: TGUID;
       LocaleID: Integer; Flags: Word; var dps : TDispParams;
       pDispIds : PDispIdList; VarResult, ExcepInfo,
       ArgErr: Pointer): HResult; ;
   
      Create(AOwner: TPersistent;
       ScriptControl: TVCLScriptControl);
      Destroy; ;
   ;  

Экземпляр этого класса создается при регистрации объекта в TScriptControl и уничтожается автоматически, когда потребность в нем исчезает.

Поле FOwner хранит ссылку на экземпляр класса VCL, интерфейс к которому предоставляет объект, зарегистрированный в TScriptControl. TVCLScriptControl – это наследник TScriptControl.

Главным его отличием является наличие списка зарегистрированных экземпляров TVCLProxy и обработчиков событий, позволяющих компонентам VCL вызывать методы скрипта.

В начало В начало

Пишем GetIdsOfNames

В методе GetIdsOfNames мы должны проверить наличие запрошенного свойства и вернуть адрес его структуры TPropInfo, если такое свойство найдено.

Свойства компонентов VCL

 TVCLProxy.GetIDsOfNames( IID: TGUID; Names: Pointer;
   NameCount, LocaleID: Integer; DispIDs: Pointer): HResult;
 
   S: ;
   Info: PPropInfo;
 
   Result := S_OK;
   // Получаем имя функции или свойства
   S := PNamesArray(Names)[0];
   // Проверяем, есть ли VCL-свойство с таким же именем
   Info := GetPropInfo(FOwner.ClassInfo, S);
    Assigned(Info) 
     // Свойство есть, возвращаем в качестве DispId
     // адрес структуры PropInfo
     PDispIdsArray(DispIds)[0] := Integer(Info);

Дополнительные функции

Дополним нашу реализацию возможностью вызова некоторых дополнительных функций:

Controls

Для наследников TWinControl возвращает ссылку на дочерний компонент с именем или индексом, заданным в параметре.

Count

Для компонентов TWinControl – возвращает количество дочерних компонентов.

Для TCollection – возвращает количество элементов.

Для TStrings – возвращает количество строк.

Add

Для компонентов TWinControl – создает дочерний компонент.

Для TCollection – добавляет элемент в коллекцию.

Для TStrings – добавляет строку.

HasProperty

Возвращает истину, если у объекта есть свойство с заданным именем.

Для этого дополним метод GetIdsOfNames следующим кодом:

  // Нет такого свойства, проверяем, не имя ли это
   // одной из определенных нами функций
    CompareText(S, 'CONTROLS') = 0 
      (FOwner  TWinControl) 
       PDispIdsArray(DispIds)[0] := DISPID_CONTROLS
     
       Result := DISP_E_UNKNOWNNAME;
   
     
   CompareText(S, 'COUNT') = 0 
      (FOwner  TCollection)  (FOwner  TStrings)
         (FOwner  TWinControl) 
       PDispIdsArray(DispIds)[0] := DISPID_COUNT
     
       Result := DISP_E_UNKNOWNNAME;
     
   CompareText(S, 'ADD') = 0 
     Result := S_OK;
      (FOwner  TCollection)  (FOwner  TStrings) 
        (FOwner  TWinControl) 
       PDispIdsArray(DispIds)[0] := DISPID_ADD
     
       Result := DISP_E_UNKNOWNNAME;
     
   CompareText(S, 'HASPROPERTY') = 0 
     PDispIdsArray(DispIds)[0] := DISPID_HASPROPERTY
   
     Result := DISP_E_UNKNOWNNAME;
 ;  

Константы DISPID_CONTROLS, DISPID_COUNT и т.д. определены как целые числа из диапазона 1…1 000 000. Это вполне безопасно, поскольку адрес структуры TPropInfo никак не может оказаться менее 1 Мбайт.


Наш канал на Youtube

1999 1 2 3 4 5 6 7 8 9 10 11 12
2000 1 2 3 4 5 6 7 8 9 10 11 12
2001 1 2 3 4 5 6 7 8 9 10 11 12
2002 1 2 3 4 5 6 7 8 9 10 11 12
2003 1 2 3 4 5 6 7 8 9 10 11 12
2004 1 2 3 4 5 6 7 8 9 10 11 12
2005 1 2 3 4 5 6 7 8 9 10 11 12
2006 1 2 3 4 5 6 7 8 9 10 11 12
2007 1 2 3 4 5 6 7 8 9 10 11 12
2008 1 2 3 4 5 6 7 8 9 10 11 12
2009 1 2 3 4 5 6 7 8 9 10 11 12
2010 1 2 3 4 5 6 7 8 9 10 11 12
2011 1 2 3 4 5 6 7 8 9 10 11 12
2012 1 2 3 4 5 6 7 8 9 10 11 12
2013 1 2 3 4 5 6 7 8 9 10 11 12
Популярные статьи
КомпьютерПресс использует