Click to return to the Reusing Browser Technology home page    
IHTMLOptionButtonElement:...     IHTMLOptionButtonElement:...     IHTMLOptionButtonElement ...    
Web Workshop  |  Reusing Browser Technology

IHTMLOptionButtonElement::get_indeterminate Method


Retrieves the value that indicates whether the check box is in the 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. For details, see the indeterminate property.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

An indeterminate check box has a dimmed background to represent an indeterminate state.

When indeterminate is set, the check box 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 check box 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 check box is appropriately checked or unchecked.

Windows CE

Windows CE Use version 2.12 and later
Minimum availability Internet Explorer 4.0

IHTMLOptionButtonElement::put_indeterminate Method


Sets the value that indicates whether the check box is in the indeterminate state.

Syntax

HRESULT put_indeterminate(
    VARIANT_BOOL v 
);

Parameters

v
VARIANT Boolean structure that specifies the indeterminate flag to set. If VARIANT_TRUE, the check box is indeterminate. The default value is VARIANT_FALSE. For details, see the indeterminate property.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

An indeterminate check box has a dimmed background to represent an indeterminate state.

When indeterminate is set, the check box 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 check box 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 check box is appropriately checked or unchecked.

Windows CE

Windows CE Use version 2.12 and later
Minimum availability Internet Explorer 4.0


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? Write us!

© 1999 Microsoft Corporation. All rights reserved. Terms of use.