ITreeWalker

ITreeWalker interface

TreeWalker nesneleri, whatToShow bayrakları ve filtresi (varsa) tarafından tanımlanan belgenin görünümünü kullanarak bir belge ağacında veya alt ağacında gezinmek için kullanılır. ’nin bir TreeWalker kullanarak gezinme gerçekleştiren herhangi bir işlev, otomatik olarak bir TreeWalker tarafından tanımlanan herhangi bir görünümü destekleyecektir.

Bir alt ağacın mantıksal görünümünden düğümleri çıkarmak, tamamlanmış, filtrelenmemiş belgedeki aynı alt ağaçtan önemli ölçüde farklı bir yapısıyla sonuçlanabilir. TreeWalker görünümünde kardeş olan düğümler, orijinal görünümde farklı, geniş ölçüde ayrılmış düğümlerin çocukları olabilir. Örneğin, Metin düğümleri ve bir belgenin kök düğümü dışındaki tüm düğümleri atlayan bir NodeFilter düşünün. Ortaya çıkan mantıksal görünümde, tüm metin düğümleri kardeş olacak ve kök düğümün doğrudan çocukları olarak görünecek, orijinal belgenin yapısı ne kadar iç içe geçmiş olursa olsun.

Ayrıca bkz.Belge nesnesi Modeli (DOM) Düzey 2 Geçiş ve Aralık Belirtimi. @since DOM Düzey 2

public interface ITreeWalker : ITraversal

Özellikleri

İsimTanım
CurrentNode { get; set; }TreeWalker’ın şu anda konumlandığı düğüm. DOM ağacında yapılan değişiklikler, geçerli düğümün artık TreeWalker’ın ilişkili filtresi tarafından kabul edilmemesine neden olabilir. currentNode ayrıca, olsun veya olmasın herhangi bir düğüme açıkça ayarlanabilir. the kök düğümü tarafından belirtilen alt ağaç içinde veya filtre ve whatToShow bayrakları tarafından kabul edilir. Geçerli görünümün bir parçası olmasa bile currentNode’a göre daha fazla geçiş gerçekleşir, filtreleri istenen yönde uygulayarak; traversal mümkün değilse, currentNode değiştirilmez.

yöntemler

İsimTanım
FirstChild()TreeWalker’ı geçerli düğümün ilk görünür alt öğesine taşır ve yeni düğümü döndürür. Geçerli düğümün görünür hiçbir alt öğesi yoksa, null değerini döndürür ve current düğümünü korur.
LastChild()TreeWalker’ı geçerli düğümün son görünen alt öğesine taşır ve yeni düğümü döndürür. Geçerli düğümün görünür hiçbir alt öğesi yoksa, null değerini döndürür ve current düğümünü korur.
NextNode()TreeWalker’ı geçerli düğüme göre document sırasındaki bir sonraki görünür düğüme taşır ve yeni düğümü döndürür. Geçerli düğümde bir sonraki düğüm yoksa veya nextNode araması, TreeWalker’ın root düğümünden yukarı çıkmaya çalışırsa, null değerini döndürür ve geçerli düğümü korur.
NextSibling()TreeWalker’ı mevcut düğümünün bir sonraki kardeşine taşır ve yeni düğümü döndürür. Geçerli düğümün bir sonraki kardeşi yoksa, null değerini döndürür ve geçerli düğümü korur.
ParentNode()Current düğümünün en yakın görünür üst düğümüne gider ve onu döndürür. parentNode araması TreeWalker’ın kök düğümünden yukarı adım veya görünür bir üst düğüm bulamazsa girişiminde bulunursa, bu yöntem geçerli konumunu korur ve null. değerini döndürür.
PreviousNode()TreeWalker’ı, geçerli düğüme göre belge sırasındaki önceki görünür düğüme taşır ve new düğümünü döndürür. Geçerli düğümün önceki bir düğümü yoksa veya önceki Düğüm araması, the TreeWalker’ın kök düğümünden yukarı çıkmaya çalışırsa, null değerini döndürür ve geçerli düğümü korur.
PreviousSibling()TreeWalker’ı mevcut düğümünün önceki kardeşine taşır ve yeni düğümü döndürür. Geçerli düğümde görünür bir önceki kardeş yok varsa, null değerini döndürür ve geçerli düğümünü korur.

Ayrıca bakınız

ITraversal