*******************************************************
Author: TMS Software
E-mail :
[email protected]
Web :
http://www.tmssoftware.com
*******************************************************
TParameterListBox (revision 1.6) :
An input box where you can set several parameters
through inplace clicking, like in the Outlook
Rules Wizard.
Delphi 1.0, 2.0, 3.0, 4.0 & C++Builder 1,3,4 components are included.
Usage :
This component is freeware for non-commercial applications.
License is equivalent to buying source code, and is available
for $30. Licensed users get source code updates for all 1.x
versions. Send cheque or cash for $30 to address above and
source code will be sent by email immediately upon receipt.
History:
21/9/97 : First version
30/9/97 : Solved flickering of mouse cursor problem
Added oncontrolclick event to position controls over
parameter when clicked
16/8/98 : revisioned version includes Delphi 4 support
21/4/99 : C++Builder 1,3,4 support
Added capability to select parameters from list
1/5/99 : Added Delphi 1 support
OnParameterActive event added
Keyboard interface added
3/6/99 : Added save/load to registry or INI file
Known issues:
There are currently no known problems with TParameterListbox
Let me know if problems show up, or if you wish other
features for this component.
Installation:
parlstd1.zip : file for Delphi 1.x
parlstd2.zip : file for Delphi 2.x
parlstd3.zip : file for Delphi 3.x
parlstd4.zip : file for Delphi 4.x
parlstc1.zip : file for C++Builder 1.x
parlstc3.zip : file for C++Builder 3.x
parlstc4.zip : file for C++Builder 4.x
1. In the delphi menu select:
Component > Install > Add > Browse
2. Select parlreg.pas and accept.
(Use : parreg16.pas in Delphi 1)
3. To set parameters, include lines like the following
to the list items :
text (parameter index,parameter name,parameter value) text
Example:
'Add person (1,your name here,testperson) to the guests'
where :
1 = the parameter index,
your name here = the parameter name
testperson = the parameter value, which you can also leave blank
To retrieve a parameter value, use the Parameter[] property.
The Parameter[i:integer] is of type string;
Example:
s:=TParameterListbox.Parameter[2] will retrieve the value
of the parameter with index 2 in the list.
Note : The delimiters of the parameters are default ( and )
but can be changed with the Delimiter property. This is
a 2 character string. The first character is the start
delimiter, the second character is the end delimiter.
4. To set the parameter when clicking the item in the list,
use the OnParameterClick event. The AIndex parameter indicates
the index of the parameter that is click on. The Name parameter
contains the default value and the Value parameter contains
the current value.
5. To specify that the parameter can be choosen from a popup lisbox,
the OnShowListEvent must be used. If for a given parameter,
AIndex, values can be choosen from a listbox, set the ShowList
parameter in the event handler to true. With the public
property ParameterListBox.ListBox, items that can be selected
from can be added in this event handler with the normal listbox
items methods (Add, Clear, ...)
