IHTMLFrameBase2::readyState Property
Retrieves a value that indicates the current state of the object.
Syntax
HRESULTÂ IHTMLFrameBase2::get_readyState(BSTRÂ *p);
Parameters
- p
Pointer to a variable of type BSTR that receives one of the values listed in Possible Values.
Possible Values
uninitialized Object is not initialized with data. loading Object is loading its data. loaded Object has finished loading its data. interactive User can interact with the object even though it is not fully loaded. complete Object is completely initialized.
Return Value
Returns S_OK if successful, or an error value otherwise.
Remarks
An object's state is initially set to
uninitialized
, and then toloading
. When data loading is complete, the state of the link object passes through theloaded
andinteractive
states to reach thecomplete
state.The states through which an object passes are determined by that object; an object can skip certain states (for example,
interactive
) if the state does not apply to that object.Data source objects and databound elements are normally populated asynchronously, and certain programmatic operations can only be performed reliably on databound objects when they are ready for use. Therefore, the appropriate code should be written to confirm the IHTMLFrameBase2::readyState of objects prior to performing certain operations on them. For example, walking the rows of a table should not be attempted until after the table has reached the
complete
state.The IHTMLFrameBase2::readyState property enables the status of an object to be tested. The correct place to test the IHTMLFrameBase2::readyState property is in the event handler for onreadystatechange. Similarly, a data source object (DSO) fires the ondatasetcomplete event to notify the document that the dataset is ready for programmatic operation.
See Also