001    /*
002     * Copyright (c) 2003 World Wide Web Consortium,
003     * (Massachusetts Institute of Technology, Institut National de
004     * Recherche en Informatique et en Automatique, Keio University). All
005     * Rights Reserved. This program is distributed under the W3C's Software
006     * Intellectual Property License. This program is distributed in the
007     * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
008     * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
009     * PURPOSE.
010     * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
011     */
012    
013    package org.w3c.dom.html2;
014    
015    /**
016     * Multi-line text field. See the TEXTAREA element definition in HTML 4.01.
017     * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>.
018     */
019    public interface HTMLTextAreaElement extends HTMLElement {
020        /**
021         * Represents the contents of the element. The value of this attribute 
022         * does not change if the contents of the corresponding form control, in 
023         * an interactive user agent, changes.
024         * @version DOM Level 2
025         */
026        public String getDefaultValue();
027        /**
028         * Represents the contents of the element. The value of this attribute 
029         * does not change if the contents of the corresponding form control, in 
030         * an interactive user agent, changes.
031         * @version DOM Level 2
032         */
033        public void setDefaultValue(String defaultValue);
034    
035        /**
036         * Returns the <code>FORM</code> element containing this control. Returns 
037         * <code>null</code> if this control is not within the context of a 
038         * form. 
039         */
040        public HTMLFormElement getForm();
041    
042        /**
043         * A single character access key to give access to the form control. See 
044         * the accesskey attribute definition in HTML 4.01.
045         */
046        public String getAccessKey();
047        /**
048         * A single character access key to give access to the form control. See 
049         * the accesskey attribute definition in HTML 4.01.
050         */
051        public void setAccessKey(String accessKey);
052    
053        /**
054         * Width of control (in characters). See the cols attribute definition in 
055         * HTML 4.01.
056         */
057        public int getCols();
058        /**
059         * Width of control (in characters). See the cols attribute definition in 
060         * HTML 4.01.
061         */
062        public void setCols(int cols);
063    
064        /**
065         * The control is unavailable in this context. See the disabled attribute 
066         * definition in HTML 4.01.
067         */
068        public boolean getDisabled();
069        /**
070         * The control is unavailable in this context. See the disabled attribute 
071         * definition in HTML 4.01.
072         */
073        public void setDisabled(boolean disabled);
074    
075        /**
076         * Form control or object name when submitted with a form. See the name 
077         * attribute definition in HTML 4.01.
078         */
079        public String getName();
080        /**
081         * Form control or object name when submitted with a form. See the name 
082         * attribute definition in HTML 4.01.
083         */
084        public void setName(String name);
085    
086        /**
087         * This control is read-only. See the readonly attribute definition in 
088         * HTML 4.01.
089         */
090        public boolean getReadOnly();
091        /**
092         * This control is read-only. See the readonly attribute definition in 
093         * HTML 4.01.
094         */
095        public void setReadOnly(boolean readOnly);
096    
097        /**
098         * Number of text rows. See the rows attribute definition in HTML 4.01.
099         */
100        public int getRows();
101        /**
102         * Number of text rows. See the rows attribute definition in HTML 4.01.
103         */
104        public void setRows(int rows);
105    
106        /**
107         * Index that represents the element's position in the tabbing order. See 
108         * the tabindex attribute definition in HTML 4.01.
109         */
110        public int getTabIndex();
111        /**
112         * Index that represents the element's position in the tabbing order. See 
113         * the tabindex attribute definition in HTML 4.01.
114         */
115        public void setTabIndex(int tabIndex);
116    
117        /**
118         * The type of this form control. This the string "textarea".
119         */
120        public String getType();
121    
122        /**
123         * Represents the current contents of the corresponding form control, in 
124         * an interactive user agent. Changing this attribute changes the 
125         * contents of the form control, but does not change the contents of the 
126         * element. If the entirety of the data can not fit into a single 
127         * <code>DOMString</code>, the implementation may truncate the data.
128         */
129        public String getValue();
130        /**
131         * Represents the current contents of the corresponding form control, in 
132         * an interactive user agent. Changing this attribute changes the 
133         * contents of the form control, but does not change the contents of the 
134         * element. If the entirety of the data can not fit into a single 
135         * <code>DOMString</code>, the implementation may truncate the data.
136         */
137        public void setValue(String value);
138    
139        /**
140         * Removes keyboard focus from this element.
141         */
142        public void blur();
143    
144        /**
145         * Gives keyboard focus to this element.
146         */
147        public void focus();
148    
149        /**
150         * Select the contents of the <code>TEXTAREA</code>.
151         */
152        public void select();
153    
154    }