Share via

type property

  • Article

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.

email

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 IHTMLInputElement::size and IHTMLInputElement::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 IHTMLInputImage::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 IHTMLInputElement::size and IHTMLInputElement::maxLength properties.

url

Creates a single-line URL entry control.

Standards information

Remarks

Only the IHTMLInputImage::type property is writeable.

The IHTMLInputImage::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.