Регистрация компоненты

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

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

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

  • в локальном файле пользователя, причем каждое приложение может иметь свой (персональный) файл регистрации компонент
  • в реестре HKEY_CURRENT_USER системы Windows
  • в реестре HKEY_LOCAL_MACHINE системы Windows
  • в главном исполняемом приложении

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

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

Вызов формы

Все операции, связанные с регистрацей Pzl-Компонент в реестрах компьютера и в файле пользователя производятся с помощью одной и той же формы, вызываемой через меню Tools/Register Components.

PzlStudio RegistrationForm Overview.png

В форме: PzlContainer File - файл Pzl-контейнера (не проект, а построенная DLL) c расширением .PZL.

PzlRegistry File - файл регистрации компонент с расширнием .PZR.

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

PzlStudio RegisterComponents ViewPair.png

составляет фразу

View The Content Of <Чего> at Target <Где>
Содержимое <Чего> в <Где>

и позволяет скомпановать задание на представление данных о регистрации:

  • слева - содержимого какого объекта показать:
    • Container - показывать содержимое pzl-Контейнера
    • Registry - показывать содержимое реестра
  • справа - какой реестр использовать для показа:
    • PzlRegistry File - пользовательский файл регистрации компонент установленный в поле PzlRegistry File формы. Позиция PzlRegistry File появляется в списке только если файл регистрации выбран и установлен в поле PzlRegistry File.
    • Current User - реестр HKEY_CURRENT_USER Windows
    • Local Computer - реестр HKEY_LOCAL_MACHINE Windows

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

Например,

  • установка <Container> <Current User> дает выбор области представления данных о регистрации компонентов контейнера, установленного в поле PzlContainer File в реестре HKEY_CURRENT_USER Windows.
  • установка <Registry> <Current User> дает выбор области представления данных о компонентах, зарегистрированных в реестре HKEY_CURRENT_USER Windows.

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

PzlStudio RegisterComponents ComponentList.png

Представляет список компонент из области действия операции. В качестве имен компонент используются их Условные Имена.

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

PzlStudio RegisterComponents ComponentStatus.png и PzlStudio RegisterComponents ComponentStatus2.png

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

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

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

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

Для просмотра состояния реестров на предмет регистрации 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 - снять с регистрации в выбранном реестре выделенные компоненты данноого контейнера

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

Ссылки