home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / webobjects / resources / COCheckBoxMatrix.README < prev    next >
Encoding:
Text File  |  1996-08-23  |  2.1 KB  |  56 lines
  1.  
  2. componentName = COCheckBoxMatrix
  3.  
  4. author = "Charles Lloyd, modified by Joey Coyle";
  5. email = clloyd@next.com; jcoyle@darkstar.co.ihc.com
  6.  
  7.     
  8.  
  9. The COCheckBoxMatrix is a modification of CheckBoxMatrix which really allows a matrix of CheckBoxs unlike the original which only allowed a row.  Instead of isVertical, this has been replaced with numberColumns. A table of checkboxes will be built with that number of columns.
  10.  
  11. In order to distinguish the WOCheckBoxes used in this component from those in any other component, you must pass a name 'matrixName'.  In addition, you must pass an array of strings 'list' that will serve as the labels and the values of the check boxes.  Finally, you must indicate which items 'selections' are selected
  12.  
  13.  
  14. PARAMETERS FOR .WOD
  15. ########################################################################
  16. list ################
  17. An array of strings that will become the labels as well as the return value
  18.  
  19. selections ######################
  20. Indicates which buttons are initially selected. Upon return, indicates the user's choice, or nil if nothing is chosen.
  21.  
  22. matrixName ################
  23. Used to distinguish the WOCheckBoxes used in this COCheckBoxMatrix from those in any other COCheckBoxMatrix
  24.  
  25. numberColumns ##################
  26. The number of columns in the matrix.  Default is 1.
  27.  
  28. borderSize #######################
  29. The width of the border of the matrix.  Default is 2.
  30.  
  31. cellPadding #######################
  32. The margin around each cell in the matrix. Default is 2
  33.  
  34. cellSpacing ########################
  35. The space between the cells in the matrix. Default is 2
  36.  
  37.  
  38.  
  39.  
  40. DIRECTIONS
  41. ######################################################################
  42. In the parent component you must declare the list(in example below called arrayList) and the selections(in example called selectedItems).  You must allocate a mutable array for selections.
  43.  
  44.  
  45.  
  46. Example of parent .wos file
  47.  
  48. id arrayList; // defined as list in .wod
  49. id selectedItems; // defined as selections in .wod
  50.  
  51. - awake
  52. {
  53.     arrayList=@("Joey","Bill","John","NeXT","Lenni","Cat","Whatever");
  54.     selectedItems =[[NSMutableArray new] autorelease];
  55. }
  56.