home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_code1 / cb_list / shortdoc.txt < prev    next >
Text File  |  1992-04-19  |  4KB  |  93 lines
  1. Short Documentation (revised version of apr.19,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 CboxList CC:
  8.  
  9. First of all the List may contain up to 10 options. 
  10. The dialogbox in the newest version now disables the Add and Insert button 
  11. when the list is full.
  12.  
  13. SHORT "Value":
  14.  
  15. The control can act either as a single or multipleselect group of checkboxes,
  16. which can be defined by the MultipleSelect property. Depending on this property
  17. the property "Value" has different meanings. In singleselect mode "Value" 
  18. returns the index of the option set. In multipleselect mode "Value" reports
  19. how many options in total are selected. To retrieve the individual options
  20. there are two property arrays:
  21.  
  22. HSZ ValueList(Index): 
  23.  
  24. The text of the option (index) (index=0 to MaxValueIndex).
  25. You can set the ValueList strings in a dialog box. But you can also assign a
  26. string at run time.
  27.  
  28. BOOL ValueState(Index):  
  29.  
  30. the state of the option (index). To set a default state click on the option 
  31. in design mode with the RIGHT mousebutton. Therefore you need not initialise 
  32. the control at Form_Load time if the value is not different from that default.
  33.  
  34. Both are read/write properties. See Treats.frm for some details how to address
  35. these properties.
  36.  
  37. SHORT "MaxValueIndex":
  38.  
  39. reports how many options the control contains. Currently the maximum is
  40. 10 options.
  41.  
  42. SHORT "PictureTop, PictureLeft, PictureRight, PictureBottom"
  43.  
  44. These four define a picture rectangle of the FIRST picture right below the
  45. caption and also controls the placement of the value strings.
  46.  
  47. You can of course alter these values via the property combo BUT I have created
  48. a faster way, which I would like to explain in more detail next.
  49.  
  50. First you double click with the RIGHT mousebutton.
  51.  
  52. A grid of four lines is displayed. Now you are in "Picture Rectangle Mode"
  53.  
  54. Press the control key and a click (always with the RIGHT mousebutton) sets the
  55. upper lefthand corner.
  56. If you press control and shift you set the lower righthand corner. Due to the
  57. fact that VB does not send any WM_MOUSEMOVE in design mode I was unable to im-
  58. plement a typical drag type set option. But this is second best and you will
  59. see, it's easy and versatile. If anyone has an idea how to improve this option
  60. I would welcome your proposals.
  61.  
  62. Events:
  63.  
  64. The CHANGE Event has two additional parameter which informs you, what
  65. activity caused the change. byUserEdit is nonzero when the change is the result
  66. of the user entering something to the specific control. 
  67.  
  68. byUserEdit=1 change results from mouse action
  69. byUserEdit=2 change results from keyboard action
  70.  
  71. byUserEdit=0 change is result of value assignment statement in VB
  72.  
  73. ValueIndex gives you the index of the option in the list that was altered.
  74.  
  75. There's a new Event HELP which is controlled by the Helpevents property. The
  76. Object parameter is always zero and has been added to be consistent with our
  77. FormText Custom Control.
  78.  
  79. Take a look at FRAMES.FRM for details.
  80.  
  81. The colors for the 3D light and shadow are fixed. If you think they should
  82. be modifiable, please let me know !
  83.  
  84. Always keep in mind, that you can turn off the BorderStyle and alter the
  85. Colors Background,Foreground,BackgroundON and ForeGroundON.
  86.  
  87. Enjoy
  88.  
  89. Manfred Waldmeyer
  90.  
  91.  
  92.  
  93.