Aspose.Words for Java でのドキュメント プロパティの使用

ドキュメントプロパティの概要

ドキュメント プロパティは、あらゆるドキュメントの重要な部分です。ドキュメント プロパティは、タイトル、作成者、件名、キーワードなど、ドキュメント自体に関する追加情報を提供します。Aspose.Words for Java では、組み込みのドキュメント プロパティとカスタムのドキュメント プロパティの両方を操作できます。

ドキュメントプロパティの列挙

組み込みプロパティ

組み込みのドキュメント プロパティを取得して操作するには、次のコード スニペットを使用できます。

@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()));
}

このコードは、ドキュメントの名前と組み込みプロパティ（「タイトル」、「作成者」、「キーワード」などのプロパティを含む）を表示します。

カスタムプロパティ

カスタム ドキュメント プロパティを操作するには、次のコード スニペットを使用できます。

@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);
}

このコード スニペットは、ブール値、文字列、日付、リビジョン番号、数値などのカスタム ドキュメント プロパティを追加する方法を示しています。

ドキュメントプロパティの削除

特定のドキュメント プロパティを削除するには、次のコードを使用できます。

@Test
public void removeCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    doc.getCustomDocumentProperties().remove("Authorized Date");
}

このコードは、ドキュメントからカスタム プロパティ「承認日」を削除します。

コンテンツへのリンクの設定

場合によっては、ドキュメント内にリンクを作成する必要があります。その方法は次のとおりです。

@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();

    //コンテンツプロパティへのリンクを追加します。
    DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
    customProperty = customProperties.get("Bookmark");
    boolean isLinkedToContent = customProperty.isLinkToContent();
    String linkSource = customProperty.getLinkSource();
    String customPropertyValue = customProperty.getValue().toString();
}

このコード スニペットは、ドキュメント内にブックマークを作成し、そのブックマークにリンクするカスタム ドキュメント プロパティを追加する方法を示しています。

測定単位の変換

Aspose.Words for Java では、測定単位を簡単に変換できます。以下にその方法の例を示します。

@Test
public void convertBetweenMeasurementUnits() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    PageSetup pageSetup = builder.getPageSetup();

    //余白をインチ単位で設定します。
    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));
}

このコード スニペットは、さまざまな余白と距離をインチ単位でポイントに変換して設定します。

制御文字の使用

制御文字はテキストを扱うときに便利です。テキスト内の制御文字を置き換える方法は次のとおりです。

@Test
public void useControlCharacters()
{
    final String TEXT = "test\r";

    // 「\r」制御文字を「\r\n」に置き換えます。
    String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}

この例では、キャリッジリターン（\r) の後に改行 (\r\n）。

結論

ドキュメント プロパティは、Aspose.Words for Java でドキュメントを効果的に管理および整理する上で重要な役割を果たします。組み込みプロパティ、カスタム プロパティ、または制御文字の使用のいずれの場合でも、ドキュメント管理機能を強化するために利用できるさまざまなツールがあります。

よくある質問

組み込みのドキュメント プロパティにアクセスするにはどうすればよいですか?

Aspose.Words for Javaの組み込みドキュメントプロパティにアクセスするには、getBuiltInDocumentProperties方法Documentオブジェクト。このメソッドは、反復処理できる組み込みプロパティのコレクションを返します。

ドキュメントにカスタム ドキュメント プロパティを追加できますか?

はい、ドキュメントにカスタムドキュメントプロパティを追加できます。CustomDocumentPropertiesコレクション。文字列、ブール値、日付、数値など、さまざまなデータ型を使用してカスタム プロパティを定義できます。

特定のカスタム ドキュメント プロパティを削除するにはどうすればよいですか?

特定のカスタムドキュメントプロパティを削除するには、remove方法CustomDocumentPropertiesコレクションに、削除するプロパティの名前をパラメータとして渡します。

ドキュメント内のコンテンツにリンクする目的は何ですか?

ドキュメント内のコンテンツにリンクすると、ドキュメントの特定の部分への動的な参照を作成できます。これは、インタラクティブなドキュメントやセクション間の相互参照を作成する場合に便利です。

Aspose.Words for Java で異なる測定単位を変換するにはどうすればよいですか?

Aspose.Words for Javaでは、以下の方法で異なる測定単位を変換することができます。ConvertUtilクラス。インチをポイントに、ポイントをセンチメートルになど、単位を変換するメソッドを提供します。