indeterminate property

  • Article

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

Sets or retrieves whether the user has changed the status of a input type=checkbox element. On a HTMLProgressElement element will show activity but not a specific amount.

Syntax

HRESULT value = object.put_indeterminate(VARIANT_BOOL v);HRESULT value = object.get_indeterminate(VARIANT_BOOL* p);

Property values

Type: VARIANT_BOOL

VARIANT_FALSE (false)

Default. Check box is not dimmed.

VARIANT_TRUE (true)

Check box is checked and dimmed.

Remarks

The IHTMLOptionButtonElement::indeterminate property can be used to indicate whether the user has acted on a control. For example, setting the IHTMLOptionButtonElement::indeterminate to true causes the check box to appear checked and dimmed, indicating an indeterminate state.

The value of the IHTMLOptionButtonElement::indeterminate property acts independently of the values of the IHTMLOptionButtonElement::checked and IHTMLOptionButtonElement::status properties. Creating an indeterminate state is different from disabling the control. Consequently, a check box in the indeterminate state can still receive the focus. When the user clicks an indeterminate control, the indeterminate state turns off and the checked state of the check box toggles.

 

 

Build date: 6/12/2012