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 naCustomDocumentPropertieskolekcji, 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.