Creation of the Pzl-Component - История изменений

Victor Yukhtenko: /* Attributes from Basic Options */

2008-02-05T19:45:23Z

Attributes from Basic Options

← Предыдущая		Версия 21:45, 5 февраля 2008
Строка 147:		Строка 147:
	*Consol – no user interface		*Consol – no user interface

	=Attributes from Basic Options =		==Attributes from Basic Options==
	The last three positions in the form		The last three positions in the form
	*Company		*Company

Victor Yukhtenko: /* Attributes related to the basic options */

2008-02-05T07:28:23Z

Attributes related to the basic options

← Предыдущая		Версия 09:28, 5 февраля 2008
Строка 147:		Строка 147:
	*Consol – no user interface		*Consol – no user interface

	=Attributes ~~related to the basic options~~ =		=Attributes from Basic Options =
	The last three positions in the form		The last three positions in the form
	*Company		*Company

Victor Yukhtenko: /* Invoking the Operation */

2008-02-05T07:26:32Z

Invoking the Operation

Victor Yukhtenko: /* Component Name */

2008-02-05T07:25:51Z

Component Name

← Предыдущая		Версия 09:25, 5 февраля 2008
Строка 71:		Строка 71:
	'''''Please notice: the name of the final directory of the pzl-component and the name of the package may differ.''''' It has some difference from the rule used in the IDE of the Visual Prolog system. In the Visual Prolog, the name of the package defines also the name of the directory. Initially they proposed equal.		'''''Please notice: the name of the final directory of the pzl-component and the name of the package may differ.''''' It has some difference from the rule used in the IDE of the Visual Prolog system. In the Visual Prolog, the name of the package defines also the name of the directory. Initially they proposed equal.

	== Component Name ==		==Component Name==
	The name of the component defines the name of the set of files		The name of the component defines the name of the set of files
	*<Component Name>.pack,		*<Component Name>.pack,

Victor Yukhtenko в 07:24, 5 февраля 2008

2008-02-05T07:24:10Z

← Предыдущая		Версия 09:24, 5 февраля 2008
Строка 110:		Строка 110:
	The component Alias may be any (not empty, no spaces) sequence of chars and serves to identify the type of the component like "TextEditor".		The component Alias may be any (not empty, no spaces) sequence of chars and serves to identify the type of the component like "TextEditor".

	==~~Идентификатор компоненты~~==		==Component ID ==

	~~Идентификатор компоненты при ее назначении в форме может быть~~:		The component identifier may have one of the representations in the “New Component” form:
	*~~либо любой~~ (~~не пустой и не содержащей пробелов~~) ~~строкой символов~~		*any sequence (not empty, no spaces) of characters
	*~~либо строкой символов~~, ~~соответствующей уникальному идентификатору~~ UID.		*any sequence of chars, which corresponds to the UID.

	~~Первая форма идентификатора получается простым набором текста, являющегося идентификатором компоненты~~		The first representation can be created by the typing in the editable field

	[[Image:PzlStudio_ComponentIDAsString.png]]		[[Image:PzlStudio_ComponentIDAsString.png]]

	~~Вторая форма идентификатора получается нажатием кнопки справа~~.		The second representation may be generated automatically by the pressing the button at the right side of the field.

	[[Image:PzlStudio_ComponentIDAsUID.png]]		[[Image:PzlStudio_ComponentIDAsUID.png]]

	==~~Автономная Запускаемость~~==		==RunAble==

	Параметр Автономной Запускаемости (RunAble) определяет возможность выполнения компонентой своей функции самостоятельно.		The component property Runable defines the possibility to run the component independently.

	~~В форме может быть выбрано одно из двух значений~~: '''Yes''' и '''No'''. ~~Если выбрано '''Yes'''~~, ~~то компонента будет поддерживать интерфейс~~ '''SpbRun'''		It may have one of two values in the form: '''Yes''' and '''No'''. If “Yes” has been chosen, then the component will support the interface '''SpbRun'''
	<vip>		<vip>
	interface iMyInterface		interface iMyInterface
Строка 135:		Строка 135:
	...		...
	</vip>		</vip>
	~~и в файле~~ <~~Имя Компоненты~~>.pro ~~будет создан код, который должен быть конкретизирован~~:		The appropriate clause will be created in the file <ComponentName >.pro. The User must define the real code for that clause:
	<vip>		<vip>
	clauses		clauses
