.NET でスタイルを操作する方法

ステップ 1: パッケージをインストールする

Aspose.Words FOSS for .NET はまだ NuGet パッケージを公開していないため、代わりにソースからライブラリをビルドしてください。https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git をクローンし、.NET SDK を使用して Release 構成で Aspose.Words.sln をビルドし、生成された Aspose.Words アセンブリをプロジェクトから参照します。このライブラリは .NET Standard 2.0 をターゲットにしているので、.NET Framework 4.6.2+ および .NET 6/8/10 上で動作します。

ステップ 2: 必要なクラスをインポートする

using Aspose.Words; ディレクティブを追加します – Style、StyleCollection、TableStyle、StyleType、StyleIdentifier、ConditionalStyle、ConditionalStyleCollection、および ConditionalStyleType はすべて Aspose.Words 名前空間にあり、Document と同じ場所にあります。

ステップ 3: ドキュメントのスタイル コレクションを読み取る

Document.Styles は StyleCollection を返します――ドキュメントに付随するすべての組み込みおよびユーザー定義の Style。StyleCollection.Count は保持しているスタイル数を報告し、DefaultFont / DefaultParagraphFormat は、明示的なスタイルが適用される前に新しいコンテンツが継承するドキュメント全体のデフォルト書式設定を説明します。

ステップ 4: スタイルを確実に検索する

表示名を使用して StyleCollection インデクサー、styles[name] でスタイルを取得します。組み込みスタイルの場合は、代わりに同じインデクサーに StyleIdentifier 列挙型の値を使用することを推奨します――styles[sti]――名前はローカライズされますが、StyleIdentifier の値はローカライズされないため、識別子による検索はドキュメントの言語に関係なく同じように機能します。インデクサーが期待するものを見つけられない場合は、同じスタイルに対して Word が認識する代替名があるか Style.Aliases を確認し、スタイルをプログラムで削除または名前変更する前に Style.BuiltIn を確認してください。組み込みスタイルは文書内の他の場所で名前で参照されていることが多いためです。

ステップ 5: スタイルを段落またはランに適用する

スタイルを保持する書式オブジェクトは、Style プロパティ（Style オブジェクト自体）と StyleName プロパティ（名前でスタイルを解決または作成するショートカット）の両方を公開します。段落スタイルを適用するには ParagraphFormat.Style または ParagraphFormat.StyleName を設定し、ランの書式に文字スタイルを適用するには Font.Style または Font.StyleName を設定します。コレクションに存在しない名前で StyleName を割り当てるとそのスタイルが作成されます――まず StyleCollection インデクサーでスタイルの存在を確認するか、意図した動作でない場合は Style オブジェクトを直接割り当ててください。

ステップ 6: スタイル階層を構築する

BaseStyleName を読み取って、特定のスタイルが未設定の書式を継承する元となるスタイルを取得し、LinkedStyleName は段落/文字スタイルのペア（Word が組み込みスタイル、たとえば見出しとそれにリンクした文字スタイルとして定義するもの）を取得し、NextParagraphStyleName はこのスタイルを使用した段落の後に入力された新しい段落に Word が割り当てるスタイルを取得します。関連するスタイルのセットを定義する際は、すべてのスタイルで同じ書式を繰り返す代わりに、ベーススタイルからフォント選択を継承させる見出しスタイルのファミリーなど、BaseStyleName を設定してください。

ステップ 7: スタイルを作成またはコピー

StyleCollection.Add(type, name) を StyleType（Paragraph、Character、Table、または List）と名前で呼び出し、新しい空のスタイルを作成し、必要に応じてその Font と ParagraphFormat プロパティを設定します。既存のスタイル（別の Document の StyleCollection からのものも含む）を複製するには、すべての書式プロパティを手動で読み取って再適用する代わりに、StyleCollection.AddCopy(style) を呼び出します。Style.Remove() を呼び出して、コレクションからスタイルを削除します。

ステップ 8: テーブルスタイルと条件付き書式を設定

TableStyle は Style をテーブルレイアウトプロパティ（Alignment、CellSpacing、LeftIndent、Shading、VerticalAlignment、および 4 つのパディングプロパティ（LeftPadding、RightPadding、TopPadding、BottomPadding））で拡張し、さらに RowStripe と ColumnStripe を加えます。これらはバンドパターンが繰り返される行数または列数を制御します。領域ごとの書式設定には、TableStyle.ConditionalStyles を構成します——これは各領域ごとに 1 つの ConditionalStyle を保持する ConditionalStyleCollection で、FirstRow、LastRow、FirstColumn、LastColumn、OddRowBanding、EvenRowBanding、OddColumnBanding、EvenColumnBanding、および 4 つのコーナーセル（TopLeftCell、TopRightCell、BottomLeftCell、BottomRightCell）が対象です。各 ConditionalStyle はそれぞれ固有の Font、ParagraphFormat、Shading、Borders、およびセルパディングを持ち、Type がそれが表す ConditionalStyleType 領域を報告します。テーブルの個別行ではなくこれらの領域に書式を設定することで、バンド付き、ヘッダー行、またはコーナーセルの書式がテーブル編集後も維持されます。

ステップ 9: 書式のリセットまたは削除

ConditionalStyle.ClearFormatting() を呼び出して 1 つの条件領域をリセットするか、ConditionalStyleCollection.ClearFormatting() を呼び出して TableStyle 上のすべての領域を一度にリセットします。StyleCollection.ClearQuickStyleGallery() は、スタイル自体は削除せずに Word UI のクイックスタイルギャラリーからすべてのスタイルを除去します――ドキュメント内容に手を加えずにギャラリーを縮小したいときに便利です。