Aspose.Words Document Object Model (DOM)

На Aspose.Words Document Object Model (DOM) е в памет представяне на документ Word. На Aspose.Words DOM ви позволява да програмно четене, манипулация и промяна на съдържанието и форматиране на Word документ.

Този раздел описва основните класове на Aspose.Words DOM и техните връзки. С помощта на Aspose.Words DOM класове, можете да получите програмен достъп до документи елементи и форматиране.

Създаване на `Document` Дърво на обекти

Когато документ се чете в Aspose.Words DOM тогава е построен обект дърво и различни видове елементи на източника документ имат своя собствена DOM дървесни обекти с различни свойства.

Изграждане на документни възли Дърво

Кога Aspose.Words чете документ на Word в паметта, създава обекти от различни типове, които представляват различни елементи на документа. Всеки запис на текст, параграф, таблица или раздел е възел и дори самият документ е възел. Aspose.Words определя клас за всеки тип документен възел.

Дървото на документа в Aspose.Words Следва модела Composite Design:

Всички класове възел в крайна сметка произтичат от Node клас, който е базовият клас в Aspose.Words Document Object Model.
Възли, които могат да съдържат други възли, например, Section или Paragraph, ен CompositeNode клас, който от своя страна произтича от Node Клас.

На диаграмата по-долу е показано наследството между класовете възли на Aspose.Words Document Object Model (DOM). Имената на абстрактните класове са в Италия.

На Aspose.Words DOM също така съдържа несвързващите класове, като Style или Font, които се използват за персонализиране на външния вид и стиловете в документ. Тези класове не са показани в тази диаграма, тъй като не са наследени от Node Клас.

Нека да разгледаме един пример. Следното изображение показва a Microsoft Word документ с различни видове съдържание.

При четене на горния документ в Aspose.Words DOM, дървото на обектите е създадено, както е показано в схемата по-долу.

Document, Section, Paragraph, Table, Shape, Run, и всички други елипси на диаграмата са Aspose.Words обекти, които представляват елементи от документа Word.

Вземи `Node` Тип

Въпреки че Node Класът е достатъчен, за да различава различни възли един от друг, Aspose.Words осигурява NodeType изброяване за опростяване на някои API задачи, като например избор на възли от определен тип.

Видът на всеки възел може да бъде получен с помощта на Node.node_type собственост. Този имот връща a NodeType стойност на изброяването. Например, параграф възел, представен от Paragraph Връщане на класа NodeType.PARAGRAPH, и възел на масата, представен от Table Връщане на класа NodeType.TABLE.

Следният пример показва как да получите тип възел с помощта на NodeType Изброяване:

Aspose.Words представлява документ като дърво възел, който ви позволява да се движите между възлите. Този раздел описва как да изследвате и навигирате дървото на документа в Aspose.Words.

Когато отворите примерния документ, представен по-рано, в документ Explorer, дървото се появява точно както е представен в Aspose.Words.

Можете да научите примерния проект “Документ Експлорър” на Aspose.Words GitHub.

Връзки с възлите на документа

Възлите на дървото имат връзки между тях:

Възел, съдържащ друг възел е parent.
Възелът, който се съдържа в родителския възел е child. Детските възли на същия родител са sibling Възли.
На root Възелът винаги е Document Възел.

Възлите, които могат да съдържат други възли, произлизат от CompositeNode класа, и всички възли в крайна сметка произтичат от Node Клас. Тези два основни класа осигуряват общи методи и свойства за навигация и модификация на структурата на дървото.

Следната диаграма UML обект показва няколко възли на извадка документ и техните отношения един с друг чрез родител, дете, и брат свойства:

document-nodes-relationships-aspose-words

Документът е собственик на възел

Възелът винаги принадлежи към конкретен документ, дори ако е създаден или отстранен от дървото, тъй като жизненоважни структури като стилове и списъци се съхраняват в Document Възел. Например, не е възможно да имате Paragraph без Document защото всеки параграф има определен стил, който се определя глобално за документа. Това правило се използва при създаване на нови възли. Добавяне на нов Paragraph директно към DOM изисква документен обект, предаден на конструктора.

На Node.document Имотът връща документа, към който принадлежи възелът.

При създаване на нов параграф, използващ DocumentBuilder, Строителят винаги има Document клас, свързан с него чрез DocumentBuilder.document собственост.

Следният пример за код показва, че при създаването на какъвто и да е възел винаги се определя документ, който ще притежава възела:

Родителски възел

Всеки възел има майка, посочена от parent_node собственост. Възелът няма родителски възел. parent_node е None, в следните случаи:

Възелът току-що беше създаден и все още не е добавен към дървото.
Възелът е изваден от дървото.
Това е коренът. Document Възел, който винаги е без родителски възел.

Можете да премахнете възел от неговия родител като се обадите на Node.remove метод. Следният пример с код показва как да се влезе в базовия възел:

Детски възли

Най-ефективният начин за достъп до детски възли на CompositeNode е през first_child както и last_child свойства, които връщат съответно първите и последните детски възли. Ако няма детски възли, тези свойства се връщат None.

CompositeNode и осигурява get_child_nodes събиране, позволяващо индексиран или изброен достъп до детските възли. На get_child_nodes метод връща жива колекция от възли, което означава, че когато документът се променя, като например когато възлите се отстраняват или добавят, get_child_nodes събирането се актуализира автоматично.

Ако възелът няма дете, тогава get_child_nodes метод връща празна колекция. Можете да проверите дали CompositeNode съдържа всякакви детски възли с помощта на has_child_nodes собственост.

Следният пример с код показва как да се изброят незабавните детски възли на a CompositeNode използване на числителя, предоставен от get_child_nodes събиране:

Родови възли

Можете да получите възела, който непосредствено предхожда или следва определен възел с помощта на previous_sibling както и next_sibling свойства, съответно. Ако възелът е последното дете на своя родител, тогава next_sibling собствеността е None. Обратно, ако възелът е първото дете на неговия родител, previous_sibling собствеността е None.

Следният пример за код показва как ефективно да посетите всички преки и непреки детски възли на композитен възел:

Напечатан достъп до възли за деца и родители

Досега сме обсъждали свойствата, които връщат един от базовите типове. Node или CompositeNode. Но понякога има ситуации, в които може да се наложи да се хвърлят стойности към определен клас възел, като Run или Paragraph. Това означава, че не можете напълно да се измъкнете от кастинга, когато работите с Aspose.Words DOM, което е съставно.

За да се намали необходимостта от кастинг, повечето Aspose.Words класовете осигуряват свойства и колекции, които осигуряват силно напечатан достъп. Има три основни модела на типов достъп:

Родителски възел напечатан Първо_XXX както и last_XXX имоти. Например, Document е first_section както и last_section имоти. По същия начин, Table има свойства като first_row, last_row, и други.
Родителски възел разкрива напечатана колекция от детски възли, като Document.sections, Body.paragraphs, и други.
Детски възел осигурява достъп до родителите си, като Run.parent_paragraph, Paragraph.parent_section, и други.

Типираните свойства са просто полезни преки пътища, които понякога осигуряват по-лесен достъп от общите свойства, наследени от Node.parent_node както и CompositeNode.first_child.

Следният пример за код показва как да се използват типирани свойства за достъп до възлите на дървото на документа:

Превод Markdown до DOM