Source Code Cross Referenced for ItsNatHTMLSelect.java in  » Ajax » ItsNat » org » itsnat » comp » html » Java Source Code / Java DocumentationJava Source Code and Java Documentation

01:        /*
02:          ItsNat Java Web Application Framework
03:          Copyright (C) 2007 Innowhere Software Services S.L., Spanish Company
04:          Author: Jose Maria Arranz Santamaria
05:
06:          This program is free software: you can redistribute it and/or modify
07:          it under the terms of the GNU Affero General Public License as published by
08:          the Free Software Foundation, either version 3 of the License, or
09:          (at your option) any later version. See the GNU Affero General Public 
10:          License for more details. See the copy of the GNU Affero General Public License
11:          included in this program. If not, see <http://www.gnu.org/licenses/>.
12:         */
13:
14:        package org.itsnat.comp.html;
15:
16:        import org.itsnat.comp.ItsNatList;
17:        import org.itsnat.comp.html.ui.ItsNatHTMLSelectUI;
18:        import org.w3c.dom.html.HTMLSelectElement;
19:
20:        /**
21:         * Is the base interface of list components attached to HTML &lt;select&gt; elements.
22:         *
23:         * <p>HTML select based components can be combo boxes and multiple selection lists</p>
24:         *
25:         * <p>The HTML select element may be empty initially, no pattern is needed (because only 
26:         * &lt;option&gt; elements are allowed, current implementations do not support &lt;optgroup&gt;).</p>
27:         * 
28:         * <p>HTML &lt;select&gt; based components have no in place editor, because &lt;option&gt; elements
29:         * only support text nodes.</p>
30:         *
31:         * @author Jose Maria Arranz Santamaria
32:         */
33:        public interface ItsNatHTMLSelect extends ItsNatHTMLFormComponent,
34:                ItsNatList {
35:            /**
36:             * Returns the user interface manager of this component.
37:             *
38:             * @return the user interface manager.
39:             */
40:            public ItsNatHTMLSelectUI getItsNatHTMLSelectUI();
41:
42:            /**
43:             * Returns the associated DOM element to this component.
44:             *
45:             * @return the associated DOM element.
46:             */
47:            public HTMLSelectElement getHTMLSelectElement();
48:
49:            /**
50:             *  Removes focus from this element.
51:             *
52:             * <p>This method is a full replacement of the original 
53:             * <code>org.w3c.dom.html.HTMLAnchorElement.blur()</code> method in Xerces
54:             * (a dummy method). It sends the appropriated JavaScript to the client to call again 
55:             * using the symmetric DOM element at the client.</p>  
56:             */
57:            public void blur();
58:
59:            /**
60:             *  Gives focus to this element.
61:             *
62:             * <p>This method is a full replacement of the original 
63:             * <code>org.w3c.dom.html.HTMLAnchorElement.focus()</code> method in Xerces
64:             * (a dummy method). It sends the appropriated JavaScript to the client to call again 
65:             * using the symmetric DOM element at the client.</p>     
66:             */
67:            public void focus();
68:        }