1 /* 2 * Copyright (C) 1999 Lars Knoll (knoll (at) kde.org) 3 * (C) 1999 Antti Koivisto (koivisto (at) kde.org) 4 * (C) 2000 Dirk Mueller (mueller (at) kde.org) 5 * Copyright (C) 2004, 2005, 2006, 2007, 2009 Apple Inc. All rights reserved. 6 * Copyright (C) 2010 Google Inc. All rights reserved. 7 * 8 * This library is free software; you can redistribute it and/or 9 * modify it under the terms of the GNU Library General Public 10 * License as published by the Free Software Foundation; either 11 * version 2 of the License, or (at your option) any later version. 12 * 13 * This library is distributed in the hope that it will be useful, 14 * but WITHOUT ANY WARRANTY; without even the implied warranty of 15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 16 * Library General Public License for more details. 17 * 18 * You should have received a copy of the GNU Library General Public License 19 * along with this library; see the file COPYING.LIB. If not, write to 20 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 21 * Boston, MA 02110-1301, USA. 22 * 23 */ 24 25 #ifndef HTMLSelectElement_h 26 #define HTMLSelectElement_h 27 28 #include "CollectionCache.h" 29 #include "HTMLFormControlElement.h" 30 #include "SelectElement.h" 31 32 namespace WebCore { 33 34 class HTMLOptionElement; 35 class HTMLOptionsCollection; 36 class KeyboardEvent; 37 38 class HTMLSelectElement : public HTMLFormControlElementWithState, public SelectElement { 39 public: 40 HTMLSelectElement(const QualifiedName&, Document*, HTMLFormElement* = 0); 41 42 virtual int selectedIndex() const; 43 virtual void setSelectedIndex(int index, bool deselect = true); 44 virtual void setSelectedIndexByUser(int index, bool deselect = true, bool fireOnChangeNow = false); 45 46 unsigned length() const; 47 48 virtual int size() const { return m_data.size(); } 49 virtual bool multiple() const { return m_data.multiple(); } 50 51 void add(HTMLElement* element, HTMLElement* before, ExceptionCode&); 52 void remove(int index); 53 54 String value(); 55 void setValue(const String&); 56 57 PassRefPtr<HTMLOptionsCollection> options(); 58 59 virtual void childrenChanged(bool changedByParser = false, Node* beforeChange = 0, Node* afterChange = 0, int childCountDelta = 0); 60 61 void setRecalcListItems(); 62 void recalcListItemsIfNeeded(); 63 64 virtual const Vector<Element*>& listItems() const { return m_data.listItems(this); } 65 66 virtual void accessKeyAction(bool sendToAnyElement); 67 void accessKeySetSelectedIndex(int); 68 69 void setMultiple(bool); 70 71 void setSize(int); 72 73 void setOption(unsigned index, HTMLOptionElement*, ExceptionCode&); 74 void setLength(unsigned, ExceptionCode&); 75 76 Node* namedItem(const AtomicString& name); 77 Node* item(unsigned index); 78 79 CollectionCache* collectionInfo() { m_collectionInfo.checkConsistency(); return &m_collectionInfo; } 80 81 void scrollToSelection(); 82 83 private: 84 virtual int tagPriority() const { return 6; } 85 virtual bool checkDTD(const Node* newChild); 86 87 virtual const AtomicString& formControlType() const; 88 89 virtual bool isKeyboardFocusable(KeyboardEvent*) const; 90 virtual bool isMouseFocusable() const; 91 virtual bool canSelectAll() const; 92 virtual void selectAll(); 93 94 virtual void recalcStyle(StyleChange); 95 96 virtual void dispatchFocusEvent(); 97 virtual void dispatchBlurEvent(); 98 99 virtual bool canStartSelection() const { return false; } 100 101 virtual bool isEnumeratable() const { return true; } 102 103 virtual bool saveFormControlState(String& value) const; 104 virtual void restoreFormControlState(const String&); 105 106 virtual void parseMappedAttribute(MappedAttribute*); 107 108 virtual RenderObject* createRenderer(RenderArena*, RenderStyle *); 109 virtual bool appendFormData(FormDataList&, bool); 110 111 virtual int optionToListIndex(int optionIndex) const; 112 virtual int listToOptionIndex(int listIndex) const; 113 114 virtual void reset(); 115 116 virtual void defaultEventHandler(Event*); 117 118 virtual void setActiveSelectionAnchorIndex(int index); 119 virtual void setActiveSelectionEndIndex(int index); 120 virtual void updateListBoxSelection(bool deselectOtherOptions); 121 virtual void listBoxOnChange(); 122 virtual void menuListOnChange(); 123 124 virtual int activeSelectionStartListIndex() const; 125 virtual int activeSelectionEndListIndex() const; 126 127 void recalcListItems(bool updateSelectedStates = true) const; 128 129 void deselectItems(HTMLOptionElement* excludeElement = 0); 130 void typeAheadFind(KeyboardEvent*); 131 void saveLastSelection(); 132 133 virtual void insertedIntoTree(bool); 134 135 virtual bool isOptionalFormControl() const { return true; } 136 137 SelectElementData m_data; 138 CollectionCache m_collectionInfo; 139 }; 140 141 } // namespace 142 143 #endif 144