-------------------------------------------------------------------------------

                                   GRAFSTAT
                      Graphical Status Control version 1.0
                 Copyright (c) 1991 by Object Productivity, Inc.

===============================================================================


PURPOSE...

GrafStat is a custom control that displays a graphical gauge representing the
status of a given process.  Currently, GrafStat can emulate one general type
of gauge, the indicator.  The indicator linearly represents an integer 
magnitude within a given range by displaying, graphically, it's current value.
The indicator provides two styles, thermometer and needle.  The thermometer
style represents process-status' as a partially "filled" value-region within 
a rectangular area.  The needle style similarly represents process-status', 
except that the value region (including and previous to the value mark) is 
not filled.  All GrafStat styles allow the customization of their appearance 
and function (e.g. display value or percent text, changing colors, orientation,
etc.).  In the future, GrafStat will be extended to emulate several additional
types of gauges and many different styles.  Currently, GrafStat is simple, yet
is valuable in uses such as file-transfer, installation, data-acquisition, 
performance analysis, and compression, to name a few.


FUNCTION...

The GrafStat control has 3 general areas of functionality, namely, setting 
the style, setting the range, and setting the current value (position).  
Currently, the GrafStat control supports the two basic styles mentioned 
above (i.e. therm., needle), with additional options to effect the orientation 
of the control and the display of a current value.  When the GrafStat control 
is first created via CreateWindow, or instantiated via a dialog template, it's 
default appearance is a rectangle with a white background, red foreground, and 
thermometer style with percent status of 0% out of a range of 100.  When using 
a dialog or form editor, the user can move and resize this control to any 
rectangular size.  Additionally, the user can set the style of the control 
to an indicator type of thermometer or needle, orientation of vertical or 
horizontal, aspect of percent or value, progress of fill-right/down, 
fill-left/up, empty-right/down, or fill-left-up, and toggle the display of the 
current value to display or no display.  After a GrafStat control has been 
created via a dialog or the CreateWindow function, the developer can 
manipulate the control via messages as described bellow.  Please see the 
demonstration application GSDEMO.EXE for a "look-and-feel" of the 
functionality of GrafStat.


MESSAGES...

The following messages allow the developer to manipulate an instance of a 
GrafStat control by sending messages via the SendMessage function.  Each 
message is listed with a description of the word-parameter (wParam).  The long
parameter (lParam) is not used in any of these messages.  See your SDK or 
Windows reference for more information on this or related topics.

GSM_SETSTYLE   		Set the style of the grafstat control, wParam=style.
			The style can include any combination of styles, one
			from each line,

				GSS_THERMOMETER or GSS_NEEDLE
				GSS_HORIZONTAL or GSS_VERTICAL
				GSS_PERCENT or  GSS_VALUE
				GSS_TEXT or GSS_NOTEXT
				GSS_FILL or GSS_EMPTY
				GSS_RIGHTDOWN or GSS_LEFTUP

			See the demonstration source-code and executable for
			examples of these styles and their appearance.

GSM_SETRANGE		Set the range of the grafstat control, wParam=integer-
			range (not int type).

GSM_SETPOSITION		Set the position of the grafstat control,
			wParam=integer-position (not int type).

GSM_DELTAPOSITION	Add to the current position, wParam=integer-delta
			(value to add to current position).

GSM_SETFORGCOLOR	Set the foreground (indicator) color, wParam=CREF
			(rgb value, see your SDK).

GSM_SETBACKCOLOR	Set the background color, wParam=CREF (rgb value).


-------------------------------------------------------------------------------
 (see order.txt for info. on obtaining the grafstat custom control & source)


         ----------------end-of-author's-documentation---------------

                         Software Library Information:

                    This disk copy provided as a service of

                           Public (software) Library

         We are not the authors of this program, nor are we associated
         with the author in any way other than as a distributor of the
         program in accordance with the author's terms of distribution.

         Please direct shareware payments and specific questions about
         this program to the author of the program, whose name appears
         elsewhere in  this documentation. If you have trouble getting
         in touch with the author,  we will do whatever we can to help
         you with your questions. All programs have been tested and do
         run.  To report problems,  please use the form that is in the
         file PROBLEM.DOC on many of our disks or in other written for-
         mat with screen printouts, if possible.  PsL cannot debug pro-
         programs over the telephone, though we can answer questions.

         Disks in the PsL are updated  monthly,  so if you did not get
         this disk directly from the PsL, you should be aware that the
         files in this set may no longer be the current versions. Also,
         if you got this disk from another vendor and are having prob-
         lems,  be aware that  some files may have become corrupted or
         lost by that vendor. Get a current, working disk from PsL.

         For a copy of the latest monthly software library newsletter
         and a list of the 3,000+ disks in the library, call or write

                           Public (software) Library
                               P.O.Box 35705 - F
                            Houston, TX 77235-5705

                                 Orders only:
                                1-800-2424-PSL
                              MC/Visa/AmEx/Discover

                          Outside of U.S. or in Texas
                          or for general information,
                              Call 1-713-524-6394

                          PsL also has an outstanding
                          catalog for the Macintosh.


