home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / PowerPlant / HToggleRadioButton 1.2 / HToggleRadioButton README next >
Encoding:
Text File  |  1997-06-22  |  7.0 KB  |  175 lines  |  [TEXT/CWIE]
  1. /*******************************************************************************\
  2. |                                                                                |
  3. |    HToggleRadioButton ©1996-1997 John C. Daub. All rights reserved.            |
  4. |                                                                                |
  5. |    John C. Daub <mailto:hsoi@eden.com>                                            |
  6. |    <http://www.eden.com/~hsoi/>  <http://www.eden.com/~hsoi/prog.html>            |
  7. |                                                                                |
  8. \*******************************************************************************/
  9.  
  10.  
  11. ----------==========<<<<<<<<<< IMPORTANT NOTE >>>>>>>>>>==========----------
  12.  
  13. This class used to be known as "LToggleRadioButton" (class_ID 'tgbt'). This
  14. was bad form (PowerPlant/Metrowerks reserves all lower case class_ID's and
  15. using "L" as the class name prefix just gets confusing), but there was good
  16. reasoning back when it was written.
  17.  
  18. To clean up any conflicts, the class has been renamed HToggleRadioButton and
  19. given the class_ID of 'Htgb'. If you have any existing code based upon
  20. LToggleRadioButton, you will need to update your PPob's and your code to
  21. use this new convention. I apologize for any inconvenience this necessary
  22. transition may cause.
  23.  
  24. ----------==========<<<<<<<<<< IMPORTANT NOTE >>>>>>>>>>==========----------
  25.  
  26.  
  27. DESCRIPTION
  28. ```````````
  29.  
  30. This class (derived from the PowerPlant™ class, LToggleButton) attempts to
  31. give the LToggleButton class a radio-button-like behavior (i.e. you can
  32. create a radio group that includes objects of this type and only one member
  33. of that group will be "on" at a time).
  34.  
  35. You can have in the same radio group both these HToggleRadioButton's and
  36. LStdRadioButtons (or any other radio button class)...click on a radio,
  37. the toggles will all be off. Click on a toggle, the radios will all be off. 
  38. I don't know what this will do for bad interface guidelines, but just use
  39. good judgment, I guess, in creating a user interface with this.
  40.  
  41. Basic philosophy with this was to, of course, reuse the LToggleButton class's
  42. functionality as much as possible (note there are only a few functions).
  43. Of what there are, I tried to mix the existing functionality that was in the
  44. equivalent LToggleButton method with the functionality that is in the
  45. LStdRadioButton class.
  46.  
  47. Includes a CTYP resource for ease of editing in Constructor 2.4 and higher
  48. (sorry, no CPPb resource is available, but all you need to do is create a
  49. LToggleButton object and change it's class ID to 'Htgb').
  50.  
  51.  
  52. CREDITS
  53. ```````
  54.  
  55. Thanx to the users that desired this functionality in the first place...that's
  56. why I wrote it (to answer the call!).  And also thanx to the people that do
  57. use it and recommend it to others (I've seen you!).  It's good to know stuff
  58. you've done helps others in some way.
  59.  
  60.  
  61. DISCLAIMER
  62. ``````````
  63.  
  64. This is NOT a product of Metrowerks Corporation.  Please do NOT contact Metrowerks
  65. for help/support of this class/code.  If you need support, please use the contact
  66. information given below.
  67.  
  68.  
  69. LICENSING AND USAGE AGREEMENT
  70. `````````````````````````````
  71.  
  72. John C. Daub grants you, and you accept, a nonexclusive, nontransferable license
  73. to distribute this code for you within your programs and projects.  You may
  74. distribute this code in object code form only and only on magnetic diskettes,
  75. CD-ROM, or other media with your programs into which this code has been
  76. incorporated (if you need to distribute your program by some other medium, please
  77. contact the author).  You agree that this license gives you no title nor rights
  78. of ownership in, of, and/or to this code, and acknowledge that this code
  79. is property of John C. Daub.  This code is NOT in the public domain.
  80.  
  81. Permission is granted to the following organizations to distribute this
  82. code on their CD-ROM collections:
  83.  
  84. Pacific HiTech, Inc            - Info-Mac CD-ROM
  85. Celestin Company            - Apprentice CD
  86. Meterowerks Corporation        - CodeWarrior
  87.  
  88. If you and/or your organization wishes to distribute this code and are
  89. not explicitly listed above, please contact John C. Daub.
  90.  
  91. You may modify the source code, compile it, and incorporate the resulting object
  92. code into your programs.  If you modify the code, you cannot redistribute the
  93. modified code under the same class/code name.  Furthermore, to prevent any
  94. problems and/or infringements, please contact the author prior to redistribution
  95. of any modified code.
  96.  
  97. John C. Daub licenses this code to you on an "AS IS" basis.  John C. Daub makes
  98. no warranties, neither expressed nor implied, regarding this code, its
  99. merchantability, nor its fitness for any purpose.  John C. Daub agrees to make a
  100. reasonable effort to provide written or verbal corrections for any problems
  101. that might be found in this code.
  102.  
  103. Use of this code must be credited in an appropriate manner and location (such
  104. as printed or online documentation and/or About boxes) with the following
  105. credit line:
  106.  
  107.      HToggleRadioButton ©1996-1997 John C. Daub.  All rights reserved.
  108.  
  109. If this license is too restrictive with the current law in your state or country,
  110. you should not use this code at all.  Furthermore, if you personally find this
  111. agreement too restrictive or not to your satisfaction, you should not use this
  112. code at all.
  113.  
  114.  
  115. FUTURE
  116. ``````
  117.  
  118. -    I haven't heard of any problems with the class since it's inception, so
  119.     there doesn't seem to be anything to fix.
  120.     
  121. -    The class seems to be pretty stable and functionally complete, so I also
  122.     don't see any needs for additions.
  123.  
  124. -    I'll just be working to ensure that the class continues to function with
  125.     future releases of PowerPlant.
  126.  
  127.  
  128. CONTACT INFORMATION
  129. ```````````````````
  130.  
  131. Even though you don't need to send me email or register or anything to
  132. use the code, it would still be nice to drop me a line and let me know
  133. what you think.  If you find any bugs or add any cool features, send them
  134. to me so I can add it to the official distribution. Furthermore, if I
  135. have your contact information, I can notify you when new versions are
  136. released -- can be very handy if say there is a fatal crashing bug
  137. in the code or some such. So, it's probably in your own best interest
  138. to drop me a line :-)
  139.  
  140. Also, be sure to visit my web site
  141.  
  142. <http://www.eden.com/~hsoi/prog.html>
  143.  
  144. and "register". I won't know if you're "registered" or not, but it's a nice
  145. way that you can be notified of product updates (e.g. I make a new
  146. version, post it on that page, if you're registered, you'll be emailed
  147. automatically that the page changed).
  148.  
  149. John C. Daub
  150. <mailto:hsoi@eden.com>
  151. <http://www.eden.com/~hsoi/prog.html>
  152.  
  153.  
  154. CHANGE HISTORY
  155. ``````````````
  156.  
  157. Date        Vers    Who        Notes
  158. ----------------------------------------------------------------------------
  159. 29 Jul 96    1.0        JCD        - Created file
  160.  
  161. 20 Jan 97    1.1        JCD        - Cleaned the code up some
  162.                             - Cleaned the cosmetics of the files up
  163.                             - Redid the distribution package (created this README,
  164.                                 restructured the folder layout, clarified the
  165.                                 copyright information, etc.)
  166.                             - Created CTYP
  167.  
  168. 22 Jun 97    1.2        JCD        - Renamed to HToggleRadioButton and new class_ID from
  169.                             'tgbt' to 'Htgb'
  170.                             - Updated sources, CTYP, and demo to match new names.
  171.                             - CreateToggleRadioButtonStream renamed to the simpler
  172.                             CreateFromStream.
  173.                             - Created copy ctor and assignment operator (private)
  174.                             - Cleaned up source cosmetics to improve readability
  175.                             - Upgraded to CW Pro1.