/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code 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 the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

/*
 * This file is available under and governed by the GNU General Public
 * License version 2 only, as published by the Free Software Foundation.
 * However, the following notice accompanied the original version of this
 * file and, per its terms, should not be removed:
 *
 * Copyright (c) 2000 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.html;

 Form control.  Note. 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 HTML 4.0.
See also the Document Object Model (DOM) Level 2 Specification.
Since:
1.4, DOM Level 2/**
 *  Form control.  Note. 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 HTML 4.0.
 * <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>.
 *
 * @since 1.4, DOM Level 2
 */
public interface HTMLInputElement extends HTMLElement {
    
 When the type 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. Changing this attribute, however, resets the contents
of the form control. See the  value attribute definition in HTML 4.0.
/**
     *  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. Changing this attribute, however, resets the contents
     * of the form control. See the  value attribute definition in HTML 4.0.
     */
    public String getDefaultValue();
    public void setDefaultValue(String defaultValue);

    
 When type 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. Changes to this
attribute, however, resets the state of the form control. See the
checked attribute definition in HTML 4.0.
/**
     *  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. Changes to this
     * attribute, however, resets the state of the form control. See the
     * checked attribute definition in HTML 4.0.
     */
    public boolean getDefaultChecked();
    public void setDefaultChecked(boolean defaultChecked);

    
 Returns the FORM element containing this control. Returns
null if this control is not within the context of a form.
/**
     *  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.0.
/**
     *  A comma-separated list of content types that a server processing this
     * form will handle correctly. See the  accept attribute definition in
     * HTML 4.0.
     */
    public String getAccept();
    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.0.
/**
     *  A single character access key to give access to the form control. See
     * the  accesskey attribute definition in HTML 4.0.
     */
    public String getAccessKey();
    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.0.
This attribute is deprecated in HTML 4.0.
/**
     *  Aligns this object (vertically or horizontally)  with respect to its
     * surrounding text. See the  align attribute definition in HTML 4.0.
     * This attribute is deprecated in HTML 4.0.
     */
    public String getAlign();
    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.0.
/**
     *  Alternate text for user agents not rendering the normal content of
     * this element. See the  alt attribute definition in HTML 4.0.
     */
    public String getAlt();
    public void setAlt(String alt);

    
 When the type 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 value attribute of the element.
/**
     *  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 value attribute of the element.
     */
    public boolean getChecked();
    public void setChecked(boolean checked);

    
 The control is unavailable in this context. See the  disabled
attribute definition in HTML 4.0.
/**
     *  The control is unavailable in this context. See the  disabled
     * attribute definition in HTML 4.0.
     */
    public boolean getDisabled();
    public void setDisabled(boolean disabled);

    
 Maximum number of characters for text fields, when type
has the value "Text" or "Password". See the  maxlength attribute
definition in HTML 4.0.
/**
     *  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.0.
     */
    public int getMaxLength();
    public void setMaxLength(int maxLength);

    
 Form control or object name when submitted with a form. See the  name
attribute definition in HTML 4.0.
/**
     *  Form control or object name when submitted with a form. See the  name
     * attribute definition in HTML 4.0.
     */
    public String getName();
    public void setName(String name);

    
 This control is read-only. Relevant only when type has
the value "Text" or "Password". See the  readonly attribute definition
in HTML 4.0.
/**
     *  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.0.
     */
    public boolean getReadOnly();
    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.0.
/**
     *  Size information. The precise meaning is specific to each type of
     * field.  See the  size attribute definition in HTML 4.0.
     */
    public String getSize();
    public void setSize(String size);

    
 When the type 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.0.
/**
     *  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.0.
     */
    public String getSrc();
    public void setSrc(String src);

    
 Index that represents the element's position in the tabbing order. See
the  tabindex attribute definition in HTML 4.0.
/**
     *  Index that represents the element's position in the tabbing order. See
     * the  tabindex attribute definition in HTML 4.0.
     */
    public int getTabIndex();
    public void setTabIndex(int tabIndex);

    
 The type of control created. See the  type attribute definition in
HTML 4.0.
/**
     *  The type of control created. See the  type attribute definition in
     * HTML 4.0.
     */
    public String getType();

    
 Use client-side image map. See the  usemap attribute definition in
HTML 4.0.
/**
     *  Use client-side image map. See the  usemap attribute definition in
     * HTML 4.0.
     */
    public String getUseMap();
    public void setUseMap(String useMap);

    
 When the type 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
type 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.0.
/**
     *  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.0.
     */
    public String getValue();
    public void setValue(String value);

    
 Removes keyboard focus from this element.
/**
     *  Removes keyboard focus from this element.
     */
    public void blur();

    
 Gives keyboard focus to this element.
/**
     *  Gives keyboard focus to this element.
     */
    public void focus();

    
 Select the contents of the text area. For INPUT elements
whose type attribute has one of the following values:
"Text", "File", or "Password".
/**
     *  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 INPUT elements whose
type attribute has one of the following values: "Button",
"Checkbox", "Radio", "Reset", or "Submit".
/**
     *  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();

}