Строка 141:		Строка 141:
	</vip>		</vip>

	==~~Пользовательский интерфейс~~==		== UI Strategy ==
	Параметр Пользовательский Интерфейс определяет тип пользовательского интерфейса и выбирается из списка возможных значений:		The property UI Strategy defines the style of the user interface. It corresponds to the types predefined by Visual Prolog system. Here in the form the UI strategy must be chosen from the list:
	*VPI ~~- традиционный механизм графики~~		*VPI – traditional graphic engine
	*GUI ~~- объектный механизм графики~~		*GUI – object oriented graphic engine
	*Consol ~~- консольный - без графического интерфейса.~~		*Consol – no user interface

	=~~=Атрибуты из базовых свойств=~~=		=Attributes related to the basic options =
	~~Последние три позиции в форме~~		The last three positions in the form
	*Company		*Company
	*Author		*Author
	*Copyright		*Copyright
	~~устанавливаются в~~ [[~~Установка Базовых Свойств~~#Company\| ~~Базовых свойствах~~]] ~~и здесь могут быть переопределены в случае, отличном от типового~~. ~~Если Вы их здесь изменили~~, ~~то значения этих параметров в~~ [[~~Установка Базовых Свойств~~#Company\| ~~Базовых свойствах~~]] ~~не изменяются~~.		are taken from the [[Setting Basic Options#Company\|Basic Options]] and they may be redefined here if there is a need. If you modify these properties in the current form, they will not be changed in the [[Setting Basic Options#Company\|Basic Options]].

	=~~Ссылки~~=		=References=
	[[~~Категория~~:VpPuZzleEn]]		[[Category:VpPuZzleEn]]

Victor Yukhtenko: /* Interface Name */

2008-02-05T07:07:09Z

Interface Name

← Предыдущая		Версия 09:07, 5 февраля 2008
Строка 86:		Строка 86:
	...		...
	</vip>		</vip>
	Base Interface contains also ~~all needed constants~~ [[Pzl-Component#Predefined constants of the base interface of the pzl-component\| all needed constants]].		Base Interface contains also [[Pzl-Component#Predefined constants of the base interface of the pzl-component\| all needed constants]].

	The name of the base interface of the pzl-component may not be the same as the [[#Class Name\|name of the class]]. If this demand is not maintained, then the error message appears.		The name of the base interface of the pzl-component may not be the same as the [[#Class Name\|name of the class]]. If this demand is not maintained, then the error message appears.

Victor Yukhtenko в 07:05, 5 февраля 2008

2008-02-05T07:05:15Z

Внесённые изменения

Victor Yukhtenko в 20:03, 4 февраля 2008

2008-02-04T20:03:19Z

← Предыдущая		Версия 22:03, 4 февраля 2008
Строка 1:		Строка 1:
	{{copyright}}		{{copyright}}

	Pzl-~~Компонента - это пакет системы программирования~~ Visual Prolog. IDE ~~системы~~ Visual Prolog ~~создает и помещает пакет в текущий проект~~. Elementary PzlStudio ~~не работает с открытыми проектами и~~, ~~соответственно, выполняет лишь элементарную операцию создания~~ pzl-~~компоненты, независомо от проекта~~. ~~Этот пакет далее может быть помещен в любой~~ pzl-~~контейнер~~.		Pzl-component is the package of the Visual Prolog programming system. The IDE of the Visual Prolog system can create the class and the package within the currently opened project. The Elementary PzlStudio cannot deal with the Visual Prolog projects fully. The Elementary Studio performs the elementary operation, which creates the pzl-component independent of the project. The newly created pzl-component may be later placed to any pzl-container.

			To create the pzl-component it needs to fill the form, which contains the properties of the pzl-component such as the component identifier, component alias, the name of the base class and the name of the interface etc..

	~~При создании pzl-Компоненты заполняется форма~~, ~~содержащая такие параметры~~ pzl-Компоненты, как идентификатор, условное наименование, способность к автономному запуску, имя базового класса и имя базового интерфейса, место размещения в дисковом пространстве.		When the form is filled, you press the button and you get the pzl-component, which may be now embedded to any pzl-container (executable application or the DLL).

	~~Заполнив эти данные и нажав кнопку, Вы получаете готовую Pzl-Компоненту~~, ~~которая теперь может быть включена в любой из~~ pzl-~~контейнеров~~ (~~в составе исполняемого приложения или в~~ DLL).

	=Вызов операции=		=Вызов операции=

Victor Yukhtenko: Новая: {{copyright}} Pzl-Компонента - это пакет системы программирования Visual Prolog. IDE системы Visual Prolog создает и помеща...

2008-02-04T15:05:02Z

Новая: {{copyright}} Pzl-Компонента - это пакет системы программирования Visual Prolog. IDE системы Visual Prolog создает и помеща...

Новая страница

{{copyright}}

Pzl-Компонента - это пакет системы программирования Visual Prolog. IDE системы Visual Prolog создает и помещает пакет в текущий проект. Elementary PzlStudio не работает с открытыми проектами и, соответственно, выполняет лишь элементарную операцию создания pzl-компоненты, независомо от проекта. Этот пакет далее может быть помещен в любой pzl-контейнер.

При создании pzl-Компоненты заполняется форма, содержащая такие параметры pzl-Компоненты, как идентификатор, условное наименование, способность к автономному запуску, имя базового класса и имя базового интерфейса, место размещения в дисковом пространстве.

Заполнив эти данные и нажав кнопку, Вы получаете готовую Pzl-Компоненту, которая теперь может быть включена в любой из pzl-контейнеров (в составе исполняемого приложения или в DLL).

=Вызов операции=
Форма для создания pzl-Компоненты вызывается через меню '''''File/New.../Component'''''.

[[Изображение:PzlStudio_CreateNewComponent.png]]

Перечень свойств в вызванной форме включает
*[[#Базовая Директория Компонент|Components Base Directory]] - Базовая директория Ваших Компонент
*[[#Директория pzl-Копоненты|Sub-Directory]] - Маршрут к поддиректории, в которой будет создан пакет компоненты.
*[[#Имя Компоненты|Component Name]] - Имя создаваемой Компоненты (это будет имя пакета .pack)
*[[#Имя Класса|Class Name]] - Имя '''Класса''' Компоненты
*[[#Имя Интерфейса|Interface Name]] - Имя '''Интерфейса''' Компоненты
*[[#Условное имя компоненты|Component Alias]] - '''Условное имя''' Компоненты
*[[#Идентификатор компоненты|Component ID]] - '''Идентификатор''' Компоненты
*[[#Автономная Запускаемость|RunAble]] - Автономная Запускаемость
*[[#Пользовательский интерфейс|UI Strategy]] - Пользовательский интерфейс
*[[#Атрибуты из базовых свойств|Company]] - имя компании
*[[#Атрибуты из базовых свойств|Author]] - имя автора
*[[#Атрибуты из базовых свойств|Copyright]] - авторские права

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

Операция выполняется по нажатию на кнопку '''Create (Создать)'''.

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

После выполнения операции форма остается активной и Вы можете продолжить создание pzl-Компонент.

Кнопка '''Close (Закрыть)''' закрывает форму.

=Выполнение операции=

При успешном выполнении операции в окно сообщений среды Elementary PzlStudio выводится отчет о создании компоненты.

[[Изображение:PzlStudio CreatedNewComponentReport.png]]

Созданную таким образом Pzl-Компоненту можно теперь включать в контейнеры.

=Параметры для создания Pzl-Компоненты=

==Базовая Директория Компонент==
Собственно, это имя директории, установленной в [[Установка Базовых Свойств#User PzlComponent Location|Базовых Свойствах]]. Если в Ваших намерениях по организации директорий ничего не изменилось, можно ничего здесь не менять.

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

Двойной щелчек или нажатие на кнопку вызовут файловый диалог для выбора имени директории. Вы можете в Файловом диалоге установить и новое, не существующее имя директории. Elementary PzlStudio создаст ее, если это возможно.

Если Вы изменили имя базовой директории компонент относительно того, что установлено в [[Установка Базовых Свойств#User PzlComponents Location|Базовых Свойствах]], то при закрытии формы будет задан вопрос о внесении изменения в Базовые Свойства.

[[Изображение:PzlStudio_ChangeBaseComponentsDirectory.png]]

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

==Директория pzl-Компоненты==
Директория Pzl-Компоненты - это именно та директория, в которую будут помещены все файлы пакета компоненты.

Директория Pzl-Компоненты следует рассматривать как маршрут (например, в форме Дир1/Дир2/Дир3 или просто Дир1), который в совокупности с Базовой директорией компонент даст окончательный маршрут к директории, где будут создаваться файлы компоненты.

Поле '''Директория pzl-Компоенты''' не может быть пустым.

Если директория, маршрут который создается в совокупности с Базовой директорией компоненты не существует, то она будет создана без предупреждения.

Если '''Директория pzl-Компоненты''' по каким-либо причинам не может быть создана, то появится диалог с сообщением об ошибке.

'''''Обращаем внимание на то, что имя конечной директории pzl-Компоненты и имя компоненты (пакета) могут различаться, хотя первоначально они будет предложены одинаковыми.'''''

==Имя Компоненты==
Имя компоненты определяет имя набора файлов пакета
*<Имя Компоненты>.pack,
*<Имя Компоненты>.ph,
*<Имя Компоненты>.cl,
*<Имя Компоненты>.i,
*<Имя Компоненты>.pro

==Имя Интерфейса==
Имя интерфейса определяет базовый интерфейс компоненты, то есть интерфейс, который наделяет класс компоненты способностью порождать объект.
<vip>
interface iMyInterface
supports pzlComponent
...
</vip>
Базовый интерфейс будет содержать также необходимые [[Pzl-Компонента#Предопределенные константы интерфейса pzl-компоненты|атрибуты базового интерфейса]].

Имя базового интерфейса Pzl-Компоненты не может совпадать с [[#Имя Класса|именем класса]]. Если это требование не соблюдается, то появится сообщение об ошибке.

[[Изображение:PzlStudio NewComponentError SameName.png]]

Имя базового интерфейса не может быть пустым.

==Имя Класса==
Имя класса определяет базовый класс компоненты, то есть класс, который будет использован для создания экземпляра компоненты.

<vip>
class myComponent : iMyComponent
open core
...
</vip>
Имя базового класса Pzl-Компоненты не может совпадать с [[#Имя Интерфейса|именем интерфейса]]. Если это требование не соблюдается, то появится сообщение об ошибке.

Имя класса не может быть пустым.

==Условное имя компоненты==

Условное имя компоненты может быть любой (не пустой и не содержащей пробелов) строкой символов и служит для условного именования компонент, например "ТекстовыйРедактор".

==Идентификатор компоненты==

Идентификатор компоненты при ее назначении в форме может быть:
*либо любой (не пустой и не содержащей пробелов) строкой символов
*либо строкой символов, соответствующей уникальному идентификатору UID.

Первая форма идентификатора получается простым набором текста, являющегося идентификатором компоненты

[[Image:PzlStudio_ComponentIDAsString.png]]

Вторая форма идентификатора получается нажатием кнопки справа.

[[Image:PzlStudio_ComponentIDAsUID.png]]

==Автономная Запускаемость==

Параметр Автономной Запускаемости (RunAble) определяет возможность выполнения компонентой своей функции самостоятельно.

В форме может быть выбрано одно из двух значений: '''Yes''' и '''No'''. Если выбрано '''Yes''', то компонента будет поддерживать интерфейс '''SpbRun'''
<vip>
interface iMyInterface
supports pzlComponent
supports spbRun
...
</vip>
и в файле <Имя Компоненты>.pro будет создан код, который должен быть конкретизирован:
<vip>
clauses
spbRun(_UserText).
</vip>

==Пользовательский интерфейс==
Параметр Пользовательский Интерфейс определяет тип пользовательского интерфейса и выбирается из списка возможных значений:
*VPI - традиционный механизм графики
*GUI - объектный механизм графики
*Consol - консольный - без графического интерфейса.

==Атрибуты из базовых свойств==
Последние три позиции в форме
*Company
*Author
*Copyright
устанавливаются в [[Установка Базовых Свойств#Company| Базовых свойствах]] и здесь могут быть переопределены в случае, отличном от типового. Если Вы их здесь изменили, то значения этих параметров в [[Установка Базовых Свойств#Company| Базовых свойствах]] не изменяются.

=Ссылки=
[[Категория:VpPuZzleEn]]

← Предыдущая		Версия 09:26, 5 февраля 2008
Строка 15:		Строка 15:
	*[[#Components Base Directory\|Components Base Directory]]		*[[#Components Base Directory\|Components Base Directory]]
	*[[#Sub-Directory\|Sub-Directory]] – the path to the sub-directory for the component package.		*[[#Sub-Directory\|Sub-Directory]] – the path to the sub-directory for the component package.
	*[[# Component Name\|Component Name]] – the name of the package file		*[[#Component Name\|Component Name]] – the name of the package file
	*[[# Class Name\|Class Name]] – the name of the component base class		*[[#Class Name\|Class Name]] – the name of the component base class
	*[[# Interface Name\|Interface Name]] - the name of the component base interface		*[[#Interface Name\|Interface Name]] - the name of the component base interface
	*[[#Component Alias\|Component Alias]]		*[[#Component Alias\|Component Alias]]
	*[[# Component ID\|Component ID]]		*[[#Component ID\|Component ID]]
	*[[# RunAble\|RunAble]] – Boolean flag		*[[#RunAble\|RunAble]] – Boolean flag
	*[[# UI Strategy\|UI Strategy]]		*[[#UI Strategy\|UI Strategy]]
	*[[#Attributes from Basic Options\|Company]]		*[[#Attributes from Basic Options\|Company]]
	*[[# Attributes from Basic Options\|Author]]		*[[#Attributes from Basic Options\|Author]]
	*[[# Attributes from Basic Options\|Copyright]]		*[[#Attributes from Basic Options\|Copyright]]

	The editing of the option is performed in the right side of the table. The Editing supposed to be done by the explicit editing or it may be done by the pressing the button on the right side of the active field. Double clicking makes the same as pressing the button.		The editing of the option is performed in the right side of the table. The Editing supposed to be done by the explicit editing or it may be done by the pressing the button on the right side of the active field. Double clicking makes the same as pressing the button.