Word.DocumentCreated class

DocumentCreated オブジェクトは、Application.createDocument によって作成される最上位のオブジェクトです。 DocumentCreated オブジェクトは特殊な Document オブジェクトです。

Extends

注釈

API セット: WordApi 1.3

使用元

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/50-document/insert-external-document.yaml

// Updates the text of the current document with the text from another document passed in as a Base64-encoded string.
await Word.run(async (context) => {
  // Use the Base64-encoded string representation of the selected .docx file.
  const externalDoc: Word.DocumentCreated = context.application.createDocument(externalDocument);
  await context.sync();

  if (!Office.context.requirements.isSetSupported("WordApiHiddenDocument", "1.3")) {
    console.warn("The WordApiHiddenDocument 1.3 requirement set isn't supported on this client so can't proceed. Try this action on a platform that supports this requirement set.");
    return;
  }

  const externalDocBody: Word.Body = externalDoc.body;
  externalDocBody.load("text");
  await context.sync();

  // Insert the external document's text at the beginning of the current document's body.
  const externalDocBodyText = externalDocBody.text;
  const currentDocBody: Word.Body = context.document.body;
  currentDocBody.insertText(externalDocBodyText, Word.InsertLocation.start);
  await context.sync();
});

プロパティ

body

ドキュメントの Body オブジェクトを取得します。 本文は、ヘッダー、フッター、脚注、テキスト ボックスなどを除いたテキストです。

contentControls

ドキュメント内の ContentControl オブジェクトのコレクションを取得します。 これには、ドキュメント本文のコンテンツ コントロール、ヘッダー、フッター、テキスト ボックスなどが含まれます。

context

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

customXmlParts

ドキュメント内のカスタム XML パーツを取得します。

properties

ドキュメントのプロパティを取得します。

saved

ドキュメント内の変更が保存されているかどうかを示します。 値 true は、ドキュメントが保存されてから変更されていないことを示します。

sections

ドキュメント内の Section オブジェクトのコレクションを取得します。

settings

ドキュメント内のアドインの設定を取得します。

メソッド

addStyle(name, type)

名前と種類で文書にスタイルを追加します。

addStyle(name, type)

名前と種類で文書にスタイルを追加します。

deleteBookmark(name)

ブックマークが存在する場合は、ブックマークをドキュメントから削除します。

getBookmarkRange(name)

ブックマークの範囲を取得します。 ブックマークが存在しない場合は、 ItemNotFound エラーをスローします。

getBookmarkRangeOrNullObject(name)

ブックマークの範囲を取得します。 ブックマークが存在しない場合、このメソッドは、 isNullObject プロパティが true に設定されたオブジェクトを返します。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

getContentControls(options)

ドキュメント内の現在サポートされているコンテンツ コントロールを取得します。

getStyles()

ドキュメントのスタイル セット全体を表す StyleCollection オブジェクトを取得します。

insertFileFromBase64(base64File, insertLocation, insertFileOptions)

追加プロパティを使用してターゲット ドキュメントの特定の位置にドキュメントを挿入します。 ヘッダー、フッター、透かし、およびその他のセクション プロパティは既定でコピーされます。 挿入する文書の最大サイズは 4 MB です。

load(options)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

open()

ドキュメントを開きます。

save(saveBehavior, fileName)

ドキュメントを保存します。

save(saveBehavior, fileName)

ドキュメントを保存します。

set(properties, options)

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

toJSON()

API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (次に、JSON.stringify渡されたオブジェクトの toJSON メソッドを呼び出します)。元の Word.DocumentCreated オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Word.Interfaces.DocumentCreatedData と型指定) を返します。

track()

ドキュメントの環境変更に基づいて自動的に調整する目的でオブジェクトを追跡します。 この呼び出しは、 context.trackedObjects.add(thisObject) の短縮形です。 このオブジェクトを .sync 呼び出しと ".run" バッチの連続実行の外部で使用していて、プロパティを設定したり、オブジェクトでメソッドを呼び出したりするときに "InvalidObjectPath" エラーが発生する場合は、オブジェクトが最初に作成されたときに、追跡対象のオブジェクト コレクションにオブジェクトを追加する必要があります。 このオブジェクトがコレクションの一部である場合は、親コレクションも追跡する必要があります。

untrack()

前に追跡されていた場合、このオブジェクトに関連付けられているメモリを解放します。 この呼び出しは、 context.trackedObjects.remove(thisObject) の省略形です。 追跡対象オブジェクトが多いとホスト アプリケーションの動作が遅くなります。追加したオブジェクトが不要になったら、必ずそれを解放してください。 メモリ リリースを有効にする前に、 context.sync() を呼び出す必要があります。

プロパティの詳細

body

ドキュメントの Body オブジェクトを取得します。 本文は、ヘッダー、フッター、脚注、テキスト ボックスなどを除いたテキストです。

readonly body: Word.Body;

プロパティ値

注釈

API セット: WordApiHiddenDocument 1.3

contentControls

