Progress
External Program
Interfaces


StartElement

Invoked when the XML parser detects the beginning of an element.

SYNTAX
PROCEDURE StartElement:
  DEFINE INPUT PARAMETER namespaceURI AS CHARACTER. 
  DEFINE INPUT PARAMETER localName    AS CHARACTER. 
  DEFINE INPUT PARAMETER qName        AS CHARACTER. 
  DEFINE INPUT PARAMETER attributes   AS HANDLE. 

namespaceURI

A character string indicating the namespace URI of the element.

If namespace processing is not enabled or the element is not part of a namespace, the string is of length zero.

localName

A character string indicating the non-prefixed element name.

If namespace processing is not enabled, the string is of length zero.

qName

A character string indicating the actual name of the element in the XML source.

If the name has a prefix, qName includes it, whether or not namespace processing is enabled.

attributes

A handle to a SAX-ATTRIBUTES object, which provides access to all attributes specified for the element.

If the element has no attributes, attributes is still a valid handle, and the NUM-ITEMS attribute is zero.

For every invocation of StartElement, there is a corresponding invocation of EndElement.

The contents of the element are reported in sequential order before the corresponding EndElement is invoked.

When StartElement returns, the SAX-ATTRIBUTES object, which was created by Progress, is deleted by Progress.

NOTE: If the application deletes it first, however, no harm is done.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095