Práce s komentáři

Aspose.Words umožňuje uživatelům pracovat s komentáři v dokumentu Aspose.Words jsou zastoupeny Comment třída. Také použijte CommentRangeStart a CommentRangeEnd tříd pro upřesnění oblasti textu, která by měla být spojena s poznámkou.

Přidat komentář

Aspose.Words umožňuje přidat komentáře několika způsoby:

  1. Použití Comment třída
  2. Použití CommentRangeStart a CommentRangeEnd třídy

Následující příklad kódu ukazuje, jak přidat komentář k odstavci pomocí Comment třída:

Následující příklad kódu ukazuje, jak přidat komentář k odstavci pomocí oblasti textu a CommentRangeStart a CommentRangeEnd třídy:

Extrahovat nebo odstranit komentáře

Použití komentářů v dokumentu Word (kromě změn stopy) je běžnou praxí při přezkumu dokumentů, zejména pokud existuje více recenzentů. Mohou nastat situace, kdy jediné, co potřebujete z dokumentu, jsou komentáře. Řekněte, že chcete vytvořit seznam zjištění přezkumu, nebo jste možná shromáždili všechny užitečné informace z dokumentu a chcete jednoduše odstranit zbytečné komentáře. Můžete chtít zobrazit nebo odstranit připomínky konkrétního recenzenta.

V tomto vzorku se podíváme na některé jednoduché metody shromažďování informací z komentářů v dokumentu a na odstranění připomínek z dokumentu. Konkrétně se postaráme o to, jak:

  • Vyjádřit všechny připomínky z dokumentu nebo pouze ty, které učinil konkrétní autor.
  • Odstraňte všechny připomínky z dokumentu nebo pouze od konkrétního autora.

Jak extrahovat nebo odstranit komentáře

Kód v tomto vzorku je vlastně docela jednoduchý a všechny metody jsou založeny na stejném přístupu. Komentář v dokumentu Word představuje Comment objekt v Aspose.Words model objektu dokumentu. Pro sběr všech připomínek v dokumentu použijte get_child_nodes metoda s prvním parametrem nastaveným na NodeType.COMMENT. Ujistěte se, že druhý parametr get_child_nodes metoda je nastavena na true: to nutí get_child_nodes vybrat ze všech dětských uzlů rekurzivně, spíše než pouze sbírat okamžité děti.

Abychom ukázali, jak získat a odstranit připomínky z dokumentu, projdeme těmito kroky:

  1. Otevřít dokument Word pomocí Document třída
  2. Získat všechny připomínky z dokumentu do sbírky
  3. Chcete-li získat připomínky:
    1. Projděte sbírku pomocí každého provozovatele
    2. Výpis a výpis autora jméno, datum a čas a text všech komentářů
    3. Výpis a výpis jména autora, datum a čas a text komentářů napsaných konkrétním autorem, v tomto případě autora
  4. Odstranit komentáře:
    1. Přejít zpět přes sbírku pomocí pro operátora
    2. Odstranit připomínky
  5. Uložit změny

Jak extrahovat všechny komentáře

• get_child_nodes metoda je velmi užitečná a můžete ji použít pokaždé, když potřebujete získat seznam dokumentových uzlů jakéhokoli typu. Výsledný sběr nevytváří bezprostřední nadmořskou moc, protože uzly jsou vybrány do této sbírky pouze tehdy, když v ní vyjmenováváte nebo získáte přístupové položky.

Následující příklad kódu ukazuje, jak extrahovat jméno autora, datum a čas a text všech komentářů v dokumentu:

Jak získat připomínky určitého autora

Po výběru Comment uzly do sbírky, vše, co musíte udělat, je získat informace, které potřebujete. V tomto vzorku jsou iniciály autora, datum, čas a prostý text komentáře kombinovány do jednoho řetězce; místo toho se můžete rozhodnout jej uložit jiným způsobem.

Přetížená metoda, která vyjímá Komentáře od konkrétního autora, je téměř stejná, jen kontroluje jméno autora před přidáním informací do pole.

Následující příklad kódu ukazuje, jak extrahovat jméno autora, datum a čas a text připomínek uvedeného autora:

Jak odstranit komentáře

Pokud odstraníte všechny komentáře, není třeba se přes sbírku mazat komentáře jeden po druhém; můžete je odstranit voláním clear ke sbírce připomínek.

Následující příklad kódu ukazuje, jak odstranit všechny připomínky v dokumentu:

Když potřebujete selektivní odstranění komentářů, proces se stává více podobný kódu, který jsme použili pro získávání komentářů.

Následující příklad kódu ukazuje, jak odstranit komentáře zadaného autora:

Hlavním bodem pro zdůraznění je použití pro obsluhu. Na rozdíl od jednoduché extrakce, zde chcete smazat komentář. Vhodným trikem je iterovat sbírku pozpátku od posledního Comment na první. Důvodem je, že pokud začnete od konce a posunete se dozadu, index předchozích položek zůstává nezměněn a můžete se vrátit k první položce ve sbírce.

Následující příklad kódu uvádí metody pro výpis a odstranění připomínek:

Jak odstranit komentář mezi CommentRangeStart a CommentRangeEnd

Použití Aspose.Words můžete také odstranit komentáře mezi CommentRangeStart a CommentRangeEnd uzly.

Následující příklad kódu ukazuje, jak odstranit text mezi CommentRangeStart a CommentRangeEnd:

# Open the document.
doc = aw.Document(docs_base.my_dir + "Comments.docx")

commentStart = doc.get_child(aw.NodeType.COMMENT_RANGE_START, 0, True).as_comment_range_start()
commentEnd = doc.get_child(aw.NodeType.COMMENT_RANGE_END, 0, True).as_comment_range_end()

currentNode = commentStart
isRemoving = True
while (currentNode != None and isRemoving) :
    if (currentNode.node_type == aw.NodeType.COMMENT_RANGE_END) :
        isRemoving = False

    nextNode = currentNode.next_pre_order(doc)
    currentNode.remove()
    currentNode = nextNode

# Save the document.
doc.save(docs_base.artifacts_dir + "WorkingWithComments.remove_region_text.docx")

Přidat nebo odstranit odpověď komentáře

• add_reply metoda přidává odpověď na tuto poznámku. Vezměte prosím na vědomí, že vzhledem k existující Microsoft V dokumentu je povolena pouze 1 úroveň odpovědí. Výjimku typu InvalidOperationException bude vznesena, pokud je tato metoda vyzvána ke stávající komentáři k odpovědi.

Můžete použít remove_reply způsob odstranění specifikované odpovědi na tento komentář.

Následující příklad kódu ukazuje, jak přidat odpověď na komentář a odstranit odpověď komentáře:

Přečtěte si komentář

• replies majetek vrací soubor Comment předměty, které jsou okamžitými dětmi uvedeného komentáře.

Následující příklad kódu ukazuje, jak iterovat prostřednictvím odpovědí na komentář a vyřešil je:

Práce s textBoxy v Python Změna stopy v dokumentu