selected property

[This documentation is preliminary and is subject to change.]

Sets or retrieves whether the option in the list box is the default item.

Syntax

HRESULT value = object.put_selected(VARIANT_BOOL v);HRESULT value = object.get_selected(VARIANT_BOOL* p);

Property values

Type: VARIANT_BOOL

VARIANT_FALSE (false)

Default. Item is not selected as the default.

VARIANT_TRUE (true)

Item is selected as the default.

Standards information

• Document Object Model (DOM) Level 1 Specification, Section 2.5.5
• HTML 4.01 Specification, Section 17.6.1

Remarks

If the property is not set, the first item is selected by default.

The property determines whether a value is submitted with the form. If the value of the control matches the default value, the control's value is not submitted. The value is submitted only when the control's value does not match the default value.

To select an item in HTML, it is not necessary to set the value of the IHTMLOptionElement::selected attribute to true. The mere presence of the IHTMLOptionElement::selected attribute sets its value to true.

See also

IHTMLOptionElement::defaultSelected

Build date: 6/12/2012