Adding/Removing pzl-Component to the Pzl-Container - История изменений

Victor Yukhtenko: /* Converting to Proxy */

2008-02-06T09:52:16Z

Converting to Proxy

← Предыдущая		Версия 11:52, 6 февраля 2008
Строка 74:		Строка 74:
	Using the Elementary PzlStudio, you may change the status of the pzl-component from the “original” to “proxy” and back.		Using the Elementary PzlStudio, you may change the status of the pzl-component from the “original” to “proxy” and back.
	===Converting to Proxy ===		===Converting to Proxy ===
	Converting the status from the “original” to “proxy” may be done by pressing the button '''Convert To Proxy''' ~~(Преобразовать в Proxy)~~. You will see the report regarding the performing the operation.		Converting the status from the “original” to “proxy” may be done by pressing the button '''Convert To Proxy'''. You will see the report regarding the performing the operation.

	[[Image:PzlStudio_ConvertOriginalToProxyMSG.png]]		[[Image:PzlStudio_ConvertOriginalToProxyMSG.png]]

Victor Yukhtenko: /* Adding */

2008-02-06T09:49:37Z

Adding

← Предыдущая		Версия 11:49, 6 февраля 2008
Строка 46:		Строка 46:
	While the performing the operation the following situations may happen:		While the performing the operation the following situations may happen:
	#If the original component added:		#If the original component added:
	##'''If the new pzl-component added to the pzl-container doesn’t use other pzl-components'',<br/>then you should accept all proposals from the IDE to add new packages to the project.		##'''If the new pzl-component added to the pzl-container doesn’t use other pzl-components''',<br/>then you should accept all proposals from the IDE to add new packages to the project.
	##'''If the new pzl-component added to the pzl-container uses some other pzl-components, which are not currently included to the pzl-container project, then you should refuse the adding such a new pzl-component to the project by the IDE.<br/>'''The inclusion of these pzl-components must be done using the Elementary PzlStudio only'''.		##'''If the new pzl-component added to the pzl-container uses some other pzl-components, which are not currently included to the pzl-container project, then you should refuse the adding such a new pzl-component to the project by the IDE.<br/>'''The inclusion of these pzl-components must be done using the Elementary PzlStudio only'''.
	#If you add the pzl-component delegate (proxy) there should not be any problems, because of it is the particular case of the rule 1.1 described above.		#If you add the pzl-component delegate (proxy) there should not be any problems, because of it is the particular case of the rule 1.1 described above.

Victor Yukhtenko: /* Invoking the Operation */

2008-02-06T09:46:42Z

Invoking the Operation

← Предыдущая		Версия 11:46, 6 февраля 2008
Строка 14:		Строка 14:
	To prepare to the performing the operation you must set the Pzl-container ('''Container Project''') project (a file of the .prj6 type) and the pzl-component ('''Component Package''') package (a file of the .pack type).		To prepare to the performing the operation you must set the Pzl-container ('''Container Project''') project (a file of the .prj6 type) and the pzl-component ('''Component Package''') package (a file of the .pack type).

	Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL and created using the [[Creation of the Pzl-~~container~~\|Elementary PzlStudio]].		Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL and created using the [[Creation of the Pzl-Container\|Elementary PzlStudio]].

	The further actions depend on the goal of the operation.		The further actions depend on the goal of the operation.

Victor Yukhtenko: /* Invoking the Operation */

2008-02-06T09:45:36Z

Invoking the Operation

← Предыдущая		Версия 11:45, 6 февраля 2008
Строка 14:		Строка 14:
	To prepare to the performing the operation you must set the Pzl-container ('''Container Project''') project (a file of the .prj6 type) and the pzl-component ('''Component Package''') package (a file of the .pack type).		To prepare to the performing the operation you must set the Pzl-container ('''Container Project''') project (a file of the .prj6 type) and the pzl-component ('''Component Package''') package (a file of the .pack type).

	Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL and created using the [[Creation of the Pzl-container\|~~Elemntary~~ PzlStudio]].		Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL and created using the [[Creation of the Pzl-container\|Elementary PzlStudio]].

	The further actions depend on the goal of the operation.		The further actions depend on the goal of the operation.

Victor Yukhtenko: /* Invoking the Operation */

2008-02-06T09:45:02Z

Invoking the Operation

