<?xml version="1.0"?><phpdoc><class name="form_element_combo" extends="form_element_selectobject" undoc="false" access="private" package="Form"><file>c:/www/apache/doc2//form/form_element_combo.inc</file><doc><author email="uw@netuse.de">Ulf Wendel</author><inherited src="Array"/><overriden src="Array"/><description/><shortdescription>Generates a new metatype combo box</shortdescription><version>$Id: form_element_combo.inc,v 1.5 2000/12/12 01:37:36 uw Exp $</version></doc><function name="validateTextInputEntry" undoc="false" access="private"><doc><see type="function">getNewComboOption()</see><see type="function">validate()</see><return name="$error" type="boolean">array [0] = $ok, $error[1] = $messages</return><description/><shortdescription>Validates the value of the text input field ( = new combo option )</shortdescription></doc></function><function name="getNewComboOption" undoc="false" access="private"><doc><see type="function">validateTextInputEntry()</see><return name="" type="string">If there&amp;apos;s no valid entry an empty string is returned.</return><description/><shortdescription>Returns the new combo option entry.</shortdescription></doc></function><function name="addOption" undoc="false" access="public"><doc><see type="function">getNewComboOption()</see><parameter name="$label" type="string"/><parameter name="$value" default="&amp;quot;&amp;quot;" type="mixed"/><return name="" type="boolean"/><throws>form_error</throws><description>Combo boxes are a little complicated. You have to do thesession handling of new options in your scripts. Usethis function to add a new option to the option list.See the examples for further instructions.</description><shortdescription>Adds a new option to the option list.</shortdescription></doc></function><function name="sortOptions" undoc="false" access="private"><doc><return type="void"/><description/><shortdescription>Sorts the option list if sort is not equal &amp;quot;top&amp;quot; and cares on sort_icase.</shortdescription></doc></function><function name="sortOptionList" undoc="false" access="private"><doc><parameter name="$options" type="array"/><return name="" type="array"/><description/><shortdescription>Sorts an array.</shortdescription></doc></function><function name="get" undoc="true" access="private"><doc><see type="function">getfrozen()</see><see type="function">show()</see><parameter name="$value" default="&amp;quot;&amp;quot;" type="string">The value is only used with radio buttons.&#x0a;If the given value is equal to the value of the&#x0a;element when it was defined, the radio gets selected.</parameter><return type="void"/><overriden src="form_element"/><description/><shortdescription>Returns the HTML code of the element.</shortdescription></doc></function><function name="validate" undoc="true" access="private"><doc><see type="function">validateLength()</see><see type="function">validateRegEx()</see><see type="function">doValidation()</see><return type="void"/><overriden src="form_element"/><description/><shortdescription>Returns the result of the (serverside) validation.</shortdescription></doc></function><variable name="$inputsize" access="private" type="integer">-1<doc><description/><shortdescription>HTML size attribute of the text input field.</shortdescription></doc></variable><variable name="$minlength" access="private" type="integer"><doc><see type="var">$maxlength</see><see type="var">$length_e</see><description/><shortdescription>Minimal length of the text input field value ( = new combo option ).</shortdescription></doc></variable><variable name="$maxlength" access="private" type="integer">-1<doc><see type="var">$minlength</see><see type="var">$length_e</see><description>The attribute is not only use as HTML attribute but also by validate().</description><shortdescription>HTML maxlength attribute of the text input field ( = new combo option ).</shortdescription></doc></variable><variable name="$length_e" access="private" type="string">&amp;quot;&amp;quot;<doc><see type="var">$minlength</see><see type="var">$maxlength</see><description>This error message will appear when the value of thetext input field is out of the range defined by minlength undmaxlength.</description><shortdescription>Error message if the length of the text input field ( = new combo option ) is incorrect.</shortdescription></doc></variable><variable name="$valid_regex" access="private" type="string">&amp;quot;&amp;quot;<doc><see type="var">$valid_icase</see><see type="var">$valid_e</see><description/><shortdescription>RegExp used to validate the text input field ( = new combo option ).</shortdescription></doc></variable><variable name="$valid_icase" access="private" type="boolean">false<doc><see type="var">$valid_regex</see><see type="var">$valid_e</see><description/><shortdescription>Case insensitive validation?</shortdescription></doc></variable><variable name="$valid_e" access="private" type="string">&amp;quot;&amp;quot;<doc><see type="var">$valid_regex</see><see type="var">$valid_icase</see><description>Note that you have to set $valid_regex if you want some validation...</description><shortdescription>Error message of RegExp errors.</shortdescription></doc></variable><variable name="$readonly" access="private" type="boolean">false<doc><description>Doesn&amp;apos;t really make sense - will probably disappear.</description><shortdescription>HTML readonly attribute of the text input field.</shortdescription></doc></variable><variable name="$sort" access="private" type="string">&amp;quot;top&amp;quot;<doc><see type="var">$sort_icase</see><description>You can choose where new options will appear in theselect box. By default they will appear at the topbut you can choose to sort them in alphabetical orderor reverse alphabetical order eighter.</description><shortdescription>Where will new options appear in the select box?</shortdescription></doc></variable><variable name="$sort_icase" access="private" type="boolean">true<doc><see type="var">$sort</see><description/><shortdescription>Sort case insensitive?</shortdescription></doc></variable><variable name="$optional_fields" access="private" type="array">array (&#x0a;																	&amp;quot;size&amp;quot;						=&amp;gt; &amp;quot;integer&amp;quot;,&#x0a;																	&amp;quot;intro&amp;quot;						=&amp;gt; &amp;quot;mixed&amp;quot;,&#x0a;																	&amp;quot;intro_e&amp;quot;					=&amp;gt; &amp;quot;string&amp;quot;,&#x0a;																	&amp;quot;seperators&amp;quot;			=&amp;gt; &amp;quot;array&amp;quot;,&#x0a;																	&amp;quot;seperators_e&amp;quot;		=&amp;gt; &amp;quot;string&amp;quot;,&#x0a;																	&amp;quot;accesskey&amp;quot;				=&amp;gt; &amp;quot;string&amp;quot;,&#x0a;																	&amp;quot;tabindex&amp;quot;				=&amp;gt; &amp;quot;integer&amp;quot;,&#x0a;																	&#x0a;																	&amp;quot;inputsize&amp;quot;				=&amp;gt; &amp;quot;integer&amp;quot;,&#x0a;																	&#x0a;																	&amp;quot;minlength&amp;quot;				=&amp;gt; &amp;quot;integer&amp;quot;,&#x0a;																	&amp;quot;maxlength&amp;quot;				=&amp;gt; &amp;quot;integer&amp;quot;,&#x0a;																	&amp;quot;length_e&amp;quot;				=&amp;gt; &amp;quot;string&amp;quot;,&#x0a;																	&#x0a;																	&amp;quot;valid_regex&amp;quot;			=&amp;gt; &amp;quot;string&amp;quot;,&#x0a;																	&amp;quot;valid_icase&amp;quot;			=&amp;gt; &amp;quot;boolean&amp;quot;,&#x0a;																	&amp;quot;valid_e&amp;quot;					=&amp;gt; &amp;quot;string&amp;quot;,&#x0a;																	&#x0a;																	&amp;quot;readonly&amp;quot;				=&amp;gt; &amp;quot;boolean&amp;quot;,&#x0a;																	&amp;quot;sort&amp;quot;						=&amp;gt; &amp;quot;string&amp;quot;&#x0a;																)<doc><see type="var">$shared_optional_fields</see><see type="var">$required_fields</see><overriden src="form_element"/><description/><shortdescription>List of optional fields provided by a derived class.</shortdescription></doc></variable><inherited src="form_element_selectobject" type="functions"><element>setoptions</element><element>isselected</element><element>setvalue</element><element>validateintro</element><element>getintrooptiontags</element><element>getoptiontags</element><element>getfrozen</element></inherited><inherited src="form_element" type="functions"><element>form_element</element><element>setup</element><element>checkconfiguration</element><element>getvalue</element><element>gettype</element><element>isbutton</element><element>getvalidator</element><element>setvalidator</element><element>freeze</element><element>unfreeze</element><element>thawout</element><element>getfrozen</element><element>show</element><element>validatelength</element><element>validateregex</element><element>dovalidation</element><element>react</element><element>setvalue</element><element>getjsonactivation</element><element>getcommonhtmlattributes</element><element>getfrozenhiddenelement</element><element>getfrozentable</element><element>getjs</element><element>getjsvalue</element><element>getextrajs</element><element>getname</element><element>ishidden</element></inherited><inherited src="form_commonobject" type="functions"><element>introspection</element></inherited><inherited src="form_element_selectobject" type="variables"><element>$size</element><element>$intro</element><element>$intro_e</element><element>$seperators</element><element>$seperators_e</element><element>$options</element><element>$accesskey</element><element>$tabindex</element><element>$required_fields</element></inherited><inherited src="form_element" type="variables"><element>$flag_config_ok</element><element>$elname</element><element>$name</element><element>$value</element><element>$additional_html</element><element>$frozen</element><element>$class</element><element>$id</element><element>$style</element><element>$shared_required_fields</element><element>$required_fields</element><element>$shared_optional_fields</element><element>$method</element><element>$val_events</element><element>$js_mode</element><element>$form_name</element><element>$validator</element><element>$js_validator</element></inherited><inherited src="form_commonobject" type="variables"><element>$cr_html</element><element>$exceptions</element></inherited><path><parent>form_element_selectobject</parent><parent>form_element</parent><parent>form_commonobject</parent></path><baseclass>form_commonobject</baseclass></class></phpdoc>