IHTMLOptionButtonElement::disabled Property

Sets or retrieves a value that indicates whether the user can interact with the object.


HRESULT IHTMLOptionButtonElement::get_disabled(VARIANT_BOOL *p);
HRESULT IHTMLOptionButtonElement::put_disabled(VARIANT_BOOL v);


  • p
    Pointer to a variable of type VARIANT_BOOL that receives one of the values listed in Possible Values.
  • v
    VARIANT_BOOL that specifies one of the values listed in Possible Values.

Possible Values

VARIANT_FALSE Default. Element is not disabled.
VARIANT_TRUE Element is disabled.

Return Value

Returns S_OK if successful, or an error value otherwise.


When an element is disabled, it appears dimmed and does not respond to user input. Disabled elements do not respond to mouse events, nor will they respond to the IHTMLElement3::contentEditable property.

If an element's IHTMLOptionButtonElement::disabled property is set to false but it is contained within a IHTMLOptionButtonElement::disabled element, it cannot override the IHTMLOptionButtonElement::disabled state of its container.

For link, style and styleSheet, the attribute sets or retrieves whether a style sheet is applied to the object .

Note  For OPTGROUP and OPTION, the functionality specified by the HTML 4.01 standard is not currently implemented. You can define your own functionality.

See Also