← Предыдущая		Версия 11:45, 6 февраля 2008
Строка 8:		Строка 8:

	=Invoking the Operation=		=Invoking the Operation=
	All operations with the pzl-component in ~~teh~~ pzl-container such as adding , ~~removein~~ and changing the status must be done using the same form. You may invoke the form via menu item ''Tools/Add/Component To Container'''. The project of the pzl-container must be saved in ~~VIDE~~ (Ctrl-S) before performing the operation. It is not necessary to close the project in the IDE if it is opened.		All operations with the pzl-component in the pzl-container such as adding, removing and changing the status must be done using the same form. You may invoke the form via menu item '''Tools/Add/Component To Container'''. The project of the pzl-container must be saved in IDE (Ctrl-S) before performing the operation. It is not necessary to close the project in the IDE if it is opened.

	[[Image:PzlStudio AddComponentDialog.png]]		[[Image:PzlStudio AddComponentDialog.png]]
Строка 14:		Строка 14:
	To prepare to the performing the operation you must set the Pzl-container ('''Container Project''') project (a file of the .prj6 type) and the pzl-component ('''Component Package''') package (a file of the .pack type).		To prepare to the performing the operation you must set the Pzl-container ('''Container Project''') project (a file of the .prj6 type) and the pzl-component ('''Component Package''') package (a file of the .pack type).

	Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL and created using ~~the by~~ the [[Creation of the Pzl-container\|Elemntary PzlStudio]].		Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL and created using the [[Creation of the Pzl-container\|Elemntary PzlStudio]].

	The further actions depend on the goal of the operation.		The further actions depend on the goal of the operation.

Victor Yukhtenko в 09:42, 6 февраля 2008

2008-02-06T09:42:08Z

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

Victor Yukhtenko в 08:11, 6 февраля 2008

2008-02-06T08:11:36Z

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

			It is recommended to make the adding the plz-component to the pzl-Container using the Elementary PzlStudio. The manual performing this operation using the IDE may lead to the non-correspondence of some necessary links in the projects.

			Any entity may be a pzl-container - an executable application or it may be a dll-container. To make the adding operation you choose the Visual Prolog project, which is a pzl-container. If it is the main application, then the pzlPort must be added to it before. If it is the DLL, then it must be actually the pzl-container based on DLL.

			Further you choose a pzl-component package and you may choose any of ways to add the pzl-component to the pzl-container: as the original pzl-component or it will be added as the pzl-component delegate (proxy).

			You may also make a conversion of the status of the pzl-components, which was included to the pzl-container before. The status "original" may be converted to the status "proxy". The back operation is available also.

			After the operation performing is complete you may come back to the Visual Prolog IDE and work with the modified project.


	Операции над Pzl-Компонентами в Pzl-Контейнерах - добавление, удаление и изменение статуса не рекомендуется делать в IDE системы Visual Prolog. Выполнение таких операций вручную с использованием IDE может привести к рассогласованию необходимых связей.		Операции над Pzl-Компонентами в Pzl-Контейнерах - добавление, удаление и изменение статуса не рекомендуется делать в IDE системы Visual Prolog. Выполнение таких операций вручную с использованием IDE может привести к рассогласованию необходимых связей.

Victor Yukhtenko: «Adding/Removing pzl-Component at the Pzl-Container» переименована в «Adding/Removing pzl-Component to the Pzl-Container»

2008-02-05T20:48:44Z

«Adding/Removing pzl-Component at the Pzl-Container» переименована в «Adding/Removing pzl-Component to the Pzl-Container»

← Предыдущая	Версия 22:48, 5 февраля 2008
(нет различий)

Victor Yukhtenko: Новая: {{copyright}} Операции над Pzl-Компонентами в Pzl-Контейнерах - добавление, удаление и изменение статуса не ре...

2008-02-05T07:35:29Z

Новая: {{copyright}} Операции над Pzl-Компонентами в Pzl-Контейнерах - добавление, удаление и изменение статуса не ре...

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

{{copyright}}

Операции над Pzl-Компонентами в Pzl-Контейнерах - добавление, удаление и изменение статуса не рекомендуется делать в IDE системы Visual Prolog. Выполнение таких операций вручную с использованием IDE может привести к рассогласованию необходимых связей.

Однако компиляция проектов, содержащих Pzl-Компоненты, должна производится в IDE, при этом следует выполнять рекомендации, приведенные ниже.

=Вызов операции=
Операции над Pzl-Компонентой в Pzl-Контейнере (добавление, удаление и изменение статуса производятся с помощью одной и той же формы, вызываемой через меню '''Tools/Add/Component To Container'''. Проект контейнера должен быть сохранен средствами IDE (Ctrl-S). Закрывать проект не обязательно.

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

Для подготовки к выполнению операции в форме должны быть выбраны Pzl-Контейнер ('''Container Project'''), которому соответствует файл проекта .prj6 и Pzl-Компонента ('''Component Package'''), которой соответствует Файл пакета компоненты .pack.

Pzl-контейнером может быть как главное приложение, так и DLL-контейнер. Если контейнером является главное исполняемое приложение, то в него предварительно должен быть добавлен PzlPort. Если это DLL - то это должен быть именно Pzl-контейнер на основе DLL, созданный с помощью интрумента [[Создание Pzl-Контейнера|Elemntary PzlStudio]].

Дальнейшие действия определяются тем, какая операция должна быть выполнена.

=Выполнение операции=
Выполнение операции осуществляется по нажатию одной из кнопок на панели:
*'''Add As Original''' - добавить в качестве оригинала
*'''Add As Proxy''' - Добавить в качестве представителя (Proxy)
*'''Remove''' - удалить
*'''Convert To Proxy''' - преобразовать в представителя (Proxy)

После выполнения операции в Oкне Cообщений (Messages) появляется отчет о выполнении операции.

После выполнения операции следует перейти к IDE системы Visual Prolog, открыть проект (если он не открыт) и откомпилировать. Детали выполнения операций и рекоментации приведены ниже.

==Добавление==
Не имеет значения, является ли pzl-Контейнер пустым или в нем уже содержатся другие Pzl-Компоненты. Главное - добавляемая компонента до этого не должна содержаться в данном контейнере.

pzl-Компонента добавляется либо как оригинальная компонента, либо как представитель pzl-Компоненты (proxy).

Если компонента добавляется как оригинальная компонента, то все другие классы могут ее использовать, создавая ее экземпляры и выполняя все, предусмотренные ее интерфейсами, действия. Для этого нажимается кнопка '''Add As Original''' (Добавить как оригинальную).

Если Вы добавляете в данный контейнер представителя Pzl-Компоненты, то это означает, что эта pzl-Компонента находится в каком-либо контейнере (Вы можете не знать, где именно), а все классы данного контейнера взаимодействуют с ней через ее представителя, находящегося в данном контейнере. В этом случае нажимается кнопка '''Add As Proxy''' (Добавить как представителя).

Сообщение в Окне сообщений подтвердит выполнение операции.

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

Откройте проект с помощью IDE (если он не открыт) и откомпилируйте его.

В процессе компиляции возможны следующие ситуации:
#При добавлении в качестве оригинала:
##'''Если добавленный Pzl-компонент не использует другие Pzl-компоненты''',<br/>то все предолжения IDE по включению в проект других пакетов, используемых Pzl-Компонентом, '''можно принимать''' без опасений.
##'''Если добавленный Pzl-компонент использует другие Pzl-компоненты, не включенные'''<br/> к моменту компиляции в проект Pzl-Контейнера, то '''необходимо отказаться''' от предложения IDE по включению такой компоненты в данный проект.<br/>'''Включение таких дополнительных Pzl-Компонент следует произвести только с помощью Elementary PzlStudio'''.
#При добавлении в качестве представителя проблем не должно быть. Этот случай подпадает под действие правила 1.1, приведенного выше.

==Удаление==
Удаление pzl-Компоненты из Pzl-Контейнера рекомендуется осуществлять с помощью Elementary PzlStudio. Выполнение такой операции вручную с использованием IDE может привести к рассогласованию необходимых связей.

После выполнения операции в Окне Сообщений появляется отчет о выполнении операции

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

Теперь следует вернуться к IDE, если проект контейнера был ранее открыт, или в IDE открыть модифицированный проект.

После удаления pzl-Компоненты следует произвести полную перекомпиляцию проекта с использованием '''Rebuild All'''.

Удаление pzl-Компоненты может привести к нарушению целостности проекта Pzl-Контейнера. Это справедливо, если какие-либо пакеты содержат обращения к удаленной Pzl-компоненте. Строго говоря, удаление Pzl-Компоненты в таких случаях является некорректной операцией. Правильнее было бы изменить статус pzl-Компоненты, преобразовав ее в представителя (Proxy).

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

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

==Изменение Статуса pzl-Компоненты==
Pzl-Компонента может иметь статус '''Ориганал''' или '''Представитель''' (Proxy).

При добавлении Pzl-Компоненты в Pzl-Контейнер статус компоненты определяется типом операции: добавление в качестве Оригинала или в качестве Представителя.

Пользуясь Elementary PzlStudio, Вы можете изменить статус pzl-Компоненты с оригинального на Proxy и обратно.
===Конвертация в Proxy===
Изменение статуса с оригинального на Proxy производится простым нажатием на кнопку '''Convert To Proxy''' (Преобразовать в Proxy). В Окне сообщений появится отчет о выполнении операции.

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

Теперь надо перейти к IDE и откомпилировать проект.

===Конвертация в Оригинал===
Форма не имеет явной операции по преобразованию ствтуса Pzl-Компоненты с Proxy на Оригинал. Однако выполнение операции '''Add As Original''', несмотря на присутствие Pzl-компоненты в Pzl-контейнере, установит статус Pzl-Компоненты Оригинал. Отчет в Окне Сообщений покажет:

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

Теперь надо перейти к IDE и откомпилировать проект.

=References=
[[Category:VpPuZzleEn]]