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ěžná praxe 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 připomínek 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 poměrně 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 getChildNodes metoda s prvním parametrem nastaveným na NodeType.Comment. Ujistěte se, že druhý parametr GetChildnodes metoda je nastavena na true: to nutí GetChildnodes 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í operátora
    2. Výpis a výpis autora jméno, datum a čas a text všech komentářů
    3. Výpis a seznam autora, datum a čas a text komentářů napsaných konkrétním autorem, v tomto případě autora
  4. Pro odstranění připomínek:
    1. Přejít zpět přes sbírku pomocí pro operátora
    2. Odstranit připomínky
  5. Uložit změny.

Pro toto cvičení použijeme následující dokument Word:

extract-remove-comments-aspose-words-java-1

Jak můžete vidět, obsahuje několik komentářů od dvou autorů s iniciály pm a aks.

Jak extrahovat všechny komentáře

The getChildNodes metoda je velmi užitečná a můžete ji použít pokaždé, když potřebujete získat seznam uzlů dokumentu jakéhokoli typu. Výsledná sbírka nevytváří bezprostřední nadmořská výška, 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

Poté, co jste vybrali Comment uzly do sbírky, vše, co musíte udělat, je extrahovat 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 si můžete vybrat, zda jej uložíte 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 zadaného autora:

Jak odstranit komentáře

Pokud odstraňujete 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 k zdůraznění zde je použití pro operátora. Na rozdíl od jednoduché extrakce, zde chcete smazat komentář. Vhodným trikem je iterovat kolekci pozpátku od posledního Komentáře k prvnímu. Důvodem je to, když 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:

Při spuštění zobrazí vzorek následující výsledky. Nejprve uvádí všechny komentáře všech autorů, pak uvádí komentáře pouze vybraného autora. Nakonec kód odstraní všechny komentáře.

extract-remove-comments-aspose-words-java-2

Výstup Word dokument má nyní připomínky odstraněny z něj:

extract-remove-comments-aspose-words-java-3

Jak odstranit text 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:

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

The addReply metoda přidává odpověď na tuto poznámku. Upozorňujeme, že vzhledem ke stávajícím omezením MS Office je v dokumentu povolena pouze jedna (1) úroveň odpovědí. Výjimku typu NeplatnáOperaceVýjimka bude zvýšena, pokud je tato metoda vyvolána na existující komentář Odpověď.

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

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

Přečtěte si komentář

Aspose.Words podporu čtení odpovědi komentáře. The 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 Linked TextBoxes v Java Změna stopy v dokumentu Java