Registering the pzl-Component

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

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

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.

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 extension .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