Registering the pzl-Component: различия между версиями

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

м (Новая: {{copyright}} Каждая компонента должна быть зарегистрирована по крайней мере в одном из следующих реестро...)
 
м
Строка 1: Строка 1:
{{copyright}}
{{copyright}}


Каждая компонента должна быть зарегистрирована по крайней мере в одном из следующих реестров:
Each pzl-component must be registered at least in one of the registries:
*в локальном файле пользователя, причем каждое приложение может иметь свой (персональный) файл регистрации компонент
*in the local user's file. Each application may have it's own component registration file
*в реестре HKEY_CURRENT_USER системы Windows
*in the windows registry in the folder HKEY_CURRENT_USER
*в реестре HKEY_LOCAL_MACHINE системы Windows
*in the windows registry in the folder HKEY_LOCAL_MACHINE
*в главном исполняемом приложении
*in the main executable application


Если компонента зарегистрирована более, чем в одном месте, то актуальным местом ее регистрации считается ближайшее место в указанном списке, двигаясь сверху вниз. Таким образом, возможно перекрытие актуальности одновременно зарегистрированных компонент.
If some pzl-component is registered in more then one places, then the actual place of the registration used by the Pzl-system will be the nearest place moving top to down in the list above. Thus it is possible the overlapping of the multiple registered components.


То есть, например, если pzl-Компонента зарегистрирована в локальном файле пользователя и в реестре HKEY_CURRENT_USER одновременно, то действительным местом регистрации будет считаться локальный файл пользователя.
Say, if some component is registered in the local user’s file and the same time it is registered in the Windows registry HKEY_CURRENT_USER, then actually the component registered in the local user’s file will be used.


{{note|content=
{{note|content=
'''Pzl-компоненты, содержащиеся в главных исполняемых приложениях, не регистрируются''', но доступны для использования из DLL-контейнеров, вызванных с помощью данного Pzl-Порта.
''pzl-components contained in the main applications should not be specially registered'', they are accessible from the dll-containers, accessed by the given application.


Соответственно, список pzl-компонент, содержащихся в главных исполняемых приложениях  получить невозможно.}}
Accordingly you may not get the list of pzl-components registered in the main executable applications.}}


=Вызов формы=
=Invoking the Operation=


Все операции, связанные с регистрацей Pzl-Компонент в реестрах компьютера и в файле пользователя производятся с помощью одной и той же формы, вызываемой через меню '''Tools/Register Components'''.
All operations concerned with the registration of the pzl-components in the Windows registry and in the user’s component registration file may be performed by the form invoked via menu item '''Tools/Register Components'''.


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


В форме:
In the form:
'''PzlContainer File''' - файл Pzl-контейнера (не проект, а построенная DLL) c расширением .PZL.
'''PzlContainer File''' – is the file of the pzl-container (it is not the project file but it is the built DLL) with the extension .PZL.


'''PzlRegistry File''' - файл регистрации компонент с расширнием .PZR.
'''PzlRegistry File''' – is the component registration user’s file with the extehsion .PZR.


Область формы, представленная фрагментом,  
The area in the form represented by the fragment,  


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


составляет фразу
Creates the phrase
<pre>
<pre>
View The Content Of <Чего> at Target <Где>
View The Content Of <What> at Target <Where>
Содержимое <Чего> в <Где>
</pre>
</pre>
и позволяет скомпановать задание на представление данных о регистрации:  
and this phrase gives the possibility to combine the query to get the registration information:  
*слева - содержимого какого объекта показать:
*at the left side – which entity’s content to show:
**Container - показывать содержимое pzl-Контейнера
**Container – to show the content of the pzl-container
**Registry - показывать содержимое реестра
**Registry – to show the content of the registry
*справа - какой реестр использовать для показа:
*at the right side – which type of the registry to show:
**PzlRegistry File - пользовательский файл регистрации компонент установленный в поле '''PzlRegistry File''' формы. Позиция ''PzlRegistry File'' появляется в списке только если файл регистрации выбран и установлен в поле '''PzlRegistry File'''.
**PzlRegistry File – the user’s component registry file, which is set in the field '''PzlRegistry File''' of the form. The item ''PzlRegistry File'' appears in the list if the component registry file is set in the field '''PzlRegistry File'''
**Current User - реестр HKEY_CURRENT_USER Windows
**Current User – Windows registry HKEY_CURRENT_USER  
**Local Computer - реестр HKEY_LOCAL_MACHINE Windows
**Local Computer – Windows registry HKEY_LOCAL_MACHINE


Различные комбинации выбора позволяют выбрать '''область действия операции регистрации или представления данных''' для просмотра.
A set of combinations helps to choose the ‘’’area of the visibility of the operation and the area of the action of the operation’’’.


Например,
For instance
*установка <Container> <Current User> дает выбор области представления данных о регистрации компонентов контейнера, установленного в поле '''PzlContainer File''' в реестре HKEY_CURRENT_USER Windows.
*Setting the <Container> <Current User> gives the information regarding the registration of components of the pzl-container, which is set in the field '''PzlContainer File''' in the Windows registry HKEY_CURRENT_USER.


*установка <Registry> <Current User> дает выбор области представления данных о компонентах, зарегистрированных в реестре HKEY_CURRENT_USER Windows.
*Setting the <Registry> <Current User> gives the information regarding all pzl-components registered in the Windows registry HKEY_CURRENT_USER.


Область формы, представленная фрагментом
The area of the form


[[Image:PzlStudio_RegisterComponents_ComponentList.png]]
[[Image:PzlStudio_RegisterComponents_ComponentList.png]]


Представляет список компонент из области действия операции. В качестве имен компонент используются их Условные Имена.
represents the list of the pzl-components from the area of the visibility described above. Components are represented in the list by their Aliases.