ドキュメント内の ContentControl オブジェクトのコレクションを取得します。 これには、ドキュメント本文のコンテンツ コントロール、ヘッダー、フッター、テキスト ボックスなどが含まれます。

readonly contentControls: Word.ContentControlCollection;

プロパティ値

注釈

API セット: WordApiHiddenDocument 1.3

context

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

context: RequestContext;

プロパティ値

customXmlParts

ドキュメント内のカスタム XML パーツを取得します。

readonly customXmlParts: Word.CustomXmlPartCollection;

プロパティ値

注釈

API セット: WordApiHiddenDocument 1.4

properties

ドキュメントのプロパティを取得します。

readonly properties: Word.DocumentProperties;

プロパティ値

注釈

API セット: WordApiHiddenDocument 1.3

saved

ドキュメント内の変更が保存されているかどうかを示します。 値 true は、ドキュメントが保存されてから変更されていないことを示します。

readonly saved: boolean;

プロパティ値

boolean

注釈

API セット: WordApiHiddenDocument 1.3

sections

ドキュメント内の Section オブジェクトのコレクションを取得します。

readonly sections: Word.SectionCollection;

プロパティ値

注釈

API セット: WordApiHiddenDocument 1.3

settings

ドキュメント内のアドインの設定を取得します。

readonly settings: Word.SettingCollection;

プロパティ値

注釈

API セット: WordApiHiddenDocument 1.4

メソッドの詳細

addStyle(name, type)

名前と種類で文書にスタイルを追加します。

addStyle(name: string, type: Word.StyleType): Word.Style;

パラメーター

name

string

スタイル名を表す文字列。

type
Word.StyleType

文字、リスト、段落、表などのスタイルの種類。

返品

注釈

API セット: WordApiHiddenDocument 1.5

addStyle(name, type)

名前と種類で文書にスタイルを追加します。

addStyle(name: string, type: "Character" | "List" | "Paragraph" | "Table"): Word.Style;

パラメーター

name

string

スタイル名を表す文字列。

type

"Character" | "List" | "Paragraph" | "Table"

文字、リスト、段落、表などのスタイルの種類。

返品

注釈

API セット: WordApiHiddenDocument 1.5

deleteBookmark(name)

ブックマークが存在する場合は、ブックマークをドキュメントから削除します。

deleteBookmark(name: string): void;

パラメーター

name

string

大文字と小文字を区別しないブックマーク名。

返品

void

注釈

API セット: WordApiHiddenDocument 1.4

getBookmarkRange(name)

ブックマークの範囲を取得します。 ブックマークが存在しない場合は、 ItemNotFound エラーをスローします。

getBookmarkRange(name: string): Word.Range;

パラメーター

name

string

大文字と小文字を区別しないブックマーク名。

返品

注釈

API セット: WordApiHiddenDocument 1.4

getBookmarkRangeOrNullObject(name)

ブックマークの範囲を取得します。 ブックマークが存在しない場合、このメソッドは、 isNullObject プロパティが true に設定されたオブジェクトを返します。 詳細については、「 *OrNullObject のメソッドとプロパティ」を参照してください。

getBookmarkRangeOrNullObject(name: string): Word.Range;

パラメーター

name

string

大文字と小文字を区別しないブックマーク名。 英数字とアンダースコア文字のみがサポートされています。 先頭は文字で始まる必要がありますが、ブックマークに非表示のタグを付ける場合は、名前にアンダースコア文字を付けます。 名前は 40 文字以内でなければなりません。

返品

注釈

API セット: WordApiHiddenDocument 1.4

getContentControls(options)

ドキュメント内の現在サポートされているコンテンツ コントロールを取得します。

getContentControls(options?: Word.ContentControlOptions): Word.ContentControlCollection;

パラメーター

options
Word.ContentControlOptions

省略可能。 返されるコンテンツ コントロールを定義するオプション。

返品

注釈

API セット: WordApiHiddenDocument 1.5

重要: options パラメーターに特定の型が指定されている場合、サポートされている型のコンテンツ コントロールのみが返されます。 汎用 Word のメソッドを使用すると例外がスローされることに注意してください。特定の型に関連しない ContentControl。 時間の経過とともに、追加の種類のコンテンツ コントロールがサポートされる可能性があります。 そのため、アドインでは、特定の種類のコンテンツ コントロールを要求および処理する必要があります。

getStyles()

ドキュメントのスタイル セット全体を表す StyleCollection オブジェクトを取得します。

getStyles(): Word.StyleCollection;

返品

注釈

API セット: WordApiHiddenDocument 1.5

insertFileFromBase64(base64File, insertLocation, insertFileOptions)

追加プロパティを使用してターゲット ドキュメントの特定の位置にドキュメントを挿入します。 ヘッダー、フッター、透かし、およびその他のセクション プロパティは既定でコピーされます。 挿入する文書の最大サイズは 4 MB です。

insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End", insertFileOptions?: Word.InsertFileOptions): Word.SectionCollection;

