1/*
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3 *
4 * This code is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License version 2 only, as
6 * published by the Free Software Foundation.  Oracle designates this
7 * particular file as subject to the "Classpath" exception as provided
8 * by Oracle in the LICENSE file that accompanied this code.
9 *
10 * This code is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
13 * version 2 for more details (a copy is included in the LICENSE file that
14 * accompanied this code).
15 *
16 * You should have received a copy of the GNU General Public License version
17 * 2 along with this work; if not, write to the Free Software Foundation,
18 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19 *
20 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
21 * or visit www.oracle.com if you need additional information or have any
22 * questions.
23 */
24
25/*
26 * This file is available under and governed by the GNU General Public
27 * License version 2 only, as published by the Free Software Foundation.
28 * However, the following notice accompanied the original version of this
29 * file and, per its terms, should not be removed:
30 *
31 * Copyright (c) 2000 World Wide Web Consortium,
32 * (Massachusetts Institute of Technology, Institut National de
33 * Recherche en Informatique et en Automatique, Keio University). All
34 * Rights Reserved. This program is distributed under the W3C's Software
35 * Intellectual Property License. This program is distributed in the
36 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
37 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
38 * PURPOSE. See W3C License http://www.w3.org/Consortium/Legal/ for more
39 * details.
40 */
41
42package org.w3c.dom.html;
43
44/**
45 *  Multi-line text field. See the  TEXTAREA element definition in HTML 4.0.
46 * <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>.
47 *
48 * @since 1.4, DOM Level 2
49 */
50public interface HTMLTextAreaElement extends HTMLElement {
51    /**
52     *  Represents the contents of the element. The value of this attribute
53     * does not change if the contents of the corresponding form control, in
54     * an interactive user agent, changes. Changing this attribute, however,
55     * resets the contents of the form control.
56     */
57    public String getDefaultValue();
58    public void setDefaultValue(String defaultValue);
59
60    /**
61     *  Returns the <code>FORM</code> element containing this control. Returns
62     * <code>null</code> if this control is not within the context of a form.
63     */
64    public HTMLFormElement getForm();
65
66    /**
67     *  A single character access key to give access to the form control. See
68     * the  accesskey attribute definition in HTML 4.0.
69     */
70    public String getAccessKey();
71    public void setAccessKey(String accessKey);
72
73    /**
74     *  Width of control (in characters). See the  cols attribute definition
75     * in HTML 4.0.
76     */
77    public int getCols();
78    public void setCols(int cols);
79
80    /**
81     *  The control is unavailable in this context. See the  disabled
82     * attribute definition in HTML 4.0.
83     */
84    public boolean getDisabled();
85    public void setDisabled(boolean disabled);
86
87    /**
88     *  Form control or object name when submitted with a form. See the  name
89     * attribute definition in HTML 4.0.
90     */
91    public String getName();
92    public void setName(String name);
93
94    /**
95     *  This control is read-only. See the  readonly attribute definition in
96     * HTML 4.0.
97     */
98    public boolean getReadOnly();
99    public void setReadOnly(boolean readOnly);
100
101    /**
102     *  Number of text rows. See the  rows attribute definition in HTML 4.0.
103     */
104    public int getRows();
105    public void setRows(int rows);
106
107    /**
108     *  Index that represents the element's position in the tabbing order. See
109     * the  tabindex attribute definition in HTML 4.0.
110     */
111    public int getTabIndex();
112    public void setTabIndex(int tabIndex);
113
114    /**
115     *  The type of this form control. This the string "textarea".
116     */
117    public String getType();
118
119    /**
120     *  Represents the current contents of the corresponding form control, in
121     * an interactive user agent. Changing this attribute changes the
122     * contents of the form control, but does not change the contents of the
123     * element. If the entirety of the data can not fit into a single
124     * <code>DOMString</code> , the implementation may truncate the data.
125     */
126    public String getValue();
127    public void setValue(String value);
128
129    /**
130     *  Removes keyboard focus from this element.
131     */
132    public void blur();
133
134    /**
135     *  Gives keyboard focus to this element.
136     */
137    public void focus();
138
139    /**
140     *  Select the contents of the <code>TEXTAREA</code> .
141     */
142    public void select();
143
144}
145