00001 /* 00002 * The Apache Software License, Version 1.1 00003 * 00004 * Copyright (c) 1999-2002 The Apache Software Foundation. All rights 00005 * reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions 00009 * are met: 00010 * 00011 * 1. Redistributions of source code must retain the above copyright 00012 * notice, this list of conditions and the following disclaimer. 00013 * 00014 * 2. Redistributions in binary form must reproduce the above copyright 00015 * notice, this list of conditions and the following disclaimer in 00016 * the documentation and/or other materials provided with the 00017 * distribution. 00018 * 00019 * 3. The end-user documentation included with the redistribution, 00020 * if any, must include the following acknowledgment: 00021 * "This product includes software developed by the 00022 * Apache Software Foundation (http://www.apache.org/)." 00023 * Alternately, this acknowledgment may appear in the software itself, 00024 * if and wherever such third-party acknowledgments normally appear. 00025 * 00026 * 4. The names "Xerces" and "Apache Software Foundation" must 00027 * not be used to endorse or promote products derived from this 00028 * software without prior written permission. For written 00029 * permission, please contact apache\@apache.org. 00030 * 00031 * 5. Products derived from this software may not be called "Apache", 00032 * nor may "Apache" appear in their name, without prior written 00033 * permission of the Apache Software Foundation. 00034 * 00035 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED 00036 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 00037 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00038 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR 00039 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00040 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00041 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 00042 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 00043 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00044 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 00045 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 00046 * SUCH DAMAGE. 00047 * ==================================================================== 00048 * 00049 * This software consists of voluntary contributions made by many 00050 * individuals on behalf of the Apache Software Foundation, and was 00051 * originally based on software copyright (c) 1999, International 00052 * Business Machines, Inc., http://www.ibm.com . For more information 00053 * on the Apache Software Foundation, please see 00054 * <http://www.apache.org/>. 00055 */ 00056 00057 /* 00058 * $Log: DOM_NodeFilter.hpp,v $ 00059 * Revision 1.1 2002/05/11 19:50:56 bhavani 00060 * CR#CR062582# adding xercesc 1.7 file 00061 * 00062 * Revision 1.2 2002/02/04 19:57:15 tng 00063 * Remove the phrase "Experimental". 00064 * 00065 * Revision 1.1.1.1 2002/02/01 22:21:46 peiyongz 00066 * sane_include 00067 * 00068 * Revision 1.10 2000/10/20 22:03:04 andyh 00069 * DOM NodeFileter - define values for FilterAction enum to match those in the DOM spec. 00070 * 00071 * Revision 1.9 2000/05/11 00:07:38 abagchi 00072 * Removed tables. It was confusing doxygen 00073 * 00074 * Revision 1.8 2000/03/11 03:19:13 chchou 00075 * Fix bug # 19, add const keyword to API 00076 * 00077 * Revision 1.7 2000/02/24 20:11:28 abagchi 00078 * Swat for removing Log from API docs 00079 * 00080 * Revision 1.6 2000/02/17 17:47:25 andyh 00081 * Update Doc++ API comments 00082 * NameSpace update to track W3C 00083 * Changes were made by Chih Hsiang Chou 00084 * 00085 * Revision 1.5 2000/02/15 23:17:37 andyh 00086 * Update Doc++ API comments 00087 * NameSpace bugfix and update to track W3C 00088 * Chih Hsiang Chou 00089 * 00090 * Revision 1.4 2000/02/10 21:47:12 abagchi 00091 * Added API docs 00092 * 00093 * Revision 1.3 2000/02/06 07:47:30 rahulj 00094 * Year 2K copyright swat. 00095 * 00096 * Revision 1.2 2000/02/04 01:49:28 aruna1 00097 * TreeWalker and NodeIterator changes 00098 * 00099 * Revision 1.1.1.1 1999/11/09 01:09:00 twl 00100 * Initial checkin 00101 * 00102 * Revision 1.2 1999/11/08 20:44:19 rahul 00103 * Swat for adding in Product name and CVS comment log variable. 00104 * 00105 */ 00106 00107 // DOM_NodeFilter.h: interface for the DOM_NodeFilter class. 00108 // 00110 00111 #ifndef DOM_NodeFilter_HEADER_GUARD_ 00112 #define DOM_NodeFilter_HEADER_GUARD_ 00113 00114 #include "DOM_Node.hpp" 00115 00116 class NodeFilterImpl; 00117 00118 00138 class CDOM_EXPORT DOM_NodeFilter 00139 { 00140 public: 00143 /* 00144 * <table><tr><td>FILTER_ACCEPT</td> 00145 * <td>Accept the node. Navigation methods defined for 00146 * NodeIterator or TreeWalker will return this node.</td> 00147 * </tr> 00148 * <tr><td> 00149 * FILTER_REJECT</td> 00150 * <td>Reject the node. Navigation methods defined for 00151 * NodeIterator or TreeWalker will not return this 00152 * node. For TreeWalker, the children of this node will 00153 * also be rejected. Iterators treat this as a synonym 00154 * for FILTER_SKIP.</td> 00155 * </tr> 00156 * <tr><td>FILTER_SKIP</td> 00157 * <td>Reject the node. Navigation methods defined for 00158 * NodeIterator or TreeWalker will not return this 00159 * node. For both NodeIterator and Treewalker, the 00160 * children of this node will still be considered.</td> 00161 * </tr> 00162 * </table> 00163 * 00164 */ 00165 enum FilterAction {FILTER_ACCEPT = 1, 00166 FILTER_REJECT = 2, 00167 FILTER_SKIP = 3}; 00168 00169 enum ShowType { 00170 SHOW_ALL = 0x0000FFFF, 00171 SHOW_ELEMENT = 0x00000001, 00172 SHOW_ATTRIBUTE = 0x00000002, 00173 SHOW_TEXT = 0x00000004, 00174 SHOW_CDATA_SECTION = 0x00000008, 00175 SHOW_ENTITY_REFERENCE = 0x00000010, 00176 SHOW_ENTITY = 0x00000020, 00177 SHOW_PROCESSING_INSTRUCTION = 0x00000040, 00178 SHOW_COMMENT = 0x00000080, 00179 SHOW_DOCUMENT = 0x00000100, 00180 SHOW_DOCUMENT_TYPE = 0x00000200, 00181 SHOW_DOCUMENT_FRAGMENT = 0x00000400, 00182 SHOW_NOTATION = 0x00000800 00183 }; 00185 00191 DOM_NodeFilter(); 00193 00199 virtual ~DOM_NodeFilter(); 00201 00213 virtual short acceptNode (const DOM_Node &node) const =0; 00215 00216 private: 00217 DOM_NodeFilter(const DOM_NodeFilter &other); 00218 DOM_NodeFilter & operator = (const DOM_NodeFilter &other); 00219 bool operator == (const DOM_NodeFilter &other) const; 00220 bool operator != (const DOM_NodeFilter &other) const; 00221 }; 00222 00223 #endif