C:/usr/local/lib/php/blueshoes-4.2/core/html/form/Bs_FormFieldSelect.class.phpandrej arnexample tag:<select name="fieldname" size="5" multiple><option value="1" SELECTED>one</option><option value="2" SELECTED>two</option><option value="3">three</option></select>what's special about this tag?alot is different to a text field for example.- value => the real value can be different from the visible value.- value => multiple values can be selected.- size => how large the select field should be displayed. needs to be >1 for multiple.- multiple => if more then one value can be selected. size needs to be set and >1.- events => does not support the usual 14 events, only 'onBlur', 'onFocus' and 'onChange'(2001/05/01)- all the following object vars are of no use and thus ignored (mainly because the usercannot change the values at all, he can only select them):- bsDataType - mustContain- bsDataInfo - notContain- minLength - mustBeUnique- [maxLength] - regularExpression- mustStartWith - trim- notStartWith - remove- mustEndWith - replace- notEndWith - case- optionsthe options that are selectable for the user.- valueDefaultthe following data structores are allowed:array('1'=>'one', '2'=>'two', '3'=>'three');array('en'=>array('1'=>'one','2'=>'two','3'=>'three'), 'de'=>array('1'=>'eins','2'=>'zwei','3'=>'drei'), 'fr'=>array('1'=>'un','2'=>'deux','3'=>'trois'));while these are not:'one';array('one', 'two', 'three');array('en'=>'one', 'de'=>'eins', 'fr'=>'un');array('en'=>array('one','two','three'), 'de'=>array('eins','zwei','drei'), 'fr'=>array('un','deux','trois'));because it would not be possible to know the difference sometimes.this means: even if you have only one default value, it must be an array. and you alwaysneed key=>val, even if the key and the value is the same.no dependencies here.SELECT Form Field Class4.0.$id$blueshoes.orgConstructor.default is TRUE. adds the enforce checkbox automatically, if needed. see (parent::)addEnforceCheckbox().some html codeoverwrites parent method.Returns some html code to display the field on a website in a form.returns a string with the option tags to send to the client.big note: this method is (and should be) identical in Bs_FormFieldRadio and Bs_FormFieldSelect.prepares the options to select from for this field.(string or so)(...)example:you have <option value="ca">Canada</option>getOptionStringForValue('ca') returns 'Canada'.big note: this method is (and should be) identical in Bs_FormFieldRadio and Bs_FormFieldSelect.returns the displayed value for an internal value.i think, maybe an array is possible too.)outsourced this from _getOptionsString().returns the default value somehow. depends on form->step.overwrite parent method cause we don't want to manipulate anything here.(only used internally!!!)overwrites parent method. read manual there. additional information:the order for data validation is: (-- means check omitted here)1) must 5) --mustStartWith 9) --mustContain 13) --mustBeUnique2a) onlyOneOf 6) --notStartWith 10) --notContain 14) --regularExpression2b) onlyIf3) minLength 7) --mustEndWith 11) --equalTo4) maxLength 8) --notEndWith 12) --notEqualTovalidate the user inputs according to the object vars.$minLength(the value the user submitted, should be a string here) (bool)TRUE if ok, (string)error message if not.overwrites parent method. for a select field the minLength has another meaning.it's the number of min. selectable elements. if it doesn't have the 'multiple'property the setting is ignored.checks the minLength case.$maxLength(the value the user submitted, should be a string here)the length of $v. this way we don't have to do strlen() again. (bool)TRUE if ok, (string)error message if not.overwrites parent method. for a select field the maxLength has another meaning.it's the number of max. selectable elements. if it doesn't have the 'multiple'property the setting is ignored.checks the maxLength case.$optionsType$optionsHard$optionsEval$_options(default is FALSE. it's really hard to debug something with this set to true. you won't see anything.)sets $this->_options based on the vars $optionsHard and $optionsEval.if not set it won't be written to the client, which equals to a value of '1'.how large the select field should be displayed. needs to be >1 for multiple.$size needs to be >1 then. if not set it's FALSE.if the user is able to select multiple values, not just one._prepareOptions()$optionsHard$optionsEval$_optionsone of 'eval' or 'hard'.if not set, the one var that is used is used :) if both are used(speaking of $optionsHard and $optionsEval) then $optionsHard isthe default.how to fill in the option tags for this select field._prepareOptions()$optionsType$optionsHard$optionsEvalmade up in _prepareOptions() using $optionsHard and $optionsEval._prepareOptions()$optionsType$optionsEval$_optionsthe following data structures are allowed:array('1'=>'one', '2'=>'two', '4'=>'four');array('en'=>array('1'=>'one','2'=>'two','3'=>'three'), 'de'=>array('1'=>'eins','2'=>'zwei','3'=>'drei'), 'fr'=>array('1'=>'un','2'=>'deux','3'=>'trois'));while these are not:'one';array('one', 'two', 'three');array('en'=>'one', 'de'=>'eins', 'fr'=>'un');array('en'=>array('one','two','three'), 'de'=>array('eins','zwei','drei'), 'fr'=>array('un','deux','trois'));because it would not be possible to know the difference sometimes.this means: even if you have only one default value, it must be an array. and you alwaysneed key=>val, even if the key and the value is the same.the options that are selectable for the user._prepareOptions()$optionsType$optionsHard$_optionsthat will be used for the option tags of this select field.the code is executed in $this->_prepareOptions() so it's in thescope of a method of this object. this means you can use varsfrom here etc.language dependant. ya know what i mean.php code to be evaluated. has to return an array (hash or vector)a value shorter than $minLength is not accepted while an empty value is.note I: for the field types 'checkbox' and 'radio' this setting is ignored.because the user cannot do anything about it. it's up to the webmasternot to do shit.note II: for the field type 'select' it's the number of min. selectable elements.if it doesn't have the 'multiple' property the setting is ignored.the min length the field value needs to be. if it's not a $must field,$thisif the form tag supports it, it will be directly added like this:<input maxlength=$maxLength>it will be checked serverside anyway. someone could hack it.if not set, it'll be something that makes sense based on $bsDataType:number => 20 username => 20 domain => 80 datetime => 19text => 500 password => 20 host => 80 timestamp => 8blob => 65535 zipcode => 10 date => 10html => 65535 price => 20 time => 8email => 80 creditcard => 16 month => 2url => 200 ip => 15 year => 4there's room for more logic: if the value is made up based on $bsDataType (list above)and $dbDataType is set, the value should be no bigger than the db field types max length,eg char/varchar=255, int=11, blob=65535, ...note I: for the field types 'checkbox' and 'radio' this setting is ignored.because the user cannot do anything about it. it's up to the webmasternot to do shit.note II: for the field type 'select' it's the number of max. selectable elements.if it doesn't have the 'multiple' property the setting is ignored.the max length the field value can be.4.0.$x$bs_formfield&getelementgetfieldaddenforcecheckboxisexplodablegetadvancedstylegetadvancedstylehelpersetexplodegetlabelvalidatemustvalidateonlyoneofvalidateonlyifvalidatemuststartwithvalidatenotstartwithvalidatemustendwithvalidatenotendwithvalidatemustcontainvalidatenotcontainvalidateequaltovalidatenotequaltovalidatedatatypevalidateregularexpressionvalidateadditionalcheckvalidatemustbeuniquegetvisibilitygetonenterbehaviorgetonentercodeapplyonenterbehaviorshouldpersistgetdbdatatypegetdbfieldname_getmaxlength_gettagstringeventsgetvalue_gettagstringvalue_gettagstringstyles_gettagstringadditionaltagsgetcaptiongetcaptionforformoutputgeterrorgethelp_highlightaccesskey_getaccesskeygetfieldashidden_getfieldnameforhtmlhasjavascriptismust_anyifcase_markasused_getbsdatainfonumberisfilledin_evalwrapunpersisttriggergeterrormessage&serializeunserialize&encrypt&decryptinitfrompostbs_formelementhasformobjectsetformobjectgetcaptiongetelementgetlevel_doelementstringformat_getparamvaluegetlanguagedependentvalueisexisexceptiontostringtohtmlpersistunpersistbs_objectbbsetoutputbbawakebbisawakebbxmsgbbxfunctionstartbbxfunctionendbbxechobbxvarbbxvardumpbbforcetracebbbufferstartbbbuffergetbbbufferendflushbbbufferendclean$_bs_string$_bs_array$_bs_htmlutil$_bs_date$fieldtype$caption$defaulterrormessage$errormessage$errortype$level$editability$accessrights$visibility$isused$valuedefault$valuedefaulttype$valuereceived$valuedisplay$valueinternal$savetodb$dbfieldname$dbdatatype$dbnotnull$dbprimarykey$dbkey$dbindexfulltext$dbautoincrement$dbunique$dbforeignkey$dbattributes$explodeeval$_explodearray$direction$styles$advancedstyles$events$onenter$additionaltags$bsdatatype$bsdatainfo$bsdatamanipulation$bsdatamanipvar$enforce$_must$must$mustif$mustoneof$mustoneofif$onlyoneof$onlyif$onlyoneofif$muststartwith$notstartwith$mustendwith$notendwith$mustcontain$notcontain$equalto$notequalto$mustbeunique$regularexpression$additionalcheck$trim$remove$removei$replace$replacei$case$codepostreceive$codepostload$this$charsrule$persister$persisterid$_form$name$elementtype$formid$container$orderid$elementstringformat$persistervarsettings$thisbs_formfield_versionbs_ff_errorbs_formelement_versionbs_object_versionBs_FormFieldBs_FormElementBs_ObjectBs_ObjectBs_FormFieldSelectImageBs_DaFormFieldComboBoxBs_FormFieldChVisaBs_FormFieldCountryList