IHTMLButtonElement::name Property

Gets or sets the name of the object.


HRESULT IHTMLButtonElement::get_name(BSTR *p);HRESULT IHTMLButtonElement::put_name(BSTR v);


Pointer to a variable of type BSTR that receives the name.
BSTR that specifies the name.

Return Value

Returns S_OK if successful, or an error value otherwise.


When you submit a form, use the IHTMLButtonElement::name property to bind the value of the control.

The name is not the value that is displayed for the input type=button, input type=reset, and input type=submit input types. The internally stored value is submitted with the form, not the displayed value.

Windows Internet Explorer 8 and later. In IE8 Standards mode, dynamically setting the IHTMLButtonElement::name attribute on an input type=radio button correctly applies that button to the same named group. For more information about IE8 mode, see Defining Document Compatibility.

In Internet Explorer 8 and later versions, you can set the NAME attribute at run time on elements that are dynamically created with the IHTMLDocument2::createElement method. To create an element with a NAME attribute in earlier versions of Internet Explorer, include the attribute and its value when you use the IHTMLDocument2::createElement method.

In Microsoft Internet Explorer 6 and later versions, this property applies to the attribute object.