Práce s vlastnostmi dokumentu

Vlastnosti dokumentu umožňují ukládat některé užitečné informace o dokumentu. Tyto vlastnosti lze rozdělit do dvou skupin:

  • Systém nebo vestavěný, které obsahují hodnoty, jako je název dokumentu, jméno autora, statistiky dokumentů a další.
  • Uživatelem definované nebo vlastní, poskytované jako páry název-hodnota, kde uživatel může definovat název i hodnotu.

Je užitečné vědět, že informace o API a čísle verze se zapisují přímo do výstupních dokumentů. Například při převodu dokumentu na PDF vyplní Aspose.Words pole “aplikace” pomocí “Aspose.Words” a pole “PDF Výrobce” pomocí “Aspose.Words pro C++ YY.M. N”, kde YY.M.N je verze Aspose.Words použitá pro převod. Další podrobnosti viz Název generátoru nebo výrobce obsažený ve výstupních dokumentech.

Vlastnosti Dokumentu Access

Pro přístup k vlastnostem dokumentu v Aspose.Words použijte:

BuiltInDocumentProperties

BuiltInDocumentProperties

Třída DocumentProperty umožňuje získat název, hodnotu a typ vlastnosti dokumentu. Value vrací objekt, ale existuje sada metod, které vám umožňují převést hodnotu vlastnosti na konkrétní typ. Poté, co se dozvíte, o jaký typ vlastnosti jde, můžete použít jednu z metod DocumentProperty.ToXXX, například DocumentProperty.ToString a DocumentProperty.ToInt, k získání hodnoty příslušného typu.

Následující příklad kódu ukazuje, jak vyjmenovat všechny vestavěné a vlastní vlastnosti v dokumentu:

V Microsoft Word můžete přistupovat k vlastnostem dokumentu pomocí nabídky “Soubor → Vlastnosti”.

work-with-document-properties-aspose-words-cpp_1.png

Přidání nebo odebrání vlastností dokumentu

Předdefinované Vlastnosti dokumentu nelze přidat ani odebrat pomocí Aspose.Words. Můžete pouze změnit nebo aktualizovat jejich hodnoty.

Chcete-li přidat vlastní vlastnosti dokumentu pomocí Aspose.Words, použijte metodu Add a předejte nový název vlastnosti a hodnotu příslušného typu. Metoda vrací nově vytvořený objekt DocumentProperty.

Chcete-li odebrat vlastní vlastnosti, použijte metodu Remove a předejte jí název vlastnosti, kterou chcete odebrat, nebo metodu RemoveAt k odstranění vlastnosti podle indexu. Všechny vlastnosti Můžete také odebrat pomocí metody Clear.

Následující příklad kódu zkontroluje, zda v dokumentu existuje vlastní vlastnost s daným názvem, a přidá několik dalších vlastních vlastností dokumentu:

Následující příklad kódu ukazuje, jak odebrat vlastní vlastnost dokumentu:

Aktualizace Vestavěných Vlastností Dokumentu

Aspose.Words automaticky neaktualizuje Vlastnosti dokumentu, jako Microsoft Word u některých vlastností, ale poskytuje metodu aktualizace některých statistických vestavěných vlastností dokumentu. Zavolejte metodu UpdateWordCount a přepočítejte a aktualizujte následující vlastnosti:

Vytvoření nové vlastní vlastnosti propojené s obsahem

Aspose.Words poskytuje metodu AddLinkToContent k vytvoření nové vlastnosti vlastního dokumentu propojené s obsahem. Tato vlastnost vrací nově vytvořený objekt Vlastnosti nebo null, pokud je LinkSource neplatný.

Následující příklad kódu ukazuje, jak nakonfigurovat odkaz na vlastní vlastnost:

Získejte Proměnné Dokumentu

Kolekci proměnných dokumentu můžete získat pomocí vlastnosti Variables. Názvy a hodnoty proměnných jsou řetězce.

Následující příklad kódu ukazuje, jak vyjmenovat proměnné dokumentu:

Odstranění osobních údajů z dokumentu

Pokud chcete sdílet dokument Word s jinými lidmi, možná budete chtít odstranit osobní údaje, jako je jméno autora a společnost. Chcete-li to provést, použijte vlastnost RemovePersonalInformation k nastavení příznaku označujícího, že Microsoft Word odstraní všechny informace o uživateli z komentářů, revizí a vlastností dokumentu po uložení dokumentu.

Následující příklad kódu ukazuje, jak odstranit osobní údaje:

Převod mezi měrnými jednotkami v C++