Running a Component: различия между версиями

Материал из wikiru.visual-prolog.com

м
Строка 1: Строка 1:
{{copyright}}
{{copyright}}


Elementary PzlStudio позволяет запускать в работу pzl-Компоненты, хранящиеся на Вашей машине.
Elementary PzlStudio gets the possibility to run the pzl-components, which are stored on your computer.
Для того, чтобы это сделать:
To run the pzl-component:
*Компонента должна быть создана с добавлением интерфейса SpbRun, то есть при ее создании должна быть установлена опция RunAble=true
*The component must be created supporting the interface SpbRun, i.e. while the creation of the component with the use of Elementary PzlStudio the option RunAble had to be set true RunAble=Yes
*Исполнение предиката spbRun интерфейса spbRun компоненты должно приводить к появлению на экране средств взаимодействия с пользователем
*The execution of the predicate spbRun from the interface spbRun must lead to appearing the user communicating process
*Компонента должна быть включена в какой-либо контейнер (в принципе, в любой), уровень лицензии которого не выше уровня лицензии Elementary SpbStudio и этот контейнер должен быть откомпилирован (построен)
*The Pzl-component must be included into some pzl-container, which version is not hier than the license level of the Elementary SpbStudio. This container must be built
*Компонента должна быть зарегистрирована в любом из доступных мест регистрации
The pzl-component must be registered in any accessible place of the registration


=Форма для запуска компонент=
=Invoking the Operation=


Вызов формы, позволяющей запускать компоненты, производится через меню '''Tools/Run Component'''.
The pzl-components may start running from the form, whcih must be invked via menu item '''Tools/Run Component'''.


[[Image:PzlStudio_RunComponentForm.png]]
[[Image:PzlStudio_RunComponentForm.png]]


В дереве компоненты сгруппированы по разделам. Каждому разделу соответствует физическая директория на диске, кроме директории $(PzlApplicaionPort).
In the tree, which you can see here all components are grouped. Each group corresponds to the phisical directory on the disk except the folder $(PzlApplicaionPort).


Именами разделов являются как имена предопределенных логических директорий, так и имена реальных физических директорий, в которых содержаться Pzl-Контейнеры с Pzl-Компонентами. При этом имена Pzl-Контейнеров не используются.
Each part of the tree has the name. The name may be a predefined logical name or it may be the name of the physical directory, where real pzl-containers are placed. You cannot see the names of the pzl-containers here.


Предопределенные логические директории явлюятся директориями, относящимися к комплексу средств SpbSolutions:
The predefined logical directories are the directories, related to SpbSolutions folders:
*$(Demo) - демонстрационные компоненты: Pzl(SpbSolutions/VpPuZzle/Demo),
*$(Examples) - Examples of pzl-components: Pzl(SpbSolutions/VpPuZzle/Examples/PZL),
*$(Studio) - компоненты, обеспечивающие работу PzlStudio: Pzl(SpbSolutions/VpPuZzle/Studio/PZL)
*$(Studio) - components, which support the functionality of the PzlStudio: Pzl(SpbSolutions/VpPuZzle/Studio/PZL)
*$(VpPuZzleCommon) - компоненты общего назначения: Pzl(SpbSolutions/VpPuZzle/PZL)
*$(VpPuZzleCommon) - general purpose pzl-components: Pzl(SpbSolutions/VpPuZzle/PZL)
*$(PzlApplicaionPort) - компоненты главного исполняемого приложения (физической директории нет).
*$(PzlApplicaionPort) - pzl-components contained in the main executable application (no correspondence to physical directory).


В качестве имен компонент используются их Условные имена.
The components in the tree have names, which are component Aliases.


В дереве представлены только компоненты, поддерживающие интерфейс SpbRun, и зарегистрированные в одном из реестров. Если компонента зарегистрирована более, чем в одном реестре, то в дереве представляется та компонента, которая является актуальной.
There are the only pzl-components, which support the SpbRun interface SpbRun and which are registered in one of the registries. If the pzl-component is registered in more than one places, then the only actual component is represented in the tree according to the registration overlapping rule.


В следующем за деревом поле можно набрать имя компоненты вручную. В этом же поле появляется имя компоненты, отмеченной в дереве.
In the field below the tree it is possible to type the name of the component manually. If the component is selected in the tree, then this field reflects the name of the selected component.


