type property
Retrieves or initially sets (IHTMLInputElement only) the type of input control represented by the object.
Syntax
HRESULT value = object.put_type( type);HRESULT value = object.get_type(* type);
Property values
Type: BSTR
One of the input control values in Possible Values.
button
Creates a button control.
checkbox
Creates a check box for simple Boolean attributes or for attributes that can take multiple values at the same time. The input consists of a number of check box controls, each of which has the same name. Each selected check box generates a separate name/value pair in the submitted data, even if this results in duplicate names. The default value is on
.
Creates a single-line validated email address entry control.
text
Default. Creates a single-line text-entry control. Use the value in conjunction with the IHTMLInputFileElement::size and IHTMLInputFileElement::maxLength properties.
file
Creates a file upload object.
hidden
Creates a control hidden from the user, but the value of the IHTMLOptionButtonElement::value property is sent with the submitted form.
image
Creates an image control that can be clicked, causing the form to be immediately submitted. The coordinates of the selected point are measured in pixels from the upper-left corner of the image and are submitted with the form as two name/value pairs. The x-coordinate is submitted under the name of the control with .x
appended, and the y-coordinate is submitted under the name of the control with .y
appended. Any value
property is ignored. The image is specified by the IHTMLInputElement3::src property, exactly as for the img object
number
Creates a single-line numeric entry control.
password
Creates a control similar to the text control, except that text is not displayed as the user enters it.
radio
Creates radio buttons used for mutually exclusive sets of values. Each radio button control in the group should be given the same name. Only the selected radio button in the group generates a name/value pair in the submitted data. Radio buttons require an explicit IHTMLOptionButtonElement::value property.
range
Creates a slider control for imprecise number input.
reset
Creates a button that resets the form's controls to their specified initial values. You can specify the label to display on this button just as you can for the Submit button.
search
Creates a single-line text entry control that behaves essentially the same as "type="text"" that enables you to differentiate search fields from text fields through CSS styles.
submit
Creates a button that submits the form. Use the IHTMLOptionButtonElement::value attribute to specify a label that is displayed on the button. The default label is application-specific. When the button is clicked, the associated control objects submit name/value pairs to the server.
tel
Creates a single-line telephone entry control.
text
Default. Creates a single-line text-entry control. Use the value in conjunction with the IHTMLInputFileElement::size and IHTMLInputFileElement::maxLength properties.
url
Creates a single-line URL entry control.
Standards information
- HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 4.10.7
- Document Object Model (DOM) Level 1 Specification, Section 2.5.5
- HTML 4.01 Specification, Section 17.4
Remarks
Only the IHTMLInputFileElement::type property is writeable.
The IHTMLInputFileElement::type property is read/write-once, but only when an input element is created with the IHTMLDocument2::createElement method and before it is added to the document.