home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_code2 / superbtn / shortdoc.txt < prev    next >
Text File  |  1992-05-16  |  3KB  |  84 lines
  1. Short Documentation (version of apr.26,1992)
  2. -------------------
  3.  
  4. Well most of the properties are self explanatory but some probably need 
  5. additional documentation ( if you buy the control you will receive full 
  6. documentation, but for evaluation this should help you enough to understand 
  7. the SuperButton CC:
  8.  
  9. First of all the Button has currently two states.  
  10.  
  11. SHORT "Value":
  12.  
  13. Value delivers the state of the button.
  14.  
  15. Press the shift key and the right mouse button to toggle state at design time.
  16. This also sets the wakeup state of the button.
  17.  
  18. SHORT "PictureTop, PictureLeft, PictureRight, PictureBottom"
  19.  
  20. These four define a picture rectangle of the picture. You can alway have one
  21. or two pictures for the two states. The button has two planes where the pictures
  22. may appear. Either behind/below the geometric button or on top. "PicturePlane" 
  23. controls where and, if you only have one picture, wheather the picture should
  24. substitute each other or not. Look at the Superbutton Playground to see the 
  25. effect.
  26.  
  27. You can of course alter the picture rectangle values via the property combo
  28. BUT I have created a faster way, which I would like to explain in more
  29. detail next.
  30.  
  31. Press the control key and a click (always with the RIGHT mousebutton) sets the
  32. upper lefthand corner.
  33.  
  34. If you press control and shift you set the lower righthand corner. This is only
  35. important for bitmaps, which are clipped to the resulting rectangle. Icons are
  36. always displayed in full beauty. 
  37.  
  38. Due to the fact that VB does not send any WM_MOUSEMOVE in design mode I was 
  39. unable to implement a typical drag type set option. But this is second best and
  40. you will see, it's easy and versatile. If anyone has an idea how to improve this
  41. option I would welcome your proposals.
  42.  
  43. Events:
  44.  
  45. The CHANGE event is created when ClickEvent=automatic in contrast to 
  46. ClickEvent=manual which only creates CLICK events whenever the button was
  47. clicked without leaving the button rectangle. (Please look at the ? button in 
  48. EXAMPLE.MAK)
  49.  
  50. The CHANGE Event has an additional parameter which informs you, what
  51. activity caused the change. byUserEdit is nonzero when the change is the result
  52. of the user entering something to the specific control. 
  53.  
  54. byUserEdit=1 change results from mouse action
  55. byUserEdit=2 change results from keyboard action
  56.  
  57. These can be: Space=left mouse click
  58. Up or down arrow = toggle state
  59.  
  60. byUserEdit=0 change is result of value assignment statement in VB
  61.  
  62. There's a new Event HELP which is controlled by the Helpevents property. The
  63. Object parameter is always zero and has been added to be consistent with our
  64. FormText Custom Control. The hot area for help is in the center of the button.
  65. In contrary to the help area in the upper right hand corner in FORMTEXT and 
  66. CBOXLIST.
  67.  
  68. Always keep in mind, that you can turn off the BorderStyle and alter the
  69. Colors Background,Foreground,BackgroundON and ForeGroundON.
  70.  
  71. The BaseColor property is necessary because the button can be smaller that the
  72. control rectangle. If Basecolor is zero the underlying parent's backcolor is
  73. used. 
  74.  
  75. I hope this short introduction helps you evaluate our button control.
  76. The final release will also contain a "multistate" sibling, which is currently
  77. in progress. 
  78.  
  79. Enjoy
  80. Manfred Waldmeyer
  81.  
  82.  
  83.  
  84.