すべてのプロダクト
Search

このプロダクト

    Intelligent Media Management:コンテンツコントロール

    ドキュメントセンター

    Intelligent Media Management:コンテンツコントロール

    最終更新日:Dec 27, 2024

    このトピックでは、テキストドキュメントを使用する場合に、コントロールの数を取得する方法、コントロールのプロパティを設定する方法、コントロールのタイトルを取得する方法、およびコントロールのタグを取得する方法について説明します。

    コンテンツコントロールオブジェクトの取得

    ドキュメント内のすべてのコンテンツコントロールオブジェクトを取得します。

    • 構文

      Expression.ActiveDocument.ContentControls

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

    • 例

      //@file=base.docx
async function example() {
  await instance.ready();

  const app = instance.Application;

  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;
}

    コンテンツコントロールの数の取得

    ドキュメント内のコンテンツコントロールの数を取得します。

    • 構文

      Expression.ActiveDocument.ContentControls.Count

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

    • 戻り値

      ドキュメント内のコンテンツコントロールの数を表す数値を返します。

    • 例

      async function example() {
  await instance.ready();

  const app = instance.Application;

  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;
  
  // コンテンツコントロールの数を取得します。
  const count = await contentControls.Count;
  console.log(count);
}

    単一のコンテンツコントロール

    単一のコンテンツコントロールオブジェクトの取得

    • 構文

      Expression.ActiveDocument.ContentControls.Item(Index)

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

    • パラメーター

      パラメーター

      タイプ

      必須

      説明

      Index

      String

      はい

      返すコンテンツコントロールの序数位置。

    • 戻り値

      指定されたコンテンツコントロールオブジェクトを返します。

    • 例

      async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // 最初のコンテンツコントロールを取得します。
  const contentControl = await contentControls.Item(1);
}

    コンテンツコントロールのテキストの取得または設定

    Range.Textを使用して、コンテンツコントロールのテキストを取得または設定します。

    重要

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

    • 構文

      Expression.ActiveDocument.ContentControls.Item(Index).Range

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

    • 例

      • コンテンツコントロールの範囲を取得する

        async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // 最初のコンテンツコントロールを取得します。
  const contentControl = await contentControls.Item(1);

  // 最初のコンテンツコントロールの範囲を取得します。
  const range = await contentControl.Range;
  console.log(range);
}

      • コンテンツコントロールのテキストを取得または設定する

        async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // 最初のコンテンツコントロールを取得します。
  const contentControl = await contentControls.Item(1);

  // 最初のコンテンツコントロールの範囲を取得します。
  const range = await contentControl.Range;

  // 最初のコンテンツコントロールのテキストを取得します。
  const text = range.Text;
  console.log(text);

  // 最初のコンテンツコントロールのテキストを設定します。
  range.Text = 'Aliyun';
}

    コンテンツコントロールのプレースホルダーテキストの取得

    重要

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

    • 構文

      Expression.ActiveDocument.ContentControls.Item(Index).PlaceholderText

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

    • 例

      async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // 最初のコンテンツコントロールを取得します。
  const contentControl = await contentControls.Item(1);

  // 最初のコンテンツコントロールのプレースホルダーテキストを取得します。
  const placeholderText = await contentControl.PlaceholderText;
  console.log(placeholderText);
}

    コンテンツコントロールのタイトルの取得

    • 構文

      Expression.ActiveDocument.ContentControls.Item(Index).Title

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

    • 例

      async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // 最初のコンテンツコントロールを取得します。
  const contentControl = await contentControls.Item(1);

  // 最初のコンテンツコントロールのタイトルを設定します。
  contentControl.Title = 'Aliyun';

  // 最初のコンテンツコントロールのタイトルを取得します。
  const title = await contentControl.Title;
  console.log(title);
}

    コンテンツコントロールのタグの取得または設定

    • 構文

      Expression.ActiveDocument.ContentControls.Item(Index).Tag

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

    • 例

      async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // 最初のコンテンツコントロールを取得します。
  const contentControl = await contentControls.Item(1);

  // 最初のコンテンツコントロールのタグを設定します。
  contentControl.Tag = 'Aliyun';

  // 最初のコンテンツコントロールのタグを取得します。
  const Tag = await contentControl.Tag;
  console.log(Tag);
}

    コンテンツコントロールの追加

    重要

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

    • 構文

      Expression.ActiveDocument.ContentControls.Add()

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

    • 戻り値

      新しいContentControlオブジェクトを返します。

    • 例

      async function example() {
  await instance.ready();

  const app = instance.Application;

  // カーソルを指定された位置の前に移動します。
  const info=await app.ActiveDocument.Find.Execute ('different');
  const pos = info[0] && info[0].pos || 0;
  await app.ActiveDocument.Range.SetRange(pos, pos);

  // コンテンツコントロールオブジェクトを取得します。
  const contentControls = await app.ActiveDocument.ContentControls;

  // カーソルの位置にコンテンツコントロールを挿入します。
  await contentControls.Add();
}