Word.PageSetup class

Wordドキュメントまたはセクションのページ設定設定を表します。

Extends

プロパティ

bookFoldPrinting

Microsoft Wordドキュメントを小冊子として印刷するかどうかを指定します。

bookFoldPrintingSheets

各小冊子のページ数を指定します。

bookFoldReversePrinting

Microsoft Wordが双方向またはアジア言語ドキュメントのブックフォールド印刷の印刷順序を逆にするかどうかを指定します。

bottomMargin

ページの下端と本文テキストの下の境界との間の距離 (ポイント単位) を指定します。

charsLine

文書グリッド内の 1 行あたりの文字数を指定します。

context

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

differentFirstPageHeaderFooter

最初のページに別のヘッダーとフッターがあるかどうかを指定します。

footerDistance

フッターとページの下部との距離をポイント単位で指定します。

gutter

ドキュメントまたはセクション内の各ページに追加される余分な余白領域の量 (ポイント単位) を指定してバインドします。

gutterPosition

文書に余白を表示する側を指定します。

gutterStyle

Microsoft Wordが、右から左の言語または左から右の言語に基づいて、現在のドキュメントの余白を使用するかどうかを指定します。

headerDistance

ヘッダーとページ上部の間の距離をポイント単位で指定します。

layoutMode

現在のドキュメントのレイアウト モードを指定します。

leftMargin

ページの左端と本文テキストの左端との距離をポイント単位で指定します。

lineNumbering

PageSetup オブジェクトの行番号を表すLineNumbering オブジェクトを指定します。

linesPage

ドキュメント グリッド内のページあたりの行数を指定します。

mirrorMargins

ページの内側と外側の余白が同じ幅かどうかを指定します。

oddAndEvenPagesHeaderFooter

奇数ページと偶数ページのヘッダーとフッターが異なるかどうかを指定します。

orientation

ページの向きを指定します。

pageHeight

ページの高さをポイント単位で指定します。

pageWidth

ページ幅をポイント単位で指定します。

paperSize

ページの用紙サイズを指定します。

rightMargin

ページの右端と本文テキストの右境界との間の距離 (ポイント単位) を指定します。

sectionDirection

指定したセクションの読み取り順序と配置を指定します。

sectionStart

指定したオブジェクトのセクション区切りの種類を指定します。

showGrid

グリッドを表示するかどうかを指定します。

suppressEndnotes

endnotes を抑制しない次のセクションの末尾にエンドノーツを出力するかどうかを指定します。

textColumns

PageSetup オブジェクトのテキスト列のセットを表すTextColumnCollection オブジェクトを取得します。

topMargin

ページの上余白をポイント単位で指定します。

twoPagesOnOne

シートごとに 2 ページ印刷するかどうかを指定します。

verticalAlignment

文書またはセクション内の各ページのテキストの垂直方向の配置を指定します。

メソッド

load(options)

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

load(propertyNames)

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

load(propertyNamesAndPaths)

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

set(properties, options)

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

set(properties)

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

setAsTemplateDefault()

指定されたページ設定を、作業中の文書および現在使用しているテンプレートを使って作成する新規文書の既定値として設定します。

togglePortrait()

文書またはセクションのページの縦横の方向を切り替えます。

toJSON()

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

track()

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

untrack()

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

プロパティの詳細

bookFoldPrinting

Microsoft Wordドキュメントを小冊子として印刷するかどうかを指定します。

bookFoldPrinting: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

bookFoldPrintingSheets

各小冊子のページ数を指定します。

bookFoldPrintingSheets: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

bookFoldReversePrinting

Microsoft Wordが双方向またはアジア言語ドキュメントのブックフォールド印刷の印刷順序を逆にするかどうかを指定します。

bookFoldReversePrinting: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

bottomMargin

ページの下端と本文テキストの下の境界との間の距離 (ポイント単位) を指定します。

bottomMargin: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

charsLine

文書グリッド内の 1 行あたりの文字数を指定します。

charsLine: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

context

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

context: RequestContext;

プロパティ値

