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
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