/**
* FormHandler::checkBox()
*
* Create a checkBox on the form
*
* @param string $title: The title of the field
* @param string $name: The name of the field
* @param array|string $value: The option(s) used for the field
* @param string $validator: The validator which should be used to validate the value of the field
* @param boolean $useArrayKeyAsValue: If the array key's are the values for the options in the field
* @param string $extra: CSS, Javascript or other which are inserted into the HTML tag
* @param string $mask: if more the 1 options are given, glue the fields together with this mask
* @return void
* @access public
* @author Teye Heimans
*/
function checkBox($title, $name, $value = 'on', $validator = null, $useArrayKeyAsValue = null, $extra = null, $mask = null)
{
require_once FH_INCLUDE_DIR . 'fields/class.CheckBox.php';
// create a new checkbox
$fld = new CheckBox($this, $name, $value);
if (!empty($validator)) {
$fld->setValidator($validator);
}
if (!is_null($useArrayKeyAsValue)) {
$fld->useArrayKeyAsValue($useArrayKeyAsValue);
}
if (!empty($extra)) {
$fld->setExtra($extra);
}
if (!empty($mask)) {
$fld->setMask($mask);
}
// register the field
$this->_registerField($name, $fld, $title);
}
