Korzystanie z właściwości dokumentu w Aspose.Words dla Java
Wprowadzenie do właściwości dokumentu
Właściwości dokumentu są istotną częścią każdego dokumentu. Dostarczają dodatkowych informacji o samym dokumencie, takich jak jego tytuł, autor, temat, słowa kluczowe i inne. W Aspose.Words dla Java możesz manipulować zarówno wbudowanymi, jak i niestandardowymi właściwościami dokumentu.
Wyliczanie właściwości dokumentu
Wbudowane właściwości
Aby pobrać wbudowane właściwości dokumentu i pracować z nimi, możesz użyć następującego fragmentu kodu:
@Test
public void enumerateProperties() throws Exception
{
Document doc = new Document("Your Directory Path" + "Properties.docx");
System.out.println(MessageFormat.format("1. Document name: {0}", doc.getOriginalFileName()));
System.out.println("2. Built-in Properties");
for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
System.out.println(MessageFormat.format("{0} : {1}", prop.getName(), prop.getValue()));
}
Ten kod wyświetli nazwę dokumentu i wbudowane właściwości, w tym właściwości takie jak „Tytuł”, „Autor” i „Słowa kluczowe”.
Właściwości niestandardowe
Aby pracować z niestandardowymi właściwościami dokumentu, możesz użyć następującego fragmentu kodu:
@Test
public void addCustomDocumentProperties() throws Exception
{
Document doc = new Document("Your Directory Path" + "Properties.docx");
CustomDocumentProperties customDocumentProperties = doc.getCustomDocumentProperties();
if (customDocumentProperties.get("Authorized") != null) return;
customDocumentProperties.add("Authorized", true);
customDocumentProperties.add("Authorized By", "John Smith");
customDocumentProperties.add("Authorized Date", new Date());
customDocumentProperties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
customDocumentProperties.add("Authorized Amount", 123.45);
}
Ten fragment kodu demonstruje, jak dodać niestandardowe właściwości dokumentu, w tym wartość logiczną, ciąg znaków, datę, numer wersji i wartość liczbową.
Usuwanie właściwości dokumentu
Aby usunąć określone właściwości dokumentu, możesz użyć następującego kodu:
@Test
public void removeCustomDocumentProperties() throws Exception
{
Document doc = new Document("Your Directory Path" + "Properties.docx");
doc.getCustomDocumentProperties().remove("Authorized Date");
}
Ten kod usuwa niestandardową właściwość „Data autoryzacji” z dokumentu.
Konfigurowanie łącza do treści
W niektórych przypadkach możesz chcieć utworzyć łącza w swoim dokumencie. Oto jak możesz to zrobić:
@Test
public void configuringLinkToContent() throws Exception
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.startBookmark("MyBookmark");
builder.writeln("Text inside a bookmark.");
builder.endBookmark("MyBookmark");
CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();
// Dodaj właściwość powiązaną z treścią.
DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
customProperty = customProperties.get("Bookmark");
boolean isLinkedToContent = customProperty.isLinkToContent();
String linkSource = customProperty.getLinkSource();
String customPropertyValue = customProperty.getValue().toString();
}
Ten fragment kodu demonstruje, jak utworzyć zakładkę w dokumencie i dodać niestandardową właściwość dokumentu zawierającą łącze do tej zakładki.
Konwersja pomiędzy jednostkami miary
W Aspose.Words dla Java możesz łatwo konwertować jednostki miary. Oto przykład, jak to zrobić:
@Test
public void convertBetweenMeasurementUnits() throws Exception
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
PageSetup pageSetup = builder.getPageSetup();
// Ustaw marginesy w calach.
pageSetup.setTopMargin(ConvertUtil.inchToPoint(1.0));
pageSetup.setBottomMargin(ConvertUtil.inchToPoint(1.0));
pageSetup.setLeftMargin(ConvertUtil.inchToPoint(1.5));
pageSetup.setRightMargin(ConvertUtil.inchToPoint(1.5));
pageSetup.setHeaderDistance(ConvertUtil.inchToPoint(0.2));
pageSetup.setFooterDistance(ConvertUtil.inchToPoint(0.2));
}
Ten fragment kodu ustawia różne marginesy i odległości w calach, konwertując je na punkty.
Używanie znaków kontrolnych
Znaki sterujące mogą być przydatne podczas pracy z tekstem. Oto jak zamienić znak kontrolny w tekście:
@Test
public void useControlCharacters()
{
final String TEXT = "test\r";
// Zamień znak kontrolny „\r” na „\r\n”.
String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}
W tym przykładzie zastępujemy powrót karetki (\r
) z powrotem karetki, po którym następuje przesunięcie wiersza (\r\n
).
Wniosek
Właściwości dokumentu odgrywają znaczącą rolę w efektywnym zarządzaniu dokumentami i organizowaniu ich w Aspose.Words for Java. Niezależnie od tego, czy pracujesz z właściwościami wbudowanymi, właściwościami niestandardowymi, czy też używasz znaków sterujących, masz do dyspozycji szereg narzędzi zwiększających możliwości zarządzania dokumentami.
Często zadawane pytania
Jak uzyskać dostęp do wbudowanych właściwości dokumentu?
Aby uzyskać dostęp do wbudowanych właściwości dokumentu w Aspose.Words dla Java, możesz użyćgetBuiltInDocumentProperties
metoda naDocument
obiekt. Ta metoda zwraca kolekcję wbudowanych właściwości, po których można iterować.
Czy mogę dodać niestandardowe właściwości dokumentu do dokumentu?
Tak, możesz dodać niestandardowe właściwości dokumentu do dokumentu za pomocąCustomDocumentProperties
kolekcja. Można definiować właściwości niestandardowe za pomocą różnych typów danych, w tym ciągów znaków, wartości logicznych, dat i wartości numerycznych.
Jak mogę usunąć określoną niestandardową właściwość dokumentu?
Aby usunąć określoną niestandardową właściwość dokumentu, możesz użyć metodyremove
metoda naCustomDocumentProperties
kolekcji, przekazując jako parametr nazwę właściwości, którą chcesz usunąć.
Jaki jest cel tworzenia linków do treści w dokumencie?
Linki do treści w dokumencie umożliwiają tworzenie dynamicznych odniesień do określonych części dokumentu. Może to być przydatne do tworzenia interaktywnych dokumentów lub odsyłaczy między sekcjami.
Jak mogę przekonwertować różne jednostki miary w Aspose.Words dla Java?
Możesz konwertować pomiędzy różnymi jednostkami miary w Aspose.Words dla Java za pomocąConvertUtil
klasa. Zapewnia metody konwersji jednostek, takich jak cale na punkty, punkty na centymetry i inne.