********************************************************************************
* Hpattl! Delphi Component                                                    *
********************************************************************************

Unit alias:       MetricReminder
Name:             Control Metric Reminder
Version:          1.01
Requires:         Delphi 2.0/3.0/4.0
Files:            MetricReminder.pas, MetricReminder.dcr, MetricReminder.txt
Last revised:     Dec 1st, 1998
Notes:            FreeWare!
Updates under:	  www.neveprise-inc.de
Mail to:	  mail@neveprise-inc.de

********************************************************************************
* MetricReminder Copyright 1998 by Neveprise Inc., SD                         *
********************************************************************************

1. Description
2. How to install
3. Working with TMetricReminder
4. Disclaimer






1. Description
================================================================================

TMetricReminder is a tiny component, designed to save and restore metric dimensions
of a form and its clients. Therefore, TMetricReminder saves Height, Width, Left
and Top properties of each component.
So, if you start your application the next time, it will be placed the same way
as when you left it.

2. How to install
================================================================================

Shall be very simple:

First, copy the files "MetricReminder.pas" and "MetricReminder.dcr" into a special
folder, e.g. "C:\Data\Delphi Progs\Components".
If you haven't already, start your Delphi IDE and select "Components|Install
components". In the dialog displayed, select wether "Into existing package"
(recommended) or "Into new package" (if so, type in a new package filename and
-folder). Click the upper button labeled "Browse" and select the MetricReminder
file in the location you copied it to.
When done, click "Ok" and let Delphi compile the whole package in the next
dialog. Close this window and TMetricReminder should have been installed.


3. Working with TMetricReminder
================================================================================

First, let me show new properties introduced by TMetricReminder:

- [custom]   SaveMethod:            specs if you want to save tha data into Registry or an inifile
- string     IniFile:               if SaveMethod set to metSaveIniFile, the data is put and read from this inifile
- string     KeyName:		    specs the Key (when SaveMethod set to metSaveRegistry under HKey_Local_Machine\Software\)
- TForm	     Form:		    form from which the metrics shall be reminded/restored
- bool	     AllComponents:	    specs if only form metrics shall be saved or en plus those of all child objects (buttons etc.)

All these properties can be set visually through Delphi's Object Inspector.

When dragged the new component onto a form, please commence setting those props:

First specify, if this component shall save its data into a specified inifile or
into the Rregistry (well, i recommend that you use a local inifile, cos such
data is not nessessary in the Registry - too much garbage that slows down working
in Windows - you should really only store public data there...).
Therefore set the SaveMethod property to metSaveIniFile and specify a filename in
the IniFile property. Additionally, enter a name for the key in this inifile, e.g.
'Form1' (property: KeyName). If you prefer to write the data into the Registry,
please set SaveMethod to metSaveRegistry and specify a KeyName.
This key should have the form 'YourCompany\ProductName\Metrics\FormName', but is
no need. The rootkey is by default HKey_Local_Machine\Software, so do not forget
to tell MetricReminder a key, otherwise the data will lie directly there!!!

How to get it work:

In the Form.OnCreate event/procedure, simply add the line:

[MetricReminder-Name].RefreshMetrics;

and in Form.OnClose or better OnCloseQuery:

[MetricReminder-Name].SaveMetrics;


NOTE: MetricReminder does not record all forms of a project, just the form you
declare in property Form. Thus, to remind all metrics of a project, drag this
component on every form. It is recommended to set AllControls to false, cos in
complex forms, the alignments of some components (e.g. CoolBar etc.) might be
corrupted.


4. Disclaimer
================================================================================

This component is freeware, meaning you can freely use and redistribute this code.
If you do so, please do only copy the original .zip file. If you perform any
modifications to code or documentation, please make a clear note into dis document!

Cos TMetricReminder is freeware, the author

a) claims that dis ware is "as is" and that there is NO guarantee that it will
work correctly, as it was intended to work.

b) is NOT responsible for ANY direct or indirect damages dis software may cause.

Notice that Neveprise takes great care with it's products, so any bad malfunction
is very unlikely.

							Blazko, March 13th, 1999

-EOF-