onreadystatechange Property (DOMDocument)

Script Syntax

oXMLDOMDocument.onreadystatechange = funcMyEventHandler;
objXMLDOMDocument.onreadystatechange = value;

Example

The following script example specifies the handler CheckState gets called when the readyState property changes.

<script>
var xmldoc;
function Load(){
  xmldoc = new ActiveXObject("Msxml2.DOMDocument.4.0");
  xmldoc.onreadystatechange = CheckState;
  xmldoc.load(URL.value);
if (xmlDoc.parseError.errorCode <> 0) {
   var myErr = xmlDoc.parseError;
   alert("You have error " + myErr.reason);
}
}
function CheckState(){
  var state = xmldoc.readyState;
  RESULTS.innerHTML += "readyState = " + state + "<BR>"
  if (state == 4){
    var err = xmldoc.parseError;
    if (err.errorCode != 0)
      RESULTS.innerHTML += err.reason +  "<BR>"
    else RESULTS.innerHTML += "Success" +  "<BR>"
  } 
} 
</script>
URL: <input type=text size=60 id=URL><input type=button value=LOAD onclick=jscript:Load()>
<div id=RESULTS style="color:red; font-weight:bold;"></div></script> 

In Microsoft® Visual Basic® Scripting Edition (VBScript), you can get a function pointer using the syntax getRef("HandleStateChange").

Visual Basic Syntax

Private WithEvents XmlDoc As Msxml2.DOMDocument
Private Sub XmlDoc_onreadystatechange()

Example

The following Microsoft Visual Basic example specifies the handler CheckState gets called when the readyState property changes.

Private WithEvents XmlDoc As Msxml2.DOMDocument40
Private Sub cmdEvents_Click()
    Set XmlDoc = New Msxml2.DOMDocument40
    XmlDoc.Load "books.xml"
If (xmlDoc.parseError.errorCode <> 0) Then
   Dim myErr
   Set myErr = xmlDoc.parseError
   MsgBox("You have error " & myErr.reason)
End If
End Sub
Private Sub XmlDoc_onreadystatechange()
    MsgBox "onreadystatechange: " & XmlDoc.readyState
End Sub 

C/C++ Syntax

HRESULT put_onreadystatechange(
    VARIANT readystatechangeSink);

Parameters

readystatechangeSink [in]

Name of the function that should be called when the readyState property value changes.

C/C++ Return Values

S_OK

Value returned if successful.