RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TXMLDocument.Active Property

Specifies whether the XML document has been parsed so that the DOM interfaces are available to examine or change its contents.

Pascal
property Active: Boolean;
C++
__property Boolean Active;

Before you can use TXMLDocument to examine or change the contents of an XML document, it must be active. Setting Active to true causes TXMLDocument to do the following: 

1.Generate a BeforeOpen event. 

2.If necessary, load the DOM parser and assign the DOMImplementation property. 

3.Parse the XML document specified by FileName or, if FileName is an empty string, by the XML property using the options specified by ParseOptions. If both FileName and XML are empty strings, TXMLDocument creates an empty document. The interface for the parsed document is assigned to the DOMDocument property. 

 

  1. Generate an AfterOpen event.
    Note: Once the DOMDocument property is assigned, you can also use the DocumentElement property.
    Setting Active to false causes TXMLDocument to do the following: 

1.Generate a BeforeClose event. 

2.Release all of the DOM interfaces, such as DOMDocument and DocumentElement, that represent the parsed XML document. 

 

  1. Generate an AfterClose event.

 

Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!