Intelligent Media Management:テキスト

範囲内のテキストを取得または設定する

指定された範囲内のテキストを取得します。

• 構文

  Expression.ActiveDocument.Range(Start, End).Text または

  Expression.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Range.Text

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  • 例 1

    //@file=base.docx
    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // 選択範囲を取得します。
      const range = await app.ActiveDocument.Range(0, 100);
    
      // テキストを取得します。
      const text = await range.Text;
      console.log(text);
    
      // テキストを設定します。
      range.Text = 'WebOffice';
    }

  • 例 2

    //@file=base.docx
    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 最初の表を取得します。
      const tableOne = await app.ActiveDocument.Tables.Item(1);
    
      // 表の最初の行の最初のセルを取得します。
      const cellOne = await tableOne.Rows.Item(1).Cells.Item(1);
      
      // セルの範囲オブジェクトを取得します。
      const range = await cellOne.Range;
    
      // テキストを取得します。
      const text = await range.Text;
      console.log(text);
    
      // テキストを設定します。
      range.Text = 'WebOffice';
    }

指定されたテキストを置換する

渡された配列に基づいてテキストを照合して置換します。

• 構文

  Expression.ActiveDocument.ReplaceText(Array.<Object>)

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  • 置換するテキストのリストを表す配列を渡します。

    パラメーター	タイプ	必須	説明
    list	Array.<Object>	はい	置換するテキストのリスト。

  • list パラメーターの説明

    フィールド	タイプ	必須	説明
    key	String	はい	古いテキスト。
    value	String	はい	新しいテキスト。
    options	Object	いいえ	置換オプション。

  • options フィールドの説明

    プロパティ	タイプ	必須	説明
    isWildcardMatched	Boolean	いいえ	ワイルドカードを使用するかどうかを指定します。アスタリスク (*) および疑問符 (?) ワイルドカード文字がサポートされています。 アスタリスク (*): 任意の文字列と一致します。 疑問符 (?): 単一の文字と一致します。一致する文字が存在する必要があります。
    isCaseSensitive	Boolean	いいえ	テキストの大文字と小文字を区別するかどうかを指定します。
    isWholeWordMatched	Boolean	いいえ	完全一致を使用するかどうかを指定します。
    isWidthIgnored	Boolean	いいえ	全角文字と半角文字の両方をサポートするかどうかを指定します。

• 戻り値

  boolean タイプの値。true は置換が成功したことを示します。false は置換が失敗したことを示します。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    const isSuccess = await app.ActiveDocument.ReplaceText([
      {
        key: 'WebOffice',
        value: 'js-sdk',
      },
    ]);
    console.log(isSuccess); //true
  }

指定されたテキストを挿入する

選択範囲の後に指定されたテキストを挿入します。

• 構文

  Expression.ActiveDocument.ActiveWindow.Selection.InsertAfter(Text)

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• パラメーター

  パラメーター	タイプ	必須	説明
  Text	String	はい	挿入するテキスト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 選択範囲の後に指定されたテキストを挿入します。
    await app.ActiveDocument.ActiveWindow.Selection.InsertAfter('Text');
  }

改行を挿入する

選択範囲の後に改行を挿入します。

• 構文

  Expression.ActiveDocument.ActiveWindow.Selection.InsertBreak()

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 選択範囲の最後に改行を挿入します。
    await app.ActiveDocument.ActiveWindow.Selection.InsertBreak();
  }

文字を削除する

選択範囲の前の文字を削除します。

• 構文

  Expression.ActiveDocument.ActiveWindow.Selection.TypeBackspace()

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // カーソルを下に移動します。
    await app.ActiveDocument.ActiveWindow.Selection.MoveDown();
  
    // カーソルの前の文字を削除します。
    await app.ActiveDocument.ActiveWindow.Selection.TypeBackspace();
  }

開始位置を取得する

範囲の開始位置を取得します。

• 構文

  Expression.ActiveDocument.Range(Start, End).Start

  Expression.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Range.Start

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  • 例 1

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 選択範囲を取得します。
      const range = await app.ActiveDocument.Range(0, 100);
    
      // 選択されたテキストの開始位置を取得します。
      const start = await range.Start;
      console.log(start);
    }

  • 例 2

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 最初の表を取得します。
      const tableOne = await app.ActiveDocument.Tables.Item(1);
    
      // 表の最初の行の最初のセルを取得します。
      const cellOne = await tableOne.Rows.Item(1).Cells.Item(1);
      
      // セルの範囲オブジェクトを取得します。
      const range = await cellOne.Range;
    
      // 選択されたセルの開始位置を取得します。
      const start = await range.Start;
      console.log(start);
    }

終了位置を取得する

範囲の終了位置を取得します。