Поле '''Parameter''' предназначено для ввода параметра, передаваемого компоненте при запуске. Значение этого параметра передается как текстовый параметр предиката SpbRun('''ВходнойТекст'''). Значения параметров, использованные при запусках данной компоненты сохраняются и представляются в списке.
The field '''Parameter''' is used to enter the input parameter. The value of that parameter is transferred to the pzl-component as teh text parameter of the predicate SpbRun('''InputText'''). The values of parameters, which was used while running the given component are stored and represented as the list.


=Вызов компоненты=
=Run the pzl-Component=
Для вызова компоненты необходимо:
To invoke the component run you must:
*Выделить компоненту, вызов которой предполагается, или набрать ее имя в поле, следующем за деревом компонент.
*Select the component, which is supposed to run, or type it's name in the field below the tree.
*Установить при необходимости значение в поле '''Parameter''' для компоненты или выбрать значение из списка ранее использовавшихся.
*Type if needed the value in the Parameter field '''Parameter''' or choose the value from the list.
*Нажать на кнопку '''Run''' или сделать двойной щелчек на имени компоненты.
*Press the button '''Run''' or double click on the name of the component in the tree.


Форма не закрывается и возможен вызов нескольких компонент одновременно.
You may call several component same time.


Окно сообщений MessageWindow среды Elentary PzlStudio является для всех компонент стандартным потоком вывода, поэтому сообщения компонент, направляемые в стандартный поток вывода будет представлены в окне сообщений (MessageWindow).
The Message Window of the Elementary PzlStudio is the standard output stream for all components, so messages sent by components to the standard output stream will be seen in the Message Window.


=References=
=References=
[[Category:VpPuZzleEn]]
[[Category:VpPuZzleEn]]

Версия 17:38, 6 февраля 2008

Автор: Виктор Юхтенко

Elementary PzlStudio gets the possibility to run the pzl-components, which are stored on your computer. To run the pzl-component:

  • The component must be created supporting the interface SpbRun, i.e. while the creation of the component with the use of Elementary PzlStudio the option RunAble had to be set true RunAble=Yes
  • The execution of the predicate spbRun from the interface spbRun must lead to appearing the user communicating process
  • The Pzl-component must be included into some pzl-container, which version is not hier than the license level of the Elementary SpbStudio. This container must be built

The pzl-component must be registered in any accessible place of the registration

Invoking the Operation

The pzl-components may start running from the form, whcih must be invked via menu item Tools/Run Component.

PzlStudio RunComponentForm.png

In the tree, which you can see here all components are grouped. Each group corresponds to the phisical directory on the disk except the folder $(PzlApplicaionPort).

Each part of the tree has the name. The name may be a predefined logical name or it may be the name of the physical directory, where real pzl-containers are placed. You cannot see the names of the pzl-containers here.

The predefined logical directories are the directories, related to SpbSolutions folders:

  • $(Examples) - Examples of pzl-components: Pzl(SpbSolutions/VpPuZzle/Examples/PZL),
  • $(Studio) - components, which support the functionality of the PzlStudio: Pzl(SpbSolutions/VpPuZzle/Studio/PZL)
  • $(VpPuZzleCommon) - general purpose pzl-components: Pzl(SpbSolutions/VpPuZzle/PZL)
  • $(PzlApplicaionPort) - pzl-components contained in the main executable application (no correspondence to physical directory).

The components in the tree have names, which are component Aliases.

There are the only pzl-components, which support the SpbRun interface SpbRun and which are registered in one of the registries. If the pzl-component is registered in more than one places, then the only actual component is represented in the tree according to the registration overlapping rule.

In the field below the tree it is possible to type the name of the component manually. If the component is selected in the tree, then this field reflects the name of the selected component.

The field Parameter is used to enter the input parameter. The value of that parameter is transferred to the pzl-component as teh text parameter of the predicate SpbRun(InputText). The values of parameters, which was used while running the given component are stored and represented as the list.

Run the pzl-Component

To invoke the component run you must:

  • Select the component, which is supposed to run, or type it's name in the field below the tree.
  • Type if needed the value in the Parameter field Parameter or choose the value from the list.
  • Press the button Run or double click on the name of the component in the tree.

You may call several component same time.

The Message Window of the Elementary PzlStudio is the standard output stream for all components, so messages sent by components to the standard output stream will be seen in the Message Window.

References