All Frameworks  Class Hierarchy  This Framework  Previous  Next  Indexes

XMLParser Interface CATIDOMEntityReference

System.IUnknown
  |
  +---System.IDispatch
    |
    +---System.CATBaseUnknown
      |
      +---XMLParser.CATIDOMNode
        |
        +---CATIDOMEntityReference
 

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.


interface CATIDOMEntityReference

Interface for object which may be inserted into the structure model when an entity reference is in the source document, or when the user wishes to insert an entity reference.
Note that character references and references to predefined entities are considered to be expanded by the HTML or XML processor so that characters are represented by their Unicode equivalent rather than by an entity reference. Moreover, the XML processor may completely expand references to entities while building the structure model, instead of providing CATIDOMEntityReference objects. If it does provide such objects, then for a given CATIDOMEntityReference node, it may be that there is no CATIDOMEntity node representing the referenced entity. If such an CATIDOMEntity exists, then the subtree of the CATIDOMEntityReference node is in general a copy of the CATIDOMEntity node subtree. However, this may not be true when an entity contains an unbound namespace prefix. In such a case, because the namespace prefix resolution depends on where the entity reference is, the descendants of the CATIDOMEntityReference node may be bound to different namespace URIs.

As for CATIDOMEntity nodes, CATIDOMEntityReference nodes and all their descendants are readonly.

See also the Document Object Model (DOM) Level 2 Core Specification.



This object is included in the file: CATIDOMEntityReference.h
If needed, your Imakefile.mk should include the module: CATXMLParserItf

Copyright © 2003, Dassault Systèmes. All rights reserved.