Author: Poul Bak Copyright © 1999 - 2004 : Bak-O-Soft (Poul Bak). All rights reserved. http://bak-o-soft.dk/ Mailto:info@bak-o-soft.dk Component Version: 9.90.00.00 PBFolderDialog is the professional SHBrowseForFolder dialog with extended support for shell-folders (system-independant paths), automatic localization of captions (without external files). Work with paths or ItemIDLists. Can show both 'NewDialogStyle' for Windows ME/2000/XP and traditional style. BOTH styles can show path above the list and create new subfolders. Supports all the new flags like 'IncludeFiles'. Browse folder-shortcuts like normal folders. Supports IFolderFilter for XP. Supports local paths, UNC paths and 'MyNetworkPlaces' folders. Any path/shellfolder and even a combination can be used as start-folder as well as rootfolder. Unit 'PBShellFolders' contains functions, that makes it easy to work with shellfolders, can be used without the dialog. Using shellfolders instead of hard-coded paths is one of the requirements for getting the 'Designed for Windows...' logo. Context-sensitive help is included. A demo with source lets you test all the properties. Legal stuff: ---------------- PBFolderDialog is Shareware. The source is distributed to give you the best testing possibilities. There are no timelimits or 'nag-screens'. Some optimizations are not included in the unregistrered version. The UNREGISTRERED version may only be used for testing purposes. Applications using the UNREGISTRERED PBFolderDialog may not be distributed in any way. Applications developed using the REGISTRERED PBFolderDialog are yours alone, Bak-O-Soft have no rights to it. Of course the REGISTRERED version may only be distributed as runtime packages with your application or compiled into your application. PBFolderDialog is provided 'as-is' and Bak-O-Soft is under no circumstances responsible for any damage, what soever, that it might cause to anyone or anything. How to buy a license: ----------------------------- The price for PBFolderDialog is: $30 (Discount when paying in DKR - e-mail for details). To buy a licence online, point your browser to: http://www.regsoft.net/purchase.php3?productid=60695 for secure online ordering or: http://www.regsoft.net/purchase_nonsecure.php3?productid=60695 for nonsecure online ordering. Buying a licence gives you: The unlimited and optimized source code for this and all future versions of the product. The right to use the components in commercial applications. The right to unlimited support. A good feeling inside ! Installation: ---------------- Note: If you are upgrading, you should still follow the instructions below, simply overwriting the old files. First make sure that packagefiles (.bpl) are saved in a folder in the system-path (DOS-path). Check 'Environment settings' in Delphi ! 1. Unzip all files to a folder of your choice. 2. Note for Delphi 4/BCB4: All forms are saved as text format. To convert them into Delphi 4 binary format: Open the folder where you have unzipped the files. Doubleclick 'Convert_Forms.bat'. Now the forms are in Delphi 4 format. When you later open the forms, Delphi might tell you that 'Property does not exist'. Just ignore - the new properties are not used. 3. For unregistrered version: Copy 'Unregistrered_PBFolderDialog.dll' to your 'Windows\System' folder. For Registrered version: 'Unregistrered_PBFolderDialog.dll' is not needed. If you have it on disk you can delete it (after you have recompiled the package and all applications using it). 4. Start Delphi / C++Builder (if you haven't done so). 5. If you have unzipped to a folder that is not in the Delphi Search path, add it: Select 'Tools', 'Environment options...', 'Library' tab, add the full path to the folder to 'Library path'. 6. Select 'Files', 'Open', 'Delphi Package Source' as filetype and browse to the folder. a) Delphi/BCB 4 & 5: Select 'PBFolderDialog45Run.dpk' and 'open'. b) for BCB5: Select Project | Edit Option Source to open the package options in the editor. Add the "-LUvcl50" option to PFLAGS. a) Delphi/BCB 6+: Select 'PBFolderDialogRun.dpk' and 'open'. b) for BCB6+: Select Project | Edit Option Source to open the package options in the editor. Add the "-LUvcl" option to PFLAGS. Delphi tells you that it can't find a resource file and recreates it. That's ok. It might also tell you that the package is an older version. Press yes to: 'Is it ok to update?' 7. Click 'Compile'. Close the window and save changes. 8. Select 'Files', 'Open', 'Delphi Package Source' as filetype and browse to the folder. Delphi/BCB 4 & 5: Select 'PBFolderDialog45.dpk' and 'open'. Delphi/BCB 6+: Select PBFolderDialog.dpk' and 'open'. Delphi tells you that it can't find a resource file and recreates it. That's ok. It might also tell you that the package is an older version. Press yes to: 'Is it ok to update?' 9. Click 'Compile'. 10. Click 'Install'. Close the window and save changes. Now you have a new Palette-page named 'PB' with the new component. Install context-sensitive help: ----------------------------------------- (x is your Delphi version) 1. Move or copy PBFolderDialog.hlp' and 'PBFolderDialog.cnt' to ..\Delphix\Help folder. Either use the OpenHelp tool included in Delphi or follow the guidelines below. 2. Doubleclick 'Delphix.cnt' and 'Microsoft Help Workshop' starts. Click 'Index Files', 'add'. Type 'PBFolderDialog help' as Help title and 'PBFolderDialog.hlp' as Help filename. Click 'Ok'. 3. Include 'PBFolderDialog.cnt' on the main page (Insert above). 4. Exit 'Microsoft Help Workshop' and save the changes. 5. Repeat steps 2 - 4 with file: 'Delxvcl.cnt'. Now you have full context-sensitive help for the PBFolderDialog component. It is strongly recommended to read the help file for PBFolderDialog. ---------------------------------------------------------------------------------------------- I have included a small demo: PBFolderDialogDemo.exe to show the basics. Load, compile and run. You can easily test the properties with this demo. If you find any bugs, have any great ideas or just a comment or question, feel free to e-mail. Distribution of applications using PBFolderDialog: --------------------------------------------------------------------- If you use shellfolders in your application then 'SHFolder.dll' is required. On all newer systems, it's already installed, but to be sure, simply install 'SHFolder.dll' in the same folder as your program. Technically it's installed by Internet Explorer since version 4 (win98), so decide for yourself :-)