.NETでリストを扱う方法

ステップ 1: 段落にリストを適用する

段落の書式設定に ListFormat.ApplyBulletDefault() または ApplyNumberDefault() を使用すると、Word のデフォルトの箇条書きまたは番号付きリストをワンコールで適用できます — これが標準リストを適用する最も迅速な方法です。デフォルトではなく特定の事前定義フォーマットを使用する場合は、Document.Lists（ListCollection）.Add(listTemplate) を呼び出し、ListTemplate 値として BulletDisk、BulletSquare、NumberArabicDot、または NumberUppercaseRomanDot を指定して、Word の組み込みフォーマットのいずれかから List を作成するか、単一レベルのバリアントとして AddSingleLevelList(listTemplate) を使用します。段落にリスト書式が設定されると、ListFormat.IsListItem は true を報告し、ListFormat.List/ListLevelNumber が使用しているリストとレベルを特定します。

ステップ 2: 新しい段落グループに独立した番号付けを設定する

段落の ListFormat.List が同じ共有 List オブジェクトを指している場合、同じカウンタが継続されます。新しい段落グループで番号付けを 1 から独立して再開する必要がある場合は、ListCollection.AddCopy(srcList) を呼び出して既存のリスト定義を複製し、元のリストを再利用する代わりにそのコピーを新しい段落に適用します。ListCollection.GetListByListId(listId) は、ListId によって特定のリストを取得します（作成せずに検索したいとき）。Count は、現在のドキュメントに存在するリストの数を報告します。

ステップ 3: リスト レベル間で段落を移動する

段落をリスト内で 1 レベル深く移動するには ListFormat.ListIndent() を使用し、1 レベル浅く移動するには ListOutdent() を使用します — これは、リスト段落の先頭で Word が Tab と Shift+Tab に対して行う操作と同じです。ListLevelNumber を直接設定するよりもこれらの方法を優先してください。これにより段落のリスト書式が内部的に一貫した状態に保たれます。段落からリスト書式を完全に除去するには RemoveNumbers() を呼び出します。

ステップ 4: リスト レベルの番号書式をカスタマイズする

List.ListLevels（ListLevelCollection）で特定のレベルに到達し、次に ListLevel.NumberStyle（NumberStyle の値で、たとえば Arabic、UppercaseRoman、LowercaseLetter、または Bullet）と NumberFormat を設定します — これは番号と句点や括弧などのリテラル文字列を組み合わせた書式文字列です — これらは一緒に設定する必要があり、ペアが一致しないと予期しない描画が発生します。StartAt はレベルの開始番号を設定し、RestartAfterLevel はどの上位レベルのインクリメントがこのレベルのカウンタを再起動するかを制御します — デフォルトの再起動動作に頼らず、入れ子リストでは明示的に設定してください。Alignment（Left、Center、Right）と TrailingCharacter（Tab、Space、Nothing）はラベルの位置とラベルと段落テキスト間の区切り文字を制御し、TabPosition、NumberPosition、TextPosition は正確なレイアウトのために使用します。IsLegal は NumberStyle に関係なく、常にアラビア数字の法的スタイル番号付けを強制します。

ステップ 5: リスト レベルに画像バレットを追加する

対象レベルで ListLevel.CreatePictureBullet() を呼び出して画像バレット定義を作成し、次にバレットの ImageData を指定します。その後、同じレベルに既存のテキストバレット書式があれば削除します。画像バレットを削除してテキストベースのバレット書式に戻すには DeletePictureBullet() を呼び出します。

ステップ 6: リスト項目のレンダリング済みラベルを検査する

ListLabel は、アイテムの段落書式設定から取得される、リスト項目インスタンスに実際に描画されるラベルを表します。LabelString は Word が表示するリテラルテキストで、例えば「3.」や「•」です。LabelValue は基礎となる数値で、Font は段落テキストの書式設定とは独立したラベル自身の書式設定です。リスト全体を描画せずにシーケンス内の任意の位置でラベルの値を計算するには、ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) を呼び出してください。