differentFirstPageHeaderFooter

最初のページに別のヘッダーとフッターがあるかどうかを指定します。

differentFirstPageHeaderFooter: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

footerDistance

フッターとページの下部との距離をポイント単位で指定します。

footerDistance: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

gutter

ドキュメントまたはセクション内の各ページに追加される余分な余白領域の量 (ポイント単位) を指定してバインドします。

gutter: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

gutterPosition

文書に余白を表示する側を指定します。

gutterPosition: Word.GutterPosition | "Left" | "Right" | "Top";

プロパティ値

Word.GutterPosition | "Left" | "Right" | "Top"

注釈

API セット: WordApiDesktop 1.3

gutterStyle

Microsoft Wordが、右から左の言語または左から右の言語に基づいて、現在のドキュメントの余白を使用するかどうかを指定します。

gutterStyle: Word.GutterStyle | "Bidirectional" | "Latin";

プロパティ値

Word.GutterStyle | "Bidirectional" | "Latin"

注釈

API セット: WordApiDesktop 1.3

headerDistance

ヘッダーとページ上部の間の距離をポイント単位で指定します。

headerDistance: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

layoutMode

現在のドキュメントのレイアウト モードを指定します。

layoutMode: Word.LayoutMode | "Default" | "Grid" | "LineGrid" | "Genko";

プロパティ値

Word.LayoutMode | "Default" | "Grid" | "LineGrid" | "Genko"

注釈

API セット: WordApiDesktop 1.3

leftMargin

ページの左端と本文テキストの左端との距離をポイント単位で指定します。

leftMargin: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

lineNumbering

PageSetup オブジェクトの行番号を表すLineNumbering オブジェクトを指定します。

lineNumbering: Word.LineNumbering;

プロパティ値

注釈

API セット: WordApiDesktop 1.3

linesPage

ドキュメント グリッド内のページあたりの行数を指定します。

linesPage: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

mirrorMargins

ページの内側と外側の余白が同じ幅かどうかを指定します。

mirrorMargins: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

oddAndEvenPagesHeaderFooter

奇数ページと偶数ページのヘッダーとフッターが異なるかどうかを指定します。

oddAndEvenPagesHeaderFooter: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

orientation

ページの向きを指定します。

orientation: Word.PageOrientation | "Portrait" | "Landscape";

プロパティ値

Word.PageOrientation | "Portrait" | "Landscape"

注釈

API セット: WordApiDesktop 1.3

pageHeight

ページの高さをポイント単位で指定します。

pageHeight: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

pageWidth

ページ幅をポイント単位で指定します。

pageWidth: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

paperSize

ページの用紙サイズを指定します。

paperSize: Word.PaperSize | "Size10x14" | "Size11x17" | "Letter" | "LetterSmall" | "Legal" | "Executive" | "A3" | "A4" | "A4Small" | "A5" | "B4" | "B5" | "CSheet" | "DSheet" | "ESheet" | "FanfoldLegalGerman" | "FanfoldStdGerman" | "FanfoldUS" | "Folio" | "Ledger" | "Note" | "Quarto" | "Statement" | "Tabloid" | "Envelope9" | "Envelope10" | "Envelope11" | "Envelope12" | "Envelope14" | "EnvelopeB4" | "EnvelopeB5" | "EnvelopeB6" | "EnvelopeC3" | "EnvelopeC4" | "EnvelopeC5" | "EnvelopeC6" | "EnvelopeC65" | "EnvelopeDL" | "EnvelopeItaly" | "EnvelopeMonarch" | "EnvelopePersonal" | "Custom";

プロパティ値

