IHTMLInputElement::get_indeterminate Method

Retrieves the value that indicates whether the INPUT type=checkbox element is in the indeterminate state. An indeterminate check box has a dimmed background to represent an indeterminate state.

Syntax

HRESULT get_indeterminate(
    VARIANT_BOOL *p 
);

Parameters

p
Address of a VARIANT Boolean structure that receives VARIANT_TRUE if the check box is indeterminate, or VARIANT_FALSE otherwise. The default value is VARIANT_FALSE.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

When indeterminate is set, the INPUT type=checkbox element appears checked, but dimmed. The value of indeterminate is independent of the values for the checked and status properties.

This does not change whether the INPUT type=checkbox element is marked as checked and is different than disabling the control. A check box in the indeterminate state can still receive the focus. When the user clicks an indeterminate button, the indeterminate state is turned off and the INPUT type=checkbox element is appropriately checked or unchecked.

IHTMLInputElement::put_indeterminate Method

Sets the value that indicates whether the INPUT type=checkbox element is in the indeterminate state. An indeterminate check box has a dimmed background to represent an indeterminate state.

Syntax

HRESULT put_indeterminate(
    VARIANT_BOOL v 
);

Parameters

v
VARIANT Boolean structure that specifies the value of the indeterminate flag to set. If VARIANT_TRUE, the INPUT element of type=checkbox is indeterminate. The default value is VARIANT_FALSE.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

When indeterminate is set, the INPUT type=checkbox element appears checked, but dimmed. The value of indeterminate is independent of the values for the checked and status properties.

This does not change whether the INPUT type=checkbox element is marked as checked and is different than disabling the control. A check box in the indeterminate state can still receive the focus. When the user clicks an indeterminate button, the indeterminate state is turned off and the INPUT type=checkbox element is appropriately checked or unchecked.