Область формы, представленная фрагментами
The area of the form


[[Image:PzlStudio_RegisterComponents_ComponentStatus.png]] и
[[Image:PzlStudio_RegisterComponents_ComponentStatus.png]] and
[[Image:PzlStudio_RegisterComponents_ComponentStatus2.png]]
[[Image:PzlStudio_RegisterComponents_ComponentStatus2.png]]


Представляет состояние регистрации компоненты (идентификатор, имя контейнера, возможность автономного старта) или группы компонент, представленной в списке компонент слева.
Represents the status of the registration of the single component (component ID, the name of the pzl-container, the possibility of the independent Run) or of the group of pzl-components, selected in the list at the right.


Дальнейшие действия определяются тем, какая операция должна быть выполнена.
The further actions are defined by the operation to be performed.


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

Версия 13:45, 6 февраля 2008

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

Each pzl-component must be registered at least in one of the registries:

  • in the local user's file. Each application may have it's own component registration file
  • in the windows registry in the folder HKEY_CURRENT_USER
  • in the windows registry in the folder HKEY_LOCAL_MACHINE
  • in the main executable application

If some pzl-component is registered in more then one places, then the actual place of the registration used by the Pzl-system will be the nearest place moving top to down in the list above. Thus it is possible the overlapping of the multiple registered components.

Say, if some component is registered in the local user’s file and the same time it is registered in the Windows registry HKEY_CURRENT_USER, then actually the component registered in the local user’s file will be used.

Info non-talk.png

pzl-components contained in the main applications should not be specially registered, they are accessible from the dll-containers, accessed by the given application.

Accordingly you may not get the list of pzl-components registered in the main executable applications.

Invoking the Operation

All operations concerned with the registration of the pzl-components in the Windows registry and in the user’s component registration file may be performed by the form invoked via menu item Tools/Register Components.

PzlStudio RegistrationForm Overview.png

In the form: PzlContainer File – is the file of the pzl-container (it is not the project file but it is the built DLL) with the extension .PZL.

PzlRegistry File – is the component registration user’s file with the extehsion .PZR.

The area in the form represented by the fragment,

PzlStudio RegisterComponents ViewPair.png

Creates the phrase 

View The Content Of <What> at Target <Where>

and this phrase gives the possibility to combine the query to get the registration information:

  • at the left side – which entity’s content to show:
    • Container – to show the content of the pzl-container
    • Registry – to show the content of the registry
  • at the right side – which type of the registry to show:
    • PzlRegistry File – the user’s component registry file, which is set in the field PzlRegistry File of the form. The item PzlRegistry File appears in the list if the component registry file is set in the field PzlRegistry File
    • Current User – Windows registry HKEY_CURRENT_USER
    • Local Computer – Windows registry HKEY_LOCAL_MACHINE

A set of combinations helps to choose the ‘’’area of the visibility of the operation and the area of the action of the operation’’’.

For instance

  • Setting the <Container> <Current User> gives the information regarding the registration of components of the pzl-container, which is set in the field PzlContainer File in the Windows registry HKEY_CURRENT_USER.
  • Setting the <Registry> <Current User> gives the information regarding all pzl-components registered in the Windows registry HKEY_CURRENT_USER.

The area of the form

PzlStudio RegisterComponents ComponentList.png

represents the list of the pzl-components from the area of the visibility described above. Components are represented in the list by their Aliases.

The area of the form

PzlStudio RegisterComponents ComponentStatus.png and PzlStudio RegisterComponents ComponentStatus2.png

Represents the status of the registration of the single component (component ID, the name of the pzl-container, the possibility of the independent Run) or of the group of pzl-components, selected in the list at the right.

The further actions are defined by the operation to be performed.

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

Просмотр состояния реестров и снятие в них компонент с учета

Для просмотра состояния реестров на предмет регистрации Pzl-Компонент достаточно выбрать соответствующие позиции из списков строки

PzlStudio RegistryDataSelector.png

Если для рассмотрения нужен еще и файл регистрации компонент, то его можно установить в поле PzlRegistration File.

В левом поле должно быть установлено значение "Registry", в правом - соответсвтующее место регистрации.

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

PzlStudio RegistryView ComponentsGroupUnselected.png

либо выбранной компоненты

PzlStudio RegistryView ComponentSelected.png

Используя кнопки для управления операциями регистрации, можно снять выбранные компоненты с регистрации

  • индивидуально или в группе, отметив Pzl-компоненту или группу и нажав Unregister Selected
  • или все, нажав Unregister All

в рассмотриваемом реестре. В окне сообщений формы будет получен отчет о выполненной операции

PzlStudio RegistryView ComponentsUnselected.png

Просмотр состояния и регистрация компонент контейнера

Для просмотра состояния регистрации компонент контейнера следует установить имя файла контейнера в поле PzlContainer File, и выбрать просмотр

Show The Content Of <Container> At Target <Имя контейнера>

Теперь будут показан список всех компонент выбранного контейнера и состояние их регистрации в выбранном реестре

PzlStudio ContainerView ComponentsUnselected.png

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

PzlStudio ContainerView ComponentSelected.png

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

  • Register All - зарегистрировать все компоненты контейнера
  • Register Selected - зарегистрировать выделенные компоненты
  • Unregister All - снять с регистрации в выбранном реестре все компоненты данноого контейнера
  • Unregister Selected - снять с регистрации в выбранном реестре выделенные компоненты данноого контейнера

В Окно сообщений формы будет выведен отчет о выполнении операции.

References

Источник — https://wikiru.visual-prolog.com/index.php?title=Registering_the_pzl-Component&oldid=2136