Subversion Repositories openrisc

/*
 * Copyright (c) 2003 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.html2;
 
/**
 * Form control.Depending upon the environment in which the page is being
 * viewed, the value property may be read-only for the file upload input
 * type. For the "password" input type, the actual value returned may be
 * masked to prevent unauthorized use. See the INPUT element definition in [<a href='http://www.w3.org/TR/1999/REC-html401-19991224'>HTML 4.01</a>].
 * <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>.
 */
public interface HTMLInputElement extends HTMLElement {
    /**
     * When the <code>type</code> attribute of the element has the value
     * "text", "file" or "password", this represents the HTML value
     * attribute of the element. The value of this attribute does not change
     * if the contents of the corresponding form control, in an interactive
     * user agent, changes. See the value attribute definition in HTML 4.01.
     */
    public String getDefaultValue();
    /**
     * When the <code>type</code> attribute of the element has the value
     * "text", "file" or "password", this represents the HTML value
     * attribute of the element. The value of this attribute does not change
     * if the contents of the corresponding form control, in an interactive
     * user agent, changes. See the value attribute definition in HTML 4.01.
     */
    public void setDefaultValue(String defaultValue);
 
    /**
     * When <code>type</code> has the value "radio" or "checkbox", this
     * represents the HTML checked attribute of the element. The value of
     * this attribute does not change if the state of the corresponding form
     * control, in an interactive user agent, changes. See the checked
     * attribute definition in HTML 4.01.
     */
    public boolean getDefaultChecked();
    /**
     * When <code>type</code> has the value "radio" or "checkbox", this
     * represents the HTML checked attribute of the element. The value of
     * this attribute does not change if the state of the corresponding form
     * control, in an interactive user agent, changes. See the checked
     * attribute definition in HTML 4.01.
     */
    public void setDefaultChecked(boolean defaultChecked);
 
    /**
     * 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();
 
    /**
     * A comma-separated list of content types that a server processing this
     * form will handle correctly. See the accept attribute definition in
     * HTML 4.01.
     */
    public String getAccept();
    /**
     * A comma-separated list of content types that a server processing this
     * form will handle correctly. See the accept attribute definition in
     * HTML 4.01.
     */
    public void setAccept(String accept);
 
    /**
     * A single character access key to give access to the form control. See
     * the accesskey attribute definition in HTML 4.01.
     */
    public String getAccessKey();
    /**
     * A single character access key to give access to the form control. See
     * the accesskey attribute definition in HTML 4.01.
     */
    public void setAccessKey(String accessKey);
 
    /**
     * Aligns this object (vertically or horizontally) with respect to its
     * surrounding text. See the align attribute definition in HTML 4.01.
     * This attribute is deprecated in HTML 4.01.
     */
    public String getAlign();
    /**
     * Aligns this object (vertically or horizontally) with respect to its
     * surrounding text. See the align attribute definition in HTML 4.01.
     * This attribute is deprecated in HTML 4.01.
     */
    public void setAlign(String align);
 
    /**
     * Alternate text for user agents not rendering the normal content of this
     * element. See the alt attribute definition in HTML 4.01.
     */
    public String getAlt();
    /**
     * Alternate text for user agents not rendering the normal content of this
     * element. See the alt attribute definition in HTML 4.01.
     */
    public void setAlt(String alt);
 
    /**
     * When the <code>type</code> attribute of the element has the value
     * "radio" or "checkbox", this represents the current state of the form
     * control, in an interactive user agent. Changes to this attribute
     * change the state of the form control, but do not change the value of
     * the HTML checked attribute of the INPUT element.During the handling
     * of a click event on an input element with a type attribute that has
     * the value "radio" or "checkbox", some implementations may change the
     * value of this property before the event is being dispatched in the
     * document. If the default action of the event is canceled, the value
     * of the property may be changed back to its original value. This means
     * that the value of this property during the handling of click events
     * is implementation dependent.
     */
    public boolean getChecked();
    /**
     * When the <code>type</code> attribute of the element has the value
     * "radio" or "checkbox", this represents the current state of the form
     * control, in an interactive user agent. Changes to this attribute
     * change the state of the form control, but do not change the value of
     * the HTML checked attribute of the INPUT element.During the handling
     * of a click event on an input element with a type attribute that has
     * the value "radio" or "checkbox", some implementations may change the
     * value of this property before the event is being dispatched in the
     * document. If the default action of the event is canceled, the value
     * of the property may be changed back to its original value. This means
     * that the value of this property during the handling of click events
     * is implementation dependent.
     */
    public void setChecked(boolean checked);
 