• 構文

  Expression.ActiveDocument.Range(Start, End).End または

  Expression.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Range.End

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  • 例 1

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 選択範囲を取得します。
      const range = await app.ActiveDocument.Range(0, 100);
    
      // 選択されたテキストの終了位置を取得します。
      const end = await range.End;
      console.log(end);
    }

  • 例 2

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      // 最初の表を取得します。
      const tableOne = await app.ActiveDocument.Tables.Item(1);
    
      // 表の最初の行の最初のセルを取得します。
      const cellOne = await tableOne.Rows.Item(1).Cells.Item(1);
      
      // セルの範囲オブジェクトを取得します。
      const range = await cellOne.Range;
    
      // 選択されたセルの終了位置を取得します。
      const end = await range.End;
      console.log(end);
    }

フォント

font オブジェクトを取得する

Font オブジェクトを取得して、選択されたコンテンツのフォント (フォントタイプ、フォントサイズなど) を設定します。

• 構文

  Expression.ActiveDocument.Range(Start, End).Font

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // フォントオブジェクトを取得します。
    const font = await app.ActiveDocument.Range(0, 20).Font;
  }

フォントタイプを設定する

選択されたテキストのフォントタイプを設定します。

• 構文

  Expression.ActiveDocument.Range(Start, End).Font.Name

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // フォントオブジェクトを取得します。
    const font = await app.ActiveDocument.Range(0, 20).Font;
    
    // 選択されたテキストのフォントタイプを設定します。
    font.Name ='SimSun';
  }

フォントサイズを設定する

選択されたテキストのフォントサイズを設定します。

• 構文

  Expression.ActiveDocument.Range(Start, End).Font.Size

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // フォントオブジェクトを取得します。
    const font = await app.ActiveDocument.Range(0, 20).Font;
    
    // 選択されたテキストのフォントサイズを設定します。
    font.Size = 30;
  }

フォントの色を設定する

選択されたテキストのフォントの色を設定します。次のいずれかの方法を使用して、フォントの色を設定できます。

• 方法 1:

  • 構文

    Expression.ActiveDocument.Range(Start, End).Font.Color

    Expression: ドキュメントタイプのアプリケーションオブジェクト。

  • 例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // フォントオブジェクトを取得します。
      const font = await app.ActiveDocument.Range(0, 20).Font;
      
      // 選択されたテキストのフォントの色を設定します。
      font.Color = '#228B22';
    }

• 方法 2:

  • 構文

    Expression.ActiveDocument.Range(Start, End).Font.ColorIndex(WdColorIndex)

    Expression: ドキュメントタイプのアプリケーションオブジェクト。

  • パラメーター

    パラメーター	タイプ	必須	説明
    WdColorIndex	Enum	はい	フォントの色。Enum.WdColorIndex の有効な値: -1 または wdByAuthor: ドキュメントの作成者によって定義された色。 0 または wdAutor: デフォルトの色。通常は黒。これはデフォルト値です。 1 または wdBlackr: 黒色。 2 または wdBluer: 青色。 3 または wdTurquoiser: ターコイズ色。 4 または wdBrightGreen: 明るい緑色。 5 または wdPink: ピンク色。 6 または wdRed: 赤色。 7 または wdYellow: 黄色。 8 または wdWhite: 白色。 9 または wdDarkBlue: 濃い青色。 10 または wdTeal: 青緑色。 11 または wdGreen: 緑色。 12 または wdViolet: 紫色。 13 または wdDarkRed: 濃い赤色。 14 または wdDarkYellow: 濃い黄色。 15 または wdGray50: グレーの色合い 50。 16 または wdGray25: グレーの色合い 25。

  • 例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
    
      // フォントオブジェクトを取得します。
      const font = await app.ActiveDocument.Range(0, 20).Font;
    
      // 選択されたテキストのフォントの色を設定します。
      await font.ColorIndex(2);
    }

テキストを強調表示する

• 構文

  Expression.ActiveDocument.Range(Start, End).Font.HighLight

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // フォントオブジェクトを取得します。
    const font = await app.ActiveDocument.Range(0, 20).Font;
    
    // 選択されたテキストを強調表示します。
    font.HighLight = '#228B22';
  }

段落

paragraph オブジェクトを取得する

• 構文

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

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // 段落オブジェクトを取得します。
    const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
  }

段落を挿入する

選択範囲に新しい段落を挿入します。

• 構文

  Expression.ActiveDocument.ActiveWindow.Selection.InsertParagraph()

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    // 選択範囲に新しい段落を挿入します。
    await app.ActiveDocument.ActiveWindow.Selection.InsertParagraph();
  }

字下げを設定する

• 構文

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

  Expression: ドキュメントタイプのアプリケーションオブジェクト。

• 例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
  
    // 段落オブジェクトを取得します。
    const paragraphFormat = await app.ActiveDocument.Range(0, 20).ParagraphFormat;
   
    // 最初の行を2単位字下げします。
    paragraphFormat.CharacterUnitFirstLineIndent = 2;
  }

行間を設定する

• 構文

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

  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.5;
  }