CSMeter
Custom control contained in CSMETER.VBX
Purpose:
The CSMeter control gives a visual representation of percentage data.  CSMeter operates in two modes set
by the PercentMode property.  Standard percent mode (0-100%) or in user mode (-32768 - 32767).  In
Standard mode, percentages in the 0 - 100 range are passed to CSMeter through the PercentValue property. 
The percentage value may be displayed in the center of the control when the value of the ShowPercent
property is -1.  The ShowPercent property default is 0.  In Usermode, the MinValue and MaxValue properties
set a range that Uservalue is compared to.  The percentage of UserValue in relation to the range is then
displayed graphically as well as numerically by CSMeter.
When in UserMode, the PercentValue property may be read to get the percent value that is being displayed. 
The PercentValue property is read only in UserMode.

Properties:

BackColor             Height        *PercentValue
*BevelWidth           Index         *ShowPercent
*BorderEffect         Left          Tag
BorderStyle           *MaxValue     Top
*Direction            *MinValue     *UserValue
Enabled               Name          Visible
ForeColor             *PercentMode  Width

* = Custom property or eventBevelWidth
(Custom Property)

SUPPORTED BY:
CSMeter

Purpose:
The BevelWidth property sets the width of a CSMeter control's border as specified by BorderEffect.

Syntax:
[form.]CSMeter.BevelWidth[ = integer%]

Design Time Interface: 
Edit window

Data Type: 
Integer

Usage: 
Read/Write at design and run time

Comments: 
The BevelWidth property accepts pixel values only.
BorderEffect
(Custom Property)

SUPPORTED BY:
CSMeter

Purpose: 
The BorderEffect property lets you create a sunken or raised effect for an Edit control by drawing an
additional frame around the control. 

Syntax: 
[form.]CSMeter.BorderEffect[ = integer%]

Design Time Interface: 

       List Box: 
              0 - None 
              1 - Pop (Convex Frame)
              2 - Drop (Concave Frame) 
              3 - Drop Shadow

Runtime Data Type: 
Integer 

Usage: 
Read/Write at runtime and design time 

Comments: 
When this property is set to either 1 or 2, an additional border is  drawn around the control (outside any
existing border drawn when BorderStyle = 1).  When BorderEffect = 1 the top and left sides are  drawn in
white, and the bottom and left sides are grey.  All four sides are drawn 15 Twips wide. 
When BorderEffect is set to 3, a drop shadow will be drawn along the bottom and right sides of the control's
frame.PercentMode
(Custom Property)

SUPPORTED BY:
CSMeter

Purpose:
The PercentMode property determines whether a CSMeter control uses the PercentValue property for input
in a range of 0 to 100, or the UserValue property based on the MinValue/MaxValue range.

Syntax:
[form.]CSMeter.PercentMode[ = integer%]

Design Time Interface:
       List Box:
       0 - Standard (0-100%)
       1 - User Value (Min/Max)
       2 = Data Type:

Integer

Usage:
Read/Write at design and run time

Comments:
If PercentMode is to be changed at runtime, then the value propertiesPercentValue for standard mode,
or user value for user modemust be set afterwards in order for it to take effect.
PercentValue
(Custom Property)

SUPPORTED BY:
CSMeter

Purpose:
The PercentValue property sets or returns a standard percentage value (0 - 100) in a CSMeter control.

Syntax:
[form.]CSMeter.PercentValue[ = integer%]

Design Time Interface: 
Edit Window

Data Type:  
Integer (0 - 100)

Usage: 
Read/Write at design time
Read/Write at runtime when in Standard percent mode 
Read only at runtime when in User percent mode

Comments:
Use this property to set or retrieve the current percentage represented by the CSMeter control.ShowPercent
(Custom Property)

SUPPORTED BY:
CSMeter

Purpose:
The ShowPercent property enables/disables the numeric percentage display on a CSMeter control.

Syntax:
[form.]CSMeter.ShowPercent[ = boolean%]

Design Time Interface: 
True/False List Box

Data Type:
Boolean Integer

Usage:
Read/Write at design and run time
UserValue
(Custom Property)

SUPPORTED BY:
CSMeter

Purpose: 
The UserValue property sets the value on a CSMeter control within the range determined by the MinValue
and MaxValue properties.

Syntax: 
[form]CSMeter.UserValue[ = integer%]

Design Time Interface: 
Edit Window

Data Type:
Integer

Usage: 
Read/write at design and run time when in user PercentMode.  Not active when in standard PercentMode.

Comments: 
UserValue sets a value that is converted into a percentage of the MinValue to MaxValue range.  The resulting
percentage is displayed and also set into the PercentValue property.  If the control is in Standard mode, this
property is ignored.