    /**
     * The control is unavailable in this context. See the disabled attribute
     * definition in HTML 4.01.
     */
    public boolean getDisabled();
    /**
     * The control is unavailable in this context. See the disabled attribute
     * definition in HTML 4.01.
     */
    public void setDisabled(boolean disabled);
 
    /**
     * Maximum number of characters for text fields, when <code>type</code>
     * has the value "text" or "password". See the maxlength attribute
     * definition in HTML 4.01.
     */
    public int getMaxLength();
    /**
     * Maximum number of characters for text fields, when <code>type</code>
     * has the value "text" or "password". See the maxlength attribute
     * definition in HTML 4.01.
     */
    public void setMaxLength(int maxLength);
 
    /**
     * Form control or object name when submitted with a form. See the name
     * attribute definition in HTML 4.01.
     */
    public String getName();
    /**
     * Form control or object name when submitted with a form. See the name
     * attribute definition in HTML 4.01.
     */
    public void setName(String name);
 
    /**
     * This control is read-only. Relevant only when <code>type</code> has the
     * value "text" or "password". See the readonly attribute definition in
     * HTML 4.01.
     */
    public boolean getReadOnly();
    /**
     * This control is read-only. Relevant only when <code>type</code> has the
     * value "text" or "password". See the readonly attribute definition in
     * HTML 4.01.
     */
    public void setReadOnly(boolean readOnly);
 
    /**
     * Size information. The precise meaning is specific to each type of
     * field. See the size attribute definition in HTML 4.01.
     * @version DOM Level 2
     */
    public int getSize();
    /**
     * Size information. The precise meaning is specific to each type of
     * field. See the size attribute definition in HTML 4.01.
     * @version DOM Level 2
     */
    public void setSize(int size);
 
    /**
     * When the <code>type</code> attribute has the value "image", this
     * attribute specifies the location of the image to be used to decorate
     * the graphical submit button. See the src attribute definition in HTML
     * 4.01.
     */
    public String getSrc();
    /**
     * When the <code>type</code> attribute has the value "image", this
     * attribute specifies the location of the image to be used to decorate
     * the graphical submit button. See the src attribute definition in HTML
     * 4.01.
     */
    public void setSrc(String src);
 
    /**
     * Index that represents the element's position in the tabbing order. See
     * the tabindex attribute definition in HTML 4.01.
     */
    public int getTabIndex();
    /**
     * Index that represents the element's position in the tabbing order. See
     * the tabindex attribute definition in HTML 4.01.
     */
    public void setTabIndex(int tabIndex);
 
    /**
     * The type of control created (all lower case). See the type attribute
     * definition in HTML 4.01.
     * @version DOM Level 2
     */
    public String getType();
    /**
     * The type of control created (all lower case). See the type attribute
     * definition in HTML 4.01.
     * @version DOM Level 2
     */
    public void setType(String type);
 
    /**
     * Use client-side image map. See the usemap attribute definition in HTML
     * 4.01.
     */
    public String getUseMap();
    /**
     * Use client-side image map. See the usemap attribute definition in HTML
     * 4.01.
     */
    public void setUseMap(String useMap);
 
    /**
     * When the <code>type</code> attribute of the element has the value
     * "text", "file" or "password", this represents the current contents of
     * the corresponding form control, in an interactive user agent.
     * Changing this attribute changes the contents of the form control, but
     * does not change the value of the HTML value attribute of the element.
     * When the <code>type</code> attribute of the element has the value
     * "button", "hidden", "submit", "reset", "image", "checkbox" or
     * "radio", this represents the HTML value attribute of the element. See
     * the value attribute definition in HTML 4.01.
     */
    public String getValue();
    /**
     * When the <code>type</code> attribute of the element has the value
     * "text", "file" or "password", this represents the current contents of
     * the corresponding form control, in an interactive user agent.
     * Changing this attribute changes the contents of the form control, but
     * does not change the value of the HTML value attribute of the element.
     * When the <code>type</code> attribute of the element has the value
     * "button", "hidden", "submit", "reset", "image", "checkbox" or
     * "radio", this represents the HTML value attribute of the element. See
     * the value attribute definition in HTML 4.01.
     */
    public void setValue(String value);
 
    /**
     * Removes keyboard focus from this element.
     */
    public void blur();
 
    /**
     * Gives keyboard focus to this element.
     */
    public void focus();
 
    /**
     * Select the contents of the text area. For <code>INPUT</code> elements
     * whose <code>type</code> attribute has one of the following values:
     * "text", "file", or "password".
     */
    public void select();
 
    /**
     * Simulate a mouse-click. For <code>INPUT</code> elements whose
     * <code>type</code> attribute has one of the following values:
     * "button", "checkbox", "radio", "reset", or "submit".
     */
    public void click();
 
}