Word.List class
Wordのコレクションを格納します。Paragraph オブジェクト。
- Extends
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/insert-list.yaml
// This example starts a new list with the second paragraph.
await Word.run(async (context) => {
const paragraphs = context.document.body.paragraphs;
paragraphs.load("$none");
await context.sync();
// Start new list using the second paragraph.
const list = paragraphs.items[1].startNewList();
list.load("$none");
await context.sync();
// To add new items to the list, use Start or End on the insertLocation parameter.
list.insertParagraph("New list item at the start of the list", "Start");
const paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");
// Set up list level for the list item.
paragraph.listItem.level = 4;
// To add paragraphs outside the list, use Before or After.
list.insertParagraph("New paragraph goes after (not part of the list)", "After");
await context.sync();
});
プロパティ
| context | オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。 |
| id | リストの ID を取得します。 |
| level |
リストに 9 つのレベルがそれぞれ存在するかどうかを確認します。 true 値は、レベルが存在することを示します。つまり、そのレベルには少なくとも 1 つのリスト アイテムがあります。 |
| level |
リスト内の 9 レベルのすべての種類を取得します。 各型には、'Bullet'、'Number'、または 'Picture' を指定できます。 |
| paragraphs | リスト内の段落を取得します。 読み取り専用です。 |
メソッド
| get |
リスト内の指定したレベルの箇条書き、数値、または図のフォントを取得します。 |
| get |
リスト内の指定したレベルで発生する段落を取得します。 |
| get |
リスト内の指定したレベルの画像の Base64 でエンコードされた文字列表現を取得します。 |
| get |
指定したレベルの箇条書き、数値、または図を文字列として取得します。 |
| insert |
指定した位置に、段落を挿入します。 |
| load(options) | オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| reset |
箇条書き、数字、または図のフォントをリスト内の指定したレベルにリセットします。 |
| set |
箇条書き、数値、または図の配置を、リスト内の指定されたレベルに設定します。 |
| set |
箇条書き、数値、または図の配置を、リスト内の指定されたレベルに設定します。 |
| set |
リスト内の指定したレベルで行頭文字の書式を設定します。 行頭文字が 'Custom' の場合は、charCode が必要です。 |
| set |
リスト内の指定したレベルで行頭文字の書式を設定します。 行頭文字が 'Custom' の場合は、charCode が必要です。 |
| set |
リスト内の指定したレベルの 2 つのインデントを設定します。 |
| set |
リスト内の指定したレベルで番号付け書式を設定します。 |
| set |
リスト内の指定したレベルで番号付け書式を設定します。 |
| set |
一覧の指定したレベルで画像を設定します。 |
| set |
リスト内の指定したレベルで開始番号を設定します。 既定値は 1 です。 |
| toJSON() | API オブジェクトが に渡されたときにより便利な出力を提供するために、JavaScript |
| track() | ドキュメントの環境変更に基づいて自動的に調整する目的でオブジェクトを追跡します。 この呼び出しは、context.trackedObjects.add(thisObject)の短縮形です。 このオブジェクトを呼び出しで |
| untrack() | 前に追跡されていた場合、このオブジェクトに関連付けられているメモリを解放します。 この呼び出しは、context.trackedObjects.remove(thisObject)の短縮形です。 追跡対象オブジェクトが多いとホスト アプリケーションの動作が遅くなります。追加したオブジェクトが不要になったら、必ずそれを解放してください。 メモリ解放が有効になる前に を呼び出す |
プロパティの詳細
context
オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。
context: RequestContext;プロパティ値
id
levelExistences
リストに 9 つのレベルがそれぞれ存在するかどうかを確認します。 true 値は、レベルが存在することを示します。つまり、そのレベルには少なくとも 1 つのリスト アイテムがあります。
readonly levelExistences: boolean[];プロパティ値
boolean[]
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/organize-list.yaml
// Gets information about the first list in the document.
await Word.run(async (context) => {
const lists = context.document.body.lists;
lists.load("items");
await context.sync();
if (lists.items.length === 0) {
console.warn("There are no lists in this document");
return;
}
// Get the first list.
const list = lists.getFirst();
list.load("levelTypes,levelExistences");
await context.sync();
const levelTypes = list.levelTypes;
console.log("Level types of the first list:");
for (let i = 0; i < levelTypes.length; i++) {
console.log(`- Level ${i + 1} (index ${i}): ${levelTypes[i]}`);
}
const levelExistences = list.levelExistences;
console.log("Level existences of the first list:");
for (let i = 0; i < levelExistences.length; i++) {
console.log(`- Level ${i + 1} (index ${i}): ${levelExistences[i]}`);
}
});
levelTypes
リスト内の 9 レベルのすべての種類を取得します。 各型には、'Bullet'、'Number'、または 'Picture' を指定できます。
readonly levelTypes: Word.ListLevelType[];プロパティ値
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/organize-list.yaml
// Gets information about the first list in the document.
await Word.run(async (context) => {
const lists = context.document.body.lists;
lists.load("items");
await context.sync();
if (lists.items.length === 0) {
console.warn("There are no lists in this document");
return;
}
// Get the first list.
const list = lists.getFirst();
list.load("levelTypes,levelExistences");
await context.sync();
const levelTypes = list.levelTypes;
console.log("Level types of the first list:");
for (let i = 0; i < levelTypes.length; i++) {
console.log(`- Level ${i + 1} (index ${i}): ${levelTypes[i]}`);
}
const levelExistences = list.levelExistences;
console.log("Level existences of the first list:");
for (let i = 0; i < levelExistences.length; i++) {
console.log(`- Level ${i + 1} (index ${i}): ${levelExistences[i]}`);
}
});
paragraphs
リスト内の段落を取得します。 読み取り専用です。
readonly paragraphs: Word.ParagraphCollection;プロパティ値
注釈
メソッドの詳細
getLevelFont(level)
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
リスト内の指定したレベルの箇条書き、数値、または図のフォントを取得します。
getLevelFont(level: number): Word.Font;パラメーター
- level
-
number
必須です。 一覧のレベル。
戻り値
注釈
getLevelParagraphs(level)
リスト内の指定したレベルで発生する段落を取得します。
getLevelParagraphs(level: number): Word.ParagraphCollection;パラメーター
- level
-
number
必須です。 一覧のレベル。
戻り値
注釈
getLevelPicture(level)
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
リスト内の指定したレベルの画像の Base64 でエンコードされた文字列表現を取得します。
getLevelPicture(level: number): OfficeExtension.ClientResult<string>;パラメーター
- level
-
number
必須です。 一覧のレベル。
戻り値
OfficeExtension.ClientResult<string>
注釈
getLevelString(level)
指定したレベルの箇条書き、数値、または図を文字列として取得します。
getLevelString(level: number): OfficeExtension.ClientResult<string>;パラメーター
- level
-
number
必須です。 一覧のレベル。
戻り値
OfficeExtension.ClientResult<string>
注釈
insertParagraph(paragraphText, insertLocation)
指定した位置に、段落を挿入します。
insertParagraph(paragraphText: string, insertLocation: Word.InsertLocation.start | Word.InsertLocation.end | Word.InsertLocation.before | Word.InsertLocation.after | "Start" | "End" | "Before" | "After"): Word.Paragraph;パラメーター
- paragraphText
-
string
必須です。 挿入する段落テキスト。
必須です。 値は、'Start'、'End'、'Before'、または 'After' である必要があります。
戻り値
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/insert-list.yaml
// This example starts a new list with the second paragraph.
await Word.run(async (context) => {
const paragraphs = context.document.body.paragraphs;
paragraphs.load("$none");
await context.sync();
// Start new list using the second paragraph.
const list = paragraphs.items[1].startNewList();
list.load("$none");
await context.sync();
// To add new items to the list, use Start or End on the insertLocation parameter.
list.insertParagraph("New list item at the start of the list", "Start");
const paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");
// Set up list level for the list item.
paragraph.listItem.level = 4;
// To add paragraphs outside the list, use Before or After.
list.insertParagraph("New paragraph goes after (not part of the list)", "After");
await context.sync();
});
load(options)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(options?: Word.Interfaces.ListLoadOptions): Word.List;パラメーター
- options
- Word.Interfaces.ListLoadOptions
読み込むオブジェクトのプロパティのオプションを提供します。
戻り値
load(propertyNames)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(propertyNames?: string | string[]): Word.List;パラメーター
- propertyNames
-
string | string[]
読み込むプロパティを指定するコンマ区切り文字列または文字列の配列。
戻り値
load(propertyNamesAndPaths)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Word.List;パラメーター
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select は、読み込むプロパティを指定するコンマ区切り文字列で propertyNamesAndPaths.expand 、読み込むナビゲーション プロパティを指定するコンマ区切りの文字列です。
戻り値
resetLevelFont(level, resetFontName)
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
箇条書き、数字、または図のフォントをリスト内の指定したレベルにリセットします。
resetLevelFont(level: number, resetFontName?: boolean): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- resetFontName
-
boolean
オプション。 フォント名をリセットするかどうかを示します。 既定値は false で、フォント名は変更されません。
戻り値
void
注釈
setLevelAlignment(level, alignment)
箇条書き、数値、または図の配置を、リスト内の指定されたレベルに設定します。
setLevelAlignment(level: number, alignment: Word.Alignment): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- alignment
- Word.Alignment
必須です。 "左"、"中央揃え"、または "右" である必要があるレベルの配置。
戻り値
void
注釈
setLevelAlignment(level, alignmentString)
箇条書き、数値、または図の配置を、リスト内の指定されたレベルに設定します。
setLevelAlignment(level: number, alignmentString: "Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified"): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- alignmentString
-
"Mixed" | "Unknown" | "Left" | "Centered" | "Right" | "Justified"
必須です。 "左"、"中央揃え"、または "右" である必要があるレベルの配置。
戻り値
void
注釈
setLevelBullet(level, listBullet, charCode, fontName)
リスト内の指定したレベルで行頭文字の書式を設定します。 行頭文字が 'Custom' の場合は、charCode が必要です。
setLevelBullet(level: number, listBullet: Word.ListBullet, charCode?: number, fontName?: string): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- listBullet
- Word.ListBullet
必須です。 箇条書き。
- charCode
-
number
オプション。 行頭文字のコード値。 行頭文字が 'Custom' の場合にのみ使用されます。
- fontName
-
string
オプション。 箇条書きのフォント名。 行頭文字が 'Custom' の場合にのみ使用されます。
戻り値
void
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/organize-list.yaml
// Inserts a list starting with the first paragraph then set numbering and bullet types of the list items.
await Word.run(async (context) => {
const paragraphs = context.document.body.paragraphs;
paragraphs.load("$none");
await context.sync();
// Use the first paragraph to start a new list.
const list = paragraphs.items[0].startNewList();
list.load("$none");
await context.sync();
// To add new items to the list, use Start or End on the insertLocation parameter.
list.insertParagraph("New list item at the start of the list", "Start");
const paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");
// Set numbering for list level 1.
list.setLevelNumbering(0, Word.ListNumbering.arabic);
// Set bullet type for list level 5.
list.setLevelBullet(4, Word.ListBullet.arrow);
// Set list level for the last item in this list.
paragraph.listItem.level = 4;
list.load("levelTypes");
await context.sync();
});
setLevelBullet(level, listBulletString, charCode, fontName)
リスト内の指定したレベルで行頭文字の書式を設定します。 行頭文字が 'Custom' の場合は、charCode が必要です。
setLevelBullet(level: number, listBulletString: "Custom" | "Solid" | "Hollow" | "Square" | "Diamonds" | "Arrow" | "Checkmark", charCode?: number, fontName?: string): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- listBulletString
-
"Custom" | "Solid" | "Hollow" | "Square" | "Diamonds" | "Arrow" | "Checkmark"
必須です。 箇条書き。
- charCode
-
number
オプション。 行頭文字のコード値。 行頭文字が 'Custom' の場合にのみ使用されます。
- fontName
-
string
オプション。 箇条書きのフォント名。 行頭文字が 'Custom' の場合にのみ使用されます。
戻り値
void
注釈
setLevelIndents(level, textIndent, bulletNumberPictureIndent)
リスト内の指定したレベルの 2 つのインデントを設定します。
setLevelIndents(level: number, textIndent: number, bulletNumberPictureIndent: number): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- textIndent
-
number
必須です。 テキストのインデントをポイント単位で指定します。 段落左インデントと同じです。
- bulletNumberPictureIndent
-
number
必須です。 箇条書き、数字、または図の相対インデント (ポイント単位)。 これは、段落の最初の行インデントと同じです。
戻り値
void
注釈
setLevelNumbering(level, listNumbering, formatString)
リスト内の指定したレベルで番号付け書式を設定します。
setLevelNumbering(level: number, listNumbering: Word.ListNumbering, formatString?: Array<string | number>): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- listNumbering
- Word.ListNumbering
必須です。 序数形式。
- formatString
-
Array<string | number>
オプション。 文字列または整数の配列として定義された番号付け文字列形式。 各整数は、このレベル以上の数値型のレベルです。 たとえば、["(", level - 1, ".", level, ")"] の配列は"(2.c)"の形式を定義できます。ここで、2 は親の項目番号であり、c はこのレベルの項目番号です。
戻り値
void
注釈
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/20-lists/organize-list.yaml
// Inserts a list starting with the first paragraph then set numbering and bullet types of the list items.
await Word.run(async (context) => {
const paragraphs = context.document.body.paragraphs;
paragraphs.load("$none");
await context.sync();
// Use the first paragraph to start a new list.
const list = paragraphs.items[0].startNewList();
list.load("$none");
await context.sync();
// To add new items to the list, use Start or End on the insertLocation parameter.
list.insertParagraph("New list item at the start of the list", "Start");
const paragraph = list.insertParagraph("New list item at the end of the list (set to list level 5)", "End");
// Set numbering for list level 1.
list.setLevelNumbering(0, Word.ListNumbering.arabic);
// Set bullet type for list level 5.
list.setLevelBullet(4, Word.ListBullet.arrow);
// Set list level for the last item in this list.
paragraph.listItem.level = 4;
list.load("levelTypes");
await context.sync();
});
setLevelNumbering(level, listNumberingString, formatString)
リスト内の指定したレベルで番号付け書式を設定します。
setLevelNumbering(level: number, listNumberingString: "None" | "Arabic" | "UpperRoman" | "LowerRoman" | "UpperLetter" | "LowerLetter", formatString?: Array<string | number>): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- listNumberingString
-
"None" | "Arabic" | "UpperRoman" | "LowerRoman" | "UpperLetter" | "LowerLetter"
必須です。 序数形式。
- formatString
-
Array<string | number>
オプション。 文字列または整数の配列として定義された番号付け文字列形式。 各整数は、このレベル以上の数値型のレベルです。 たとえば、["(", level - 1, ".", level, ")"] の配列は"(2.c)"の形式を定義できます。ここで、2 は親の項目番号であり、c はこのレベルの項目番号です。
戻り値
void
注釈
setLevelPicture(level, base64EncodedImage)
注意
この API は開発者向けにプレビューとして提供されており、寄せられたフィードバックにもとづいて変更される場合があります。 この API は運用環境で使用しないでください。
一覧の指定したレベルで画像を設定します。
setLevelPicture(level: number, base64EncodedImage?: string): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- base64EncodedImage
-
string
オプション。 設定する Base64 でエンコードされたイメージ。 指定しない場合、既定の画像が設定されます。
戻り値
void
注釈
setLevelStartingNumber(level, startingNumber)
リスト内の指定したレベルで開始番号を設定します。 既定値は 1 です。
setLevelStartingNumber(level: number, startingNumber: number): void;パラメーター
- level
-
number
必須です。 一覧のレベル。
- startingNumber
-
number
必須です。 開始する番号。
戻り値
void
注釈
toJSON()
API オブジェクトが に渡されたときにより便利な出力を提供するために、JavaScript toJSON() メソッドを JSON.stringify()オーバーライドします。 (JSON.stringifyさらに、渡される オブジェクトの メソッドを呼び出toJSONします)。一方、元のWord。List オブジェクトは API オブジェクトです。このメソッドは、元のtoJSONオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト (としてWord.Interfaces.ListData型指定) を返します。
toJSON(): Word.Interfaces.ListData;戻り値
track()
ドキュメントの環境変更に基づいて自動的に調整する目的でオブジェクトを追跡します。 この呼び出しは、context.trackedObjects.add(thisObject)の短縮形です。 このオブジェクトを呼び出しで .sync 使用していて、".run" バッチのシーケンシャル実行の外部で使用していて、プロパティを設定するとき、またはオブジェクトのメソッドを呼び出すときに "InvalidObjectPath" エラーが発生する場合は、オブジェクトが最初に作成されたときに追跡対象のオブジェクト コレクションにオブジェクトを追加する必要があります。 このオブジェクトがコレクションの一部である場合は、親コレクションも追跡する必要があります。
track(): Word.List;戻り値
untrack()
前に追跡されていた場合、このオブジェクトに関連付けられているメモリを解放します。 この呼び出しは、context.trackedObjects.remove(thisObject)の短縮形です。 追跡対象オブジェクトが多いとホスト アプリケーションの動作が遅くなります。追加したオブジェクトが不要になったら、必ずそれを解放してください。 メモリ解放が有効になる前に を呼び出す context.sync() 必要があります。
untrack(): Word.List;戻り値
Office Add-ins
フィードバック
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください: https://aka.ms/ContentUserFeedback。
フィードバックの送信と表示