APR Dialogs
===========
Version 1.0.0 last final beta
Last upd: 22.11.99
Author: Alexander Petrov, St.-Petersburg, Russia.
  E-Mail: sandy@actor.ru
  Web support and new versions: www.actor.ru/~sandy 
  

CONTENTS
========
1. INTRODUCTION
2. FEATURES
3. INSTALLATION
4. TERMS AND CONDITIONS
5. COMPONENTS
6. ABOUT SOURCE CODE AND EXTENDED VERSION

1.INTRODUCTION
==============

APR Dialogs components are designed to speed up the creation of 
custom dialogs based on the Windows Common dialogs.

It's my attempt to publish components I used before in my own apps.

This is not the first attempt to design components wich can be useful to  
create enchanced dialogs based on standard Windows common dialogs. 
See for example DS Dialogs components created by Dmitry Streblechenko 
(dmitrys@asu.edu). 

Nevetheless, I think that these components  have some advantages wich make its 
use more effective. 

I would greatly appreciate comments, suggestions or bug reports. Sent it 
to
      sandy@actor.ru

2.FEATURES
==========

1. All the dialogs are expandable. You can expand your dialogs using Delphi
forms as left, top, right, bottom parts of your dialog. All components have 
the same property CustDlgParams where you can specify this properties. 
The additional parts of dialog (your forms) are aligned to the size of 
original common dialog. Note that there is no need to use resource editor 
such as Resource Workshop to create extended dialogs.

2. There are 2 versions of the same component presented: 
"custom" and "on-palette" editions. The names of these components are:
TApCustomXXXDialog and TApXXXDialog accordingly.
On-palette components are inherited from custom versions by placing 
most new protected properties to public or published section.
The advantage of custom version is the ability to inherit your own dialog 
components from custom version where you can easily control the 
visibility of some of the properties. Keep in mind that custom versions 
are not abstract. The example of using custom component is TApOpenTableDialog 
uncluded in this component collection. This component is 
inherited from TApCustomOpenDialog component.

3. More events during "dialog-time" (when your dialog is visible).
For example there are 7 events for TApOpenDialog component instead of 
4 for standard VCL TOpenDialog component.


3.INSTALLATION
==============
Delphi 3
~~~~~~~~
a) Copy aprdlgs30.dpl package to some folder presented in PATH.
b) Choose Component/Install packages menu item in Delphi IDE. 
   Press Add.. button. Select D3/dclaprd30.dpl delphi package. 
   Package will be installed.
   Now new components are on Dialogs pallette.

C++Builder 3
~~~~~~~~~~~~
a) Copy aprdlgs35.bpl package to some folder presented in PATH.
b) Choose Component/Install packages menu item in C++Builder IDE. 
   Press Add.. button. Select BCB3/dclaprd35.bpl package. 
   Package will be installed.
   Now new components are on Dialogs pallette.

Other environments
~~~~~~~~~~~~~~~~~~
Visit www.actor.ru/~sandy to download D4 and BCB4 versions.


4.TERMS AND CONDITIONS
======================
You can freely use this software (APR Dialogs) in applications 
you create (including commercial software). 
You may not alter any of the programs or accompanying
files without the author's permission.
You can not mofily distribute package(zip archive): add new files, remove 
or edit existing ones. 

DISCLAIMER
~~~~~~~~~~
THIS PROGRAM IS PROVIDED "AS-IS". NO WARRANTIES OF
ANY KIND, EXPRESSED OR IMPLIED, ARE MADE AS TO IT
OR ANY MEDIUM IT MAY BE ON, OR ANY SOFTWARE IT WORKS WITH. 
NO REMEDY WILL BE PROVIDED FOR DIRECT OR INDIRECT DAMAGES 
ARISING FROM IT. 


5.COMPONENTS
============
The following components are included into this package:
  - TApCustomOpenDailog and TApOpenDialog
  - TApCustomSaveDailog and TApSaveDialog 
  - TApCustomFolderDialog and TApFolderDialog
  - TApDatabaseDialog 
  - TApOpenTableDialog
  - TApCustomPrintDialog and TApPrintDialog

See DOC\index.htm for the simple reference of these components (use 
your Internet browser). 


6.ABOUT SOURCE CODE AND FUTURE VERSIONS
========================================
This version of APR Dialogs is with no
help files, no source code and not all planned components.
Now the extented version is in development. It's will be free too.
Visit www.actor.ru/~sandy for last updates.

But: I do not plan to publish source code for free. So 
===  just write me (sandy@actor.ru) if you want to buy it.
     Also the following will be shipped with sources:
       -Shell components (with src):
         TApDropFiles: manages file dropping operations in Delphi forms;
         TApFileOperation: wrapper for Win32 SHFileOperation function call;
       - Reference in WinHelp format for APR Dialogs. 

More info (about payment, etc.) will be sent to you via 
your e-mail.


     ----------------------------------------------  
     With best regards             Alexander Petrov



