Syntax

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

Procedure

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.
  ...
END PROCEDURE.

Method

METHOD PUBLIC VOID StartElement(INPUT namespaceURI AS CHARACTER,
                                INPUT localName    AS CHARACTER,
                                INPUT qName        AS CHARACTER,
                                INPUT attributes   AS HANDLE): 
  ... 
END METHOD.
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 the AVM is deleted by the AVM.

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