home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / edcal.zip / EDCAL.DOC < prev    next >
Text File  |  1995-06-11  |  6KB  |  133 lines
  1.                              EDCal  V1.02
  2.  
  3.                Copyright 1994, Enlighten Development.
  4.  
  5.                          Friday, May 13, 1993
  6.  
  7.                CompuServe: 73650,165 (primary access)
  8.     
  9.                Voice     : (414)/830-0398
  10.  
  11.                To register, send $15 check or money order, payable
  12.                to Tim Fischer, to:
  13.  
  14.                Enlighten Development
  15.                1109 S. Kernan Street
  16.                Appleton, WI  54915
  17.  
  18.                Please add $3 S+H if you wish delivery by Mail.
  19.  
  20. -------------------------------------------------------------------
  21.      EDCal is a Shareware program.  If you find EDCal to be
  22. useful, please send $15 to the above address for the latest Version
  23. and FULL SOURCE CODE.  Feel free to play around with and copy EDCal,
  24. but, if you use it in one of your programs, and you sell that 
  25. program, you must register EDCal.  If you don't, or you modify 
  26. the EDCal DLL or LIB in anyway, you will be in violation of EDCal's
  27. copyright.
  28.  
  29. -------------------------------------------------------------------
  30. EDCal, although Shareware, is a Copyrighted production of Enlighten
  31. Development.  And as such, your use of the REGISTERED software is 
  32. subject to the following Limitations: 
  33.  
  34. -You May:
  35.       Have a non-exclusive, royalty-free right to reproduce and 
  36.       distribute executable files created using this software.
  37.  
  38. -You May Not:
  39.       Distribute the source for this application to anyone not 
  40.       owning a registered version of this software. i.e.  you 
  41.       MAY give an update to a friend who already has registered
  42.       his/her version but hasn't recieved the most recent update 
  43.       yet through the NEXT major release.
  44.  
  45. WARRANTY:
  46.   Enlighten Development DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED
  47.   IN THIS SOFTWARE WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION 
  48.   OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE.  Because of 
  49.   the inherent complexity of computer software you are advised to 
  50.   verify your work.
  51.  
  52. LIMITATIONS OF LIABILITY:
  53.   Enlighten Development's LIABILITY AND YOUR EXCLUSIVE REMEDY ARE AS
  54.   SET FORTH ABOVE AND Enlighten Development DISCLAIMS ALL OTHER 
  55.   WARRANTIES OR CONDITIONS, EXPRESS OR IMPLIED, INCLUDING, BUT NOT 
  56.   LIMITED TO THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABLE
  57.   QUALITY AND FITNESS FOR A PARTICULAR PURPOSE AND THOSE ARISING 
  58.   BY STATUTE OR OTHERWISE IN LAW OR FROM A COURSE OF DEALING OR 
  59.   USAGE OF TRADE.  No modification or addition to this warranty 
  60.   is authorized unless it is set forth in writing, references this
  61.   Agreement and is signed on behalf of Enlighten Development by an
  62.   authorized official.
  63.  
  64.   IN NO EVENT WILL Enlighten Development OR ITS DIRECT OR INDIRECT
  65.   SUPPLIERS BE LIABLE FOR ANY OTHER DAMAGES WHATSOEVER INCLUDING, 
  66.   BUT NOT LIMITED TO, DIRECT, INDERECT, SPECIAL, INCIDENTAL OR  
  67.   CONSEQUENTIAL DAMAGES OR OTHER PECUNIARY LOSS ARISING OUT OF THE
  68.   USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF Enlighten 
  69.   Development HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  70.  
  71.             If you read all that, then congratulations! 
  72.                     You are probably the first.
  73.  
  74.   If you have any questions, comments, ideas, etc, feel free to
  75.   contact me.  I'm always looking for ways to improve my software!
  76.  
  77. ---------------------------------------------------------------
  78. I.   General
  79.  
  80.      EDCal provides a programmer with a simple, straightforward
  81.      way to create and use a graphical Calendar to select Dates
  82.      and display them in multiple formats.  This DLL was written
  83.      using IBM CSet/2++ and the OS/2 Toolkit.  Conversion to other
  84.      Compilers should be quite easy as I have not used any special
  85.      commands limiting the code to a particular compiler.
  86.  
  87. II.  Using EDCal (DLL Version.)
  88.  
  89.      A.   To add EDCal to a program:
  90.  
  91.           In the MAKE file:
  92.           o    and EDCal.LIB to the LINK statement, in addition
  93.                to any other libraries you may be using.
  94.  
  95.  
  96.           In the PROGRAM FILE
  97.  
  98.           o    call the API InitInstanceEDCAL(); in the initialization of
  99.                your program (Or anywhere before your FIRST call to 
  100.                ShowCalendar.
  101.  
  102.           o    In order to display the Calendar, call ShowCalendar with the
  103.                following options:
  104.  
  105.                 ShowCalendar(HWND,ID_EF,"CCYYMMDD");
  106.  
  107.                 where HWND = the handle of the window that is calling the
  108.                 function.
  109.  
  110.                 where ID_EF = the ID of the the Entryfield,Combo Box, or
  111.                 List Box of the item that will display the returned DATE.
  112.  
  113.                 where "CCYYMMDD" = the format of the date you wish to
  114.                 display.  
  115.                   ie.  "MM-DD-YY" will display 01-01-95,
  116.                        "MM-DD-CCYY" will display 01-01-1995,
  117.                        "DD-MMM-YY" will display 01-Jan-95,
  118.                        "DD-MMMMMMMMM-CCYY" will display 01-January-1995.
  119.  
  120.  
  121.                 As is shown, MM = Month, DD = Day, CC = Century, YY = Year.
  122.  
  123.                 ANY format is acceptable as long as those four characters are
  124.                 used for the formatting.
  125.  
  126.           o    When exiting the application, you may wish to call
  127.                TermInstanceEDCAL(); to cleanup the Task and thread used for
  128.                the calendar.
  129.                
  130.      If you have any question on implementing EDCal, please feel free to 
  131.      get in touch with me Via CompuServe at ID 73650,165.
  132.  
  133.