すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Management:段落

最終更新日:Mar 29, 2025

このトピックでは、テキストドキュメントの段落オブジェクトに関連する API 操作について説明します。

段落

ActiveDocument.Range(Start, End).Paragraphs

範囲内のすべての段落を返します。

重要
  • JS-SDK V1.1.14 以降でのみ、この機能がサポートされています。

  • この機能は PC にのみ適用されます。

  • 構文

    expression.ActiveDocument.Range(Start, End).Paragraphs

    expression: アプリケーション オブジェクト。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 範囲内のすべての段落を返します。
      const paragraphs = app.ActiveDocument.Range(0, 100).Paragraphs;
    }

メソッド

ActiveDocument.Range(Start, End).Paragraphs.Item()

段落オブジェクトを返します。

重要

JS-SDK V1.1.14 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).Paragraphs.Item(Index)

    expression: アプリケーション オブジェクト。

  • パラメータ

    パラメータ

    必須

    説明

    Index

    数値

    はい

    段落のインデックス。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 範囲内のすべての段落を返します。
      const paragraphs = app.ActiveDocument.Range(0, 100).Paragraphs;
    
      // 最初の段落オブジェクトを返します。
      const paragraph = paragraphs.Item(1);
    }

プロパティ

ActiveDocument.Range(Start, End).Paragraphs.Count

範囲内の段落の総数を返します。

重要

JS-SDK V1.1.14 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).Paragraphs.Count

    expression: アプリケーション オブジェクト。

  • 戻り値

    段落の数を表す 数値

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 範囲内の段落の総数を返します。
      const count = await app.ActiveDocument.Range(0, 100).Paragraphs.Count;
      console.log(count);
    }

ActiveDocument.Range(Start, End).Paragraphs.Item(Index).Range

段落オブジェクトに含まれるドキュメントの一部を返します。

重要

JS-SDK V1.1.14 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).Paragraphs.Item(Index).Range

    expression: アプリケーション オブジェクト。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 範囲内のすべての段落を返します。
      const paragraphs = app.ActiveDocument.Range(0, 100).Paragraphs;
    
      // 最初の段落オブジェクトを返します。
      const paragraph = paragraphs.Item(1);
    
      // この段落に含まれるドキュメントの一部を返します。
      const range = await paragraph.Range;
    }

ParagraphFormat

ActiveDocument.Range(Start, End).ParagraphFormat

指定された範囲の段落設定を返します。

重要

JS-SDK V1.1.10 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).ParagraphFormat

    または expression.ActiveDocument.ActiveWindow.Selection.ParagraphFormat

    expression: アプリケーション オブジェクト。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // 指定された範囲の段落設定を返します。
      const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
    }

メソッド

ActiveDocument.Range(Start, End).ParagraphFormat.SetFixedLineSpacing(Value, Unit)

固定の行間隔を設定します。

  • 構文

    expression.ActiveDocument.Range(Start, End).ParagraphFormat.SetFixedLineSpacing

    または expression.ActiveDocument.ActiveWindow.Selection.ParagraphFormat

    expression: アプリケーション オブジェクト。

  • パラメータ

    パラメータ

    必須

    説明

    Value

    数値

    はい

    行間隔。有効値: ポイントの場合は 0 ~ 1000、センチメートルの場合は 0 ~ 55、ミリメートルの場合は 0 ~ 550、インチの場合は 0 ~ 22。

    Unit

    列挙型

    はい

    行間隔の単位。

  • //@file=base.docx
    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // ParagraphFormat オブジェクトを返します。
      const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
    
      // 固定行間隔を 18 ポイントに設定します。
      await paragraphFormat.SetFixedLineSpacing(18, 0);
    }

ActiveDocument.Range(Start, End).ParagraphFormat.setParagraphAlignment

指定された段落の配置を設定します。

重要

JS-SDK V1.1.19 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).ParagraphFormat.setParagraphAlignment

    expression: アプリケーション オブジェクト。

  • パラメータ

    パラメータ

    必須

    説明

    Value

    列挙型

    はい

    段落の配置。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // ParagraphFormat オブジェクトを返します。
      const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
    
      // 中央揃えを適用します。
      paragraphFormat.setParagraphAlignment(app.Enum.WdAlignmentMode.wdCenter);
    }

プロパティ

ActiveDocument.Range(Start, End).ParagraphFormat.CharacterUnitFirstLineIndent

段落の字下げを設定します。

重要

JS-SDK V1.1.10 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).ParagraphFormat.CharacterUnitFirstLineIndent

    または expression.ActiveDocument.ActiveWindow.Selection.ParagraphFormat

    expression: アプリケーション オブジェクト。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // 指定された範囲の段落設定を返します。
      const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
     
      // 2 単位の字下げを設定します。
      paragraphFormat.CharacterUnitFirstLineIndent = 2;
    }

ActiveDocument.Range(Start, End).ParagraphFormat.LineSpacingRule

指定された段落フォーマットの行間隔を設定します。 詳細については、「WdLineSpacing」をご参照ください。

重要

JS-SDK V1.1.10 以降でのみ、この機能がサポートされています。

  • 構文

    expression.ActiveDocument.Range(Start, End).ParagraphFormat.LineSpacingRule

    または expression.ActiveDocument.ActiveWindow.Selection.ParagraphFormat

    expression: アプリケーション オブジェクト。

  • async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // 指定された範囲の段落設定を返します。
      const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
     
      // 1.5 行間隔を設定します。
      paragraphFormat.LineSpacingRule = 1;
    }