001: /*
002: * Copyright (c) 2000 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. See W3C License http://www.w3.org/Consortium/Legal/ for more
010: * details.
011: */
012:
013: package org.w3c.dom.html;
014:
015: /**
016: * Multi-line text field. See the TEXTAREA element definition in HTML 4.0.
017: * <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>.
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. Changing this attribute, however,
024: * resets the contents of the form control.
025: */
026: public String getDefaultValue();
027:
028: public void setDefaultValue(String defaultValue);
029:
030: /**
031: * Returns the <code>FORM</code> element containing this control. Returns
032: * <code>null</code> if this control is not within the context of a form.
033: */
034: public HTMLFormElement getForm();
035:
036: /**
037: * A single character access key to give access to the form control. See
038: * the accesskey attribute definition in HTML 4.0.
039: */
040: public String getAccessKey();
041:
042: public void setAccessKey(String accessKey);
043:
044: /**
045: * Width of control (in characters). See the cols attribute definition
046: * in HTML 4.0.
047: */
048: public int getCols();
049:
050: public void setCols(int cols);
051:
052: /**
053: * The control is unavailable in this context. See the disabled
054: * attribute definition in HTML 4.0.
055: */
056: public boolean getDisabled();
057:
058: public void setDisabled(boolean disabled);
059:
060: /**
061: * Form control or object name when submitted with a form. See the name
062: * attribute definition in HTML 4.0.
063: */
064: public String getName();
065:
066: public void setName(String name);
067:
068: /**
069: * This control is read-only. See the readonly attribute definition in
070: * HTML 4.0.
071: */
072: public boolean getReadOnly();
073:
074: public void setReadOnly(boolean readOnly);
075:
076: /**
077: * Number of text rows. See the rows attribute definition in HTML 4.0.
078: */
079: public int getRows();
080:
081: public void setRows(int rows);
082:
083: /**
084: * Index that represents the element's position in the tabbing order. See
085: * the tabindex attribute definition in HTML 4.0.
086: */
087: public int getTabIndex();
088:
089: public void setTabIndex(int tabIndex);
090:
091: /**
092: * The type of this form control. This the string "textarea".
093: */
094: public String getType();
095:
096: /**
097: * Represents the current contents of the corresponding form control, in
098: * an interactive user agent. Changing this attribute changes the
099: * contents of the form control, but does not change the contents of the
100: * element. If the entirety of the data can not fit into a single
101: * <code>DOMString</code> , the implementation may truncate the data.
102: */
103: public String getValue();
104:
105: public void setValue(String value);
106:
107: /**
108: * Removes keyboard focus from this element.
109: */
110: public void blur();
111:
112: /**
113: * Gives keyboard focus to this element.
114: */
115: public void focus();
116:
117: /**
118: * Select the contents of the <code>TEXTAREA</code> .
119: */
120: public void select();
121:
122: }
|