ickXMLp Component

The ickXMLp component implements a lexical XML parser for manipulating XML (and/or HTML) documents. (NOTE: The following is a very short description. For more information, please consult the help files that come with the respective package.)

The ickXMLp component parses XML documents. XML (Extensible Markup Language) is becoming a standard for exchanging any type of information. You can get more information about XML at the World Wide Web Consortium under http://www.w3.org .

The component takes pieces of XML code through the InputText property, until Reset is set to true, parses it and fires events like BeginElement, EndElement, Text, Meta, PI, etc. The user can evaluate entities inside the EvalEntity event.

The attributes can be accessed through the AttrCount, AttrName, and AttrValue properties during the BeginElement and EndElement events.

You can control the firing of events through the FlushOnEOL and especially the Reset properties. The PreserveWhiteSpace, ExtraNameChars, and ExtraSpaceChars properties control how names and white spaces are handled.

PROPERTIES

AttrCount. Size of attribute values array for the current element.

AttrName. Array of attribute names for the current element.

AttrValue. Array of attribute values for the current element.

ExtraNameChars. Extra characters for the parser to consider as name characters.

ExtraSpaceChars. Extra characters for the parser to consider as white space.

FlushOnEOL. If set, the parser flushes its text buffer after every line of text.

InputText. Provides text input to the parser. Write-only property.

PreserveWhiteSpace. Controls how the parser treats white space.

Reset. When set, the parser initializes itself to its default state.

EVENTS

BeginElement. Fired when a begin-element tag is encountered in the document.

Comment. Fired when a comment section is encountered.

EndElement. Fired when an end-element tag is encountered.

EmptyElement. Fired when an empty element is encountered in the document.

EvalEntity. Fired every time an entity needs to be evaluated.

Meta. Fired when a meta section is encountered.

PI. Fired when a processing instruction section is encountered.

SpecialSection. Fired when a special section is encountered.

Text. Fired for plain text segments of the input stream.