Interface INodeIterator

INodeIterator interface

يتم استخدام التكرارات للدخول إلى مجموعة من العقد ، على سبيل المثال مجموعة العقد في NodeList ، أو الشجرة الفرعية للمستند التي تحكمها عقدة معينة ، أو نتائج استعلام ، أو أي مجموعة أخرى من العقد. يتم تحديد مجموعة العقد المراد تكرارها من خلال تنفيذ لـ NodeIterator. يحدد DOM المستوى 2 تنفيذ NodeIterator الفردي لأمر المستندات اجتياز الشجرة الفرعية للمستند. يتم إنشاء مثيلات هذه التكرارات عن طريق استدعاء DocumentTraversal .createNodeIterator () .

انظر أيضانموذج كائن المستند (DOM) المستوى 2 الاجتياز وتحديد النطاق. @ منذ DOM المستوى 2

public interface INodeIterator : ITraversal

الخصائص

اسموصف
PointerBeforeReferenceNode { get; }تحدد قيمة هذه العلامة ما إذا كانت العناصر الفرعية للعقد المرجعية للكيان مرئية للمكرر. إذا كانت خاطئة ، فسيتم رفضهم and أحفادهم. لاحظ أن هذا الرفض يأخذ الأسبقية على whatToShow والمرشح. لاحظ أيضًا أن هذا هو الموقف الوحيد حاليًا حيث قد ترفض NodeIterators شجرة فرعية كاملة بدلاً من تخطي العقد الفردية. قم بإخفاء مرجع الكيان node وقم بتعيين expandEntityReferences إلى true عند إنشاء the iterator. لإنتاج طريقة عرض للمستند تحتوي على عقد كيان ولكن بدون توسيع كيان ، استخدم whatToShow flags لإظهار عقدة مرجع الكيان و set expandEntityReferences to false .
ReferenceNode { get; }العقدة المرجعية الحالية .

طُرق

اسموصف
Detach()يفصل NodeIterator عن المجموعة التي تكررت مرة أخرى ، وإطلاق أي موارد حسابية ووضع مكرر في حالة INVALID. بعد استدعاء الفصل ، المكالمات إلى nextNode أو العقدة السابقة will سترفع الاستثناء INVALID_STATE_ERR.
NextNode()تُرجع العقدة التالية في المجموعة وتقدم موضع مكرر في المجموعة. بعد إنشاء NodeIterator ، تُرجع المكالمة الأولى لـ nextNode () العقدة الأولى in المجموعة.
PreviousNode()إرجاع العقدة السابقة في المجموعة ونقل موضع NodeIterator للخلف في المجموعة.

أنظر أيضا