1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
/* * Copyright (c) 2000 World Wide Web Consortium, * (Massachusetts Institute of Technology, Institut National de * Recherche en Informatique et en Automatique, Keio University). All * Rights Reserved. This program is distributed under the W3C's Software * Intellectual Property License. This program is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY; without even * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See W3C License http://www.w3.org/Consortium/Legal/ for more * details. */ package org.w3c.dom.html; import org.w3c.dom.DOMException; /** * The select element allows the selection of an option. The contained * options can be directly accessed through the select element as a * collection. See the SELECT element definition in HTML 4.0. * <p>See also the <a href='http://www.w3.org/TR/2000/CR-DOM-Level-2-20000510'>Document Object Model (DOM) Level 2 Specification</a>. */ public interface HTMLSelectElement extends HTMLElement { /** * The type of this form control. This is the string "select-multiple" * when the multiple attribute is <code>true</code> and the string * "select-one" when <code>false</code> . */ public String getType(); /** * The ordinal index of the selected option, starting from 0. The value * -1 is returned if no element is selected. If multiple options are * selected, the index of the first selected option is returned. */ public int getSelectedIndex(); public void setSelectedIndex(int selectedIndex); /** * The current form control value. */ public String getValue(); public void setValue(String value); /** * The number of options in this <code>SELECT</code> . */ public int getLength(); /** * Returns the <code>FORM</code> element containing this control. Returns * <code>null</code> if this control is not within the context of a form. */ public HTMLFormElement getForm(); /** * The collection of <code>OPTION</code> elements contained by this * element. */ public HTMLCollection getOptions(); /** * The control is unavailable in this context. See the disabled * attribute definition in HTML 4.0. */ public boolean getDisabled(); public void setDisabled(boolean disabled); /** * If true, multiple <code>OPTION</code> elements may be selected in * this <code>SELECT</code> . See the multiple attribute definition in * HTML 4.0. */ public boolean getMultiple(); public void setMultiple(boolean multiple); /** * Form control or object name when submitted with a form. See the name * attribute definition in HTML 4.0. */ public String getName(); public void setName(String name); /** * Number of visible rows. See the size attribute definition in HTML 4.0. */ public int getSize(); public void setSize(int size); /** * Index that represents the element's position in the tabbing order. See * the tabindex attribute definition in HTML 4.0. */ public int getTabIndex(); public void setTabIndex(int tabIndex); /** * Add a new element to the collection of <code>OPTION</code> elements * for this <code>SELECT</code> . This method is the equivalent of the * <code>appendChild</code> method of the <code>Node</code> interface if * the <code>before</code> parameter is <code>null</code> . It is * equivalent to the <code>insertBefore</code> method on the parent of * <code>before</code> in all other cases. * @param element The element to add. * @param before The element to insert before, or <code>null</code> for * the tail of the list. * @exception DOMException * NOT_FOUND_ERR: Raised if <code>before</code> is not a descendant of * the <code>SELECT</code> element. */ public void add(HTMLElement element, HTMLElement before) throws DOMException; /** * Remove an element from the collection of <code>OPTION</code> elements * for this <code>SELECT</code> . Does nothing if no element has the given * index. * @param index The index of the item to remove, starting from 0. */ public void remove(int index); /** * Removes keyboard focus from this element. */ public void blur(); /** * Gives keyboard focus to this element. */ public void focus(); }