Word.PaperSize | "Size10x14" | "Size11x17" | "Letter" | "LetterSmall" | "Legal" | "Executive" | "A3" | "A4" | "A4Small" | "A5" | "B4" | "B5" | "CSheet" | "DSheet" | "ESheet" | "FanfoldLegalGerman" | "FanfoldStdGerman" | "FanfoldUS" | "Folio" | "Ledger" | "Note" | "Quarto" | "Statement" | "Tabloid" | "Envelope9" | "Envelope10" | "Envelope11" | "Envelope12" | "Envelope14" | "EnvelopeB4" | "EnvelopeB5" | "EnvelopeB6" | "EnvelopeC3" | "EnvelopeC4" | "EnvelopeC5" | "EnvelopeC6" | "EnvelopeC65" | "EnvelopeDL" | "EnvelopeItaly" | "EnvelopeMonarch" | "EnvelopePersonal" | "Custom"

注釈

API セット: WordApiDesktop 1.3

rightMargin

ページの右端と本文テキストの右境界との間の距離 (ポイント単位) を指定します。

rightMargin: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

sectionDirection

指定したセクションの読み取り順序と配置を指定します。

sectionDirection: Word.SectionDirection | "RightToLeft" | "LeftToRight";

プロパティ値

Word.SectionDirection | "RightToLeft" | "LeftToRight"

注釈

API セット: WordApiDesktop 1.3

sectionStart

指定したオブジェクトのセクション区切りの種類を指定します。

sectionStart: Word.SectionStart | "Continuous" | "NewColumn" | "NewPage" | "EvenPage" | "OddPage";

プロパティ値

Word.SectionStart | "Continuous" | "NewColumn" | "NewPage" | "EvenPage" | "OddPage"

注釈

API セット: WordApiDesktop 1.3

showGrid

グリッドを表示するかどうかを指定します。

showGrid: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

suppressEndnotes

endnotes を抑制しない次のセクションの末尾にエンドノーツを出力するかどうかを指定します。

suppressEndnotes: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

textColumns

PageSetup オブジェクトのテキスト列のセットを表すTextColumnCollection オブジェクトを取得します。

readonly textColumns: Word.TextColumnCollection;

プロパティ値

注釈

API セット: WordApiDesktop 1.3

topMargin

ページの上余白をポイント単位で指定します。

topMargin: number;

プロパティ値

number

注釈

API セット: WordApiDesktop 1.3

twoPagesOnOne

シートごとに 2 ページ印刷するかどうかを指定します。

twoPagesOnOne: boolean;

プロパティ値

boolean

注釈

API セット: WordApiDesktop 1.3

verticalAlignment

文書またはセクション内の各ページのテキストの垂直方向の配置を指定します。

verticalAlignment: Word.PageSetupVerticalAlignment | "Top" | "Center" | "Justify" | "Bottom";

プロパティ値

Word.PageSetupVerticalAlignment | "Top" | "Center" | "Justify" | "Bottom"

注釈

API セット: WordApiDesktop 1.3

メソッドの詳細

load(options)

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

load(options?: Word.Interfaces.PageSetupLoadOptions): Word.PageSetup;

パラメーター

options
Word.Interfaces.PageSetupLoadOptions

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

返品

load(propertyNames)

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

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

パラメーター

propertyNames

string | string[]

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

返品

load(propertyNamesAndPaths)

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

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

パラメーター

propertyNamesAndPaths

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

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

返品

set(properties, options)

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

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

パラメーター

properties
Word.Interfaces.PageSetupUpdateData

メソッドが呼び出されるオブジェクトのプロパティに等形的に構造化されたプロパティを持つ JavaScript オブジェクト。

options
OfficeExtension.UpdateOptions

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

返品

void

set(properties)

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

set(properties: Word.PageSetup): void;

パラメーター

properties
Word.PageSetup

返品

void

setAsTemplateDefault()

指定されたページ設定を、作業中の文書および現在使用しているテンプレートを使って作成する新規文書の既定値として設定します。

setAsTemplateDefault(): void;

返品

void

注釈

API セット: WordApiDesktop 1.3

togglePortrait()

文書またはセクションのページの縦横の方向を切り替えます。

togglePortrait(): void;

返品

void

注釈

API セット: WordApiDesktop 1.3

toJSON()

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

toJSON(): Word.Interfaces.PageSetupData;

返品

track()

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

track(): Word.PageSetup;

返品

untrack()

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

untrack(): Word.PageSetup;

返品