AutoCompleteSaveForm method

Saves the specified form in the AutoComplete data store.


var retval = external.AutoCompleteSaveForm(Form);


  • Form [in]
    Type: VARIANT

    Variant of type Object that specifies a reference to a form element.

Return value


If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.


Use this method to store input type=text and input type=password values to AutoComplete data storage. After information is entered in a form and saved to AutoComplete storage, whenever a user visits a Web site and starts typing in a field with the same name as a stored field, the AUTOCOMPLETE attribute provides an AutoComplete box containing a list of previously stored data.

To enable the AutoComplete feature for forms, choose Internet Options from the Tools menu, click Content, and then click AutoComplete. To disable the feature for individual form controls and entire forms, use the AUTOCOMPLETE attribute.

This method is included in Microsoft Internet Explorer 5 and later. It is not supported in HTML Applications (HTAs).


This example uses the AutoCompleteSaveForm method to save the value of a text field without submitting the form to a server.

Code example:

function fnSaveForm(){
<FORM NAME="oForm">

This text is saved:
<INPUT TYPE="text" NAME="AutoCompleteTest">

This text is not saved:
<INPUT TYPE="text" NAME="AutoCompleteIgnore" AUTOCOMPLETE="off">

<INPUT TYPE=button VALUE="Save Value" onclick="fnSaveForm()">

See also


Using AutoComplete in HTML Forms