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