HKEY Property Editor
Information Sheet

Contents

• Description
• Compatibility
• Installation
• Update History
• License and Disclaimer
• About the Author

» Contents

Description

PJHKEYPropEdit.pas defines a property editor for properties of type HKEY – i.e. registry root keys. The editor causes a drop-down list of all the registry root keys supported by Delphi to be displayed in the object inspector for any property of type HKEY.

Such a property is exposed by my TPJRegWdwState component. This property editor is included with current releases of that component.

» Contents

Compatibility

The property editor compiles and works with all versions of Delphi from Delphi 2. It has been tested with Delphi 2, 3, 4, 5, 7 and 2006.

» Contents

Installation

The HKEY Property Editor and its readme file are supplied in a zip file. Before installing you need to extract all the files from the zip file, preserving the directory structure. The following files will be extracted:

• PJHKEYPropEdit.pas – property editor source code.
• ReadMe.htm – this file.
• ChangeLog.txt – change log.

You can now proceed to install the property editor. Installation methods vary between Delphi versions, so follow the instructions that apply to your version below. Note that $(DELPHI) represents the path where the appropriate version of Delphi was installed. Similarly $(BDS) refers to the installation path of a version of the Borland Development System.

• Installation with Delphi 2005 & 2006
• Installation with Delphi 3 to 7
• Installation with Delphi 2

Installation with Delphi 2005 & 2006

The property editor must be installed into a Delphi Win32 design package. It is assumed that you will be installing into an existing package. You may decide to install into the "user" package: $(BDS)\Lib\dclusr.dpk.

1. Decide upon a suitable location into which to install the property editor. This may be a subdirectory of your Borland Studio Projects or $(BDS)\lib folders.
2. Copy PJHKEYPropEdit.pas to the chosen installation folder.
3. Start the Development System (selecting the Delphi Win32 personality if appropriate) then:
   • Open the required package. Select File | Open menu and choose a suitable package source file.
   • The package will now be displayed in the Project Manager with a .bpl extension. Right click the package's entry and select Add to display the Add dialog box. Enter the full path to PJHKEYPropEdit.pas in the Unit file name edit box (use the Browse button to navigate to the file). Click OK to add the property editor to the package.
   • Back in the Project Manager, check that PJHKEYPropEdit.pas appears under the package's Contains node. If so, right click the package's entry again and select Compile. The property editor will now be installed and available for use.
   • If the property editor is not used by the Object Inspector the package may not have been installed. Install it from the Project Manager by selecting the package's Install right click menu option.
   • Close the package project using the File | Close menu item. Accept any prompt that offers to save the package project.
4. If you wish you can now delete PJHKEYPropEdit.pas from the chosen installation folder.

Installation with Delphi 3 to 7

The property editor must be installed into a design package. It is assumed that you will be installing into an existing package. You may wish to use the "user" package named dclusr.dpk or dclusrXX.dpk (where XX is a version number). This package can be found in $(DELPHI)\Lib.

1. Decide upon a suitable location into which to install the property editor. This may be a subdirectory of your $(DELPHI)\lib folder.
2. Copy PJHKEYPropEdit.pas to the chosen installation folder.
3. Start Delphi then:
   • Choose the Component | Install Component menu option to display the Install Component dialog box. Ensure the Into existing package tab is selected. Enter the full path to PJHKEYPropEdit.pas in the Unit file name edit box (use the adjacent Browse button to navigate to the file). Choose the required package from the Package description combo box, or by navigating to the package using Browse. Click OK to confirm your selections.
   • A confirmation dialog box may displayed, querying whether it is OK to rebuild and reinstall the package. Click Yes to proceed.
   • The package will now be built. If this succeeds the property editor will now be ready for use.
4. If you wish you can now delete PJHKEYPropEdit.pas from the chosen installation folder.

Installation with Delphi 2

1. Decide upon a suitable location into which to install the property editor. This may be a subdirectory of your $(DELPHI)\lib folder.
2. Copy PJHKEYPropEdit.pas to the chosen installation folder.
3. Start Delphi 2 then:
   • Select the Component | Install menu option to display the Install Components dialog box.
   • Click the Add button to display the Add Module dialog box.
   • click the Browse button. Choose PJHKEYPropEdit.pas from the resulting standard file open dialog box and click Open.
   • This returns you to the Install Components dialog box. Click OK to rebuild the component library.
   • The property editor will now be ready for use.
4. If you wish you can now delete PJHKEYPropEdit.pas from the chosen installation folder.

» Contents

Update History

A complete change log is provided in a text file that is included in the download.

» Contents

License and Disclaimer

This source code is subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this program except in compliance with the License. You may obtain a copy of the License at http://www.mozilla.org/MPL/.

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

The Original Code is PJHKEYPropEdit.pas (HKEY Property Editor).

The Initial Developer of the Original Code is Peter Johnson (http://www.delphidabbler.com/).

Portions created by the Initial Developer are Copyright © 2000-2005 Peter Johnson. All Rights Reserved.

All relevant trademarks are acknowledged.

» Contents

About the Author

I'm Peter Johnson – a hobbyist programmer living in Ceredigion in West Wales, UK, writing write mainly in Delphi. My programs are available for download from: http://www.delphidabbler.com/.