org.apache.turbine.util.template

## Class SelectorBox

- java.lang.Object
- - org.apache.turbine.util.template.SelectorBox

-     public class SelectorBox
      extends Object

  This class is for generating a SelectorBox. It is good when used with WM because you can stuff it into the context and then just call it to generate the HTML. It can be used in other cases as well, but WM is the best case for it right now.

  For example code showing the usage for this module, please see the toString() method below to see how it would be refered to from WM.

       // get the roles for a user
       RoleSet userRoles = new DefaultAccessControl().getRoles(loginid, null);
       if ( userRoles != null )
       {
           context.put("hasRoleSet", Boolean.TRUE);

           // get an array of the users roles
           Role[] usersRoles = userRoles.getRolesArray();
           // get an array of all the roles in the system
           Role[] allRoles = ((RoleSet)RolePeer.retrieveSet()).getRolesArray();

           Object[] names = new Object[allRoles.length];
           Object[] values = new Object[allRoles.length];
           for ( int i=0;i<allRoles.length; i++ )
           {
               names[i] = Integer.valueOf(allRoles[i].getPrimaryKey()).toString();
               values[i] = allRoles[i].getName();
           }

           SelectorBox sb = new SelectorBox("roleSetBox", names, values);
           sb.buildBooleans(usersRoles, allRoles);
           context.put("roleSetBox", sb);
       }
       else
       {
           context.put("hasRoleSet", Boolean.FALSE);
       }

  Version:
    $Id: SelectorBox.java 1706239 2015-10-01 13:18:35Z tv $
  Author:
    Jon S. Stevens

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `SelectorBox(String name, Object[] names, Object[] values)` Generic constructor, builds a select box with a default size of 1 and no selected items.
    `SelectorBox(String name, Object[] names, Object[] values, boolean[] selected)` Generic constructor builds a select box.
    `SelectorBox(String name, Object[] names, Object[] values, int size)` Generic constructor builds a select box.
    `SelectorBox(String name, Object[] names, Object[] values, int size, boolean[] selected)` Primary constructor for everything.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `buildBooleans(Object[] selectedSet, Object[] entireSet)` Pass in an array of selected items and the entire set of items and it will determine which items in the selected set are also in the entireset and then build a boolean[] up that is the same size as the entireSet with markings to tell whether or not the items are marked or not.
    `void` | `reset()` Resets the internal state of the SelectorBox.
    `SelectorBox` | `setMultiple(boolean val)` This allows you to set the multiple attribute to the select element.
    `SelectorBox` | `setName(String name)` This allows one to set the name= attribute to the select element.
    `SelectorBox` | `setOnChange(String script)` This allows one to set an onChange attribute on the select tag
    `SelectorBox` | `setSelected(boolean[] bools)` This allows one to set the array of selected booleans.
    `SelectorBox` | `setSelected(Object name)` This will set all elements as unselected, except for the element(s) with the given name.
    `SelectorBox` | `setSize(int size)` This allows one to set the size of the select element.
    `String` | `toString()` This builds out the select box at a certain size.
    `String` | `toString(int size)` This builds out the select box at a certain size.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Constructor Detail

    - #### SelectorBox

          public SelectorBox(String name,
                     Object[] names,
                     Object[] values)

      Generic constructor, builds a select box with a default size of 1 and no selected items.
      Parameters:
        `name` - A String with the name for the select box.
        `names` - An Object[] with the names.
        `values` - An Object[] with the values.

    - #### SelectorBox

          public SelectorBox(String name,
                     Object[] names,
                     Object[] values,
                     int size)

      Generic constructor builds a select box.
      Parameters:
        `name` - A String with the name for the select box.
        `names` - An Object[] with the names.
        `values` - An Object[] with the values.
        `size` - An int specifying the size.

    - #### SelectorBox

          public SelectorBox(String name,
                     Object[] names,
                     Object[] values,
                     boolean[] selected)

      Generic constructor builds a select box.
      Parameters:
        `name` - A String with the name for the select box.
        `names` - An Object[] with the names.
        `values` - An Object[] with the values.
        `selected` - A boolean[] with the selected items.

    - #### SelectorBox

          public SelectorBox(String name,
                     Object[] names,
                     Object[] values,
                     int size,
                     boolean[] selected)

      Primary constructor for everything.
      Parameters:
        `name` - A String with the name for the select box.
        `names` - An Object[] with the names.
        `values` - An Object[] with the values.
        `size` - An int specifying the size.
        `selected` - A boolean[] with the selected items.

  - ### Method Detail

    - #### buildBooleans

          public void buildBooleans(Object[] selectedSet,
                           Object[] entireSet)

      Pass in an array of selected items and the entire set of items and it will determine which items in the selected set are also in the entireset and then build a boolean[] up that is the same size as the entireSet with markings to tell whether or not the items are marked or not. It uses toString().equalsIgnoreCase() on the Object in the Object[] to determine if the items are equal.
      Parameters:
        `selectedSet` - An Object[].
        `entireSet` - An Object[].

    - #### toString

          public String toString(int size)

      This builds out the select box at a certain size. To use this element in WM, you simply build this object in your java code, put it into the context and then call $selectBox.toString(5).
      Parameters:
        `size` - An int with the size.
      Returns:
        A String with the HTML code.

    - #### reset

          public void reset()

      Resets the internal state of the SelectorBox.

    - #### toString

          public String toString()

      This builds out the select box at a certain size. To use this element in WM, you simply build this object in your java code, put it into the context and then call $selectBox and it will build it with the default size of 1.
      Overrides:
        `toString` in class `Object`
      Returns:
        A String with the HTML code.

    - #### setMultiple

          public SelectorBox setMultiple(boolean val)

      This allows you to set the multiple attribute to the select element. Example usage from within WM is like this:

      $selectBox.setMultiple(true).toString(4)

      Parameters:
        `val` - True if multiple selection should be allowed.
      Returns:
        A SelectorBox (self).

    - #### setName

          public SelectorBox setName(String name)

      This allows one to set the name= attribute to the select element.
      Parameters:
        `name` - A String with the name.
      Returns:
        A SelectorBox (self).

    - #### setSize

          public SelectorBox setSize(int size)

      This allows one to set the size of the select element.
      Parameters:
        `size` - An int with the size.
      Returns:
        A SelectorBox (self).

    - #### setOnChange

          public SelectorBox setOnChange(String script)

      This allows one to set an onChange attribute on the select tag
      Parameters:
        `script` - A string with the script to put in onChange
      Returns:
        A SelectorBox (self).

    - #### setSelected

          public SelectorBox setSelected(boolean[] bools)

      This allows one to set the array of selected booleans.
      Parameters:
        `bools` - an array of booleans
      Returns:
        A SelectorBox (self).

    - #### setSelected

          public SelectorBox setSelected(Object name)

      This will set all elements as unselected, except for the element(s) with the given name.
      Parameters:
        `name` - The name to appear as selected.
      Returns:
        A SelectorBox (self).

Copyright © 2000-2015 The Apache Software Foundation. All Rights Reserved.