パラメーター

base64File

string

.docx ファイルの Base64 でエンコードされたコンテンツ。

insertLocation

replace | start | end | "Replace" | "Start" | "End"

値は、 replace、 start、または end である必要があります。

insertFileOptions
Word.InsertFileOptions

省略可能。 リンク先ドキュメントにインポートする必要がある追加プロパティ。

返品

注釈

API セット: WordApiHiddenDocument 1.5

挿入するドキュメントに ActiveX コントロール (フォーム フィールドにある可能性があります) が含まれている場合、挿入はサポートされません。 このようなフォーム フィールドを、シナリオに適したコンテンツ コントロールまたはその他のオプションに置き換えることを検討してください。

ドキュメントを挿入するときに、ドキュメントの設定は保持されません。

load(options)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(options?: Word.Interfaces.DocumentCreatedLoadOptions): Word.DocumentCreated;

パラメーター

options
Word.Interfaces.DocumentCreatedLoadOptions

読み込むオブジェクトのプロパティのオプションを指定します。

返品

load(propertyNames)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames?: string | string[]): Word.DocumentCreated;

パラメーター

propertyNames

string | string[]

読み込むプロパティを指定するコンマ区切りの文字列または文字列の配列。

返品

load(propertyNamesAndPaths)

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Word.DocumentCreated;

パラメーター

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select は読み込むプロパティを指定するコンマ区切りの文字列であり、 propertyNamesAndPaths.expand は読み込むナビゲーションのプロパティを指定するコンマ区切りの文字列です。

返品

open()

ドキュメントを開きます。

open(): void;

返品

void

注釈

API セット: WordApi 1.3

例

// Create and open a new document in a new tab or window.
await Word.run(async (context) => {
    const externalDoc = context.application.createDocument();
    await context.sync();

    externalDoc.open();
    await context.sync();
});

save(saveBehavior, fileName)

ドキュメントを保存します。

save(saveBehavior?: Word.SaveBehavior, fileName?: string): void;

パラメーター

saveBehavior
Word.SaveBehavior

省略可能。 DocumentCreated save のみをサポートしています。

fileName

string

省略可能。 ファイル名 (ファイル拡張子を除く)。 新しいドキュメントに対してのみ有効です。

返品

void

注釈

API セット: WordApiHiddenDocument 1.3

注: saveBehavior パラメーターと fileName パラメーターは、WordApiHiddenDocument 1.5 で導入されました。

save(saveBehavior, fileName)

ドキュメントを保存します。

save(saveBehavior?: "Save" | "Prompt", fileName?: string): void;

パラメーター

saveBehavior

"Save" | "Prompt"

省略可能。 DocumentCreated save のみをサポートしています。

fileName

string

省略可能。 ファイル名 (ファイル拡張子を除く)。 新しいドキュメントに対してのみ有効です。

返品

void

注釈

API セット: WordApiHiddenDocument 1.3

注: saveBehavior パラメーターと fileName パラメーターは、WordApiHiddenDocument 1.5 で導入されました。

set(properties, options)

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。

set(properties: Interfaces.DocumentCreatedUpdateData, options?: OfficeExtension.UpdateOptions): void;

パラメーター

properties
Word.Interfaces.DocumentCreatedUpdateData

メソッドが呼び出されたオブジェクトのプロパティと同型構造のプロパティを持つ JavaScript オブジェクト。

options
OfficeExtension.UpdateOptions

プロパティ オブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。

返品

void

set(properties)

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

set(properties: Word.DocumentCreated): void;

パラメーター

返品

void

toJSON()

API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (次に、JSON.stringify渡されたオブジェクトの toJSON メソッドを呼び出します)。元の Word.DocumentCreated オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Word.Interfaces.DocumentCreatedData と型指定) を返します。

toJSON(): Word.Interfaces.DocumentCreatedData;

返品

track()

ドキュメントの環境変更に基づいて自動的に調整する目的でオブジェクトを追跡します。 この呼び出しは、 context.trackedObjects.add(thisObject) の短縮形です。 このオブジェクトを .sync 呼び出しと ".run" バッチの連続実行の外部で使用していて、プロパティを設定したり、オブジェクトでメソッドを呼び出したりするときに "InvalidObjectPath" エラーが発生する場合は、オブジェクトが最初に作成されたときに、追跡対象のオブジェクト コレクションにオブジェクトを追加する必要があります。 このオブジェクトがコレクションの一部である場合は、親コレクションも追跡する必要があります。

track(): Word.DocumentCreated;

返品

untrack()

前に追跡されていた場合、このオブジェクトに関連付けられているメモリを解放します。 この呼び出しは、 context.trackedObjects.remove(thisObject) の省略形です。 追跡対象オブジェクトが多いとホスト アプリケーションの動作が遅くなります。追加したオブジェクトが不要になったら、必ずそれを解放してください。 メモリ リリースを有効にする前に、 context.sync() を呼び出す必要があります。

untrack(): Word.DocumentCreated;

返品