スタイルテキストを追加
IronWord の"スタイルテキストの追加"機能により、開発者は DOCX ドキュメントにコンテンツを追加しながらさまざまなテキストスタイル オプションを適用できます。 フォントファミリー、サイズ、色、および strike-through などのスタイル属性の指定など、テキストの外観をきめ細かく制御できます。 Run を含む TextContent オブジェクトを作成し、TextStyle を Run に割り当てることで、開発者はドキュメント内の個々のテキスト要素の表示を調整し、カスタマイズされた外観と操作感を実現できます。
この機能は、特定のセクションが異なるスタイルを必要とするレポートや手紙など、プロフェッショナルにフォーマットされたドキュメントを動的に生成するのに便利です。 TextStyle クラスを使用すると、これらの属性を簡単に操作でき、同じドキュメント内で単純なスタイル設定から複雑なスタイル設定まで行うことが可能になります。
重要なポイント
1.スタイルランの作成:
Runオブジェクトが作成され、その中に希望のテキストを含むTextContentが格納されます。RunのStyleプロパティには、書式設定を適用するためにTextStyleオブジェクトが割り当てられます。FontSize
- TextStyle の設定:
TextStyle: 文字サイズを指定するには、TextStyleレベル(Font内ではなく)で設定してください。TextFont: フォント選択用のfontFamilyを含むフォントプロパティが含まれています。FontFamilyColor:colorを使用してテキストの色を指定します。IronWord.Models.Colorboldおよびitalic: 太字および斜体書式設定用のブール型プロパティ。IsBoldunderline: テキストに下線スタイルを追加します。IsItalicstrike-through:StrikeValue列挙型を使用して取り消し線形式を適用します。UnderlineStrike
3.ドキュメントへの追加:
AddChildを使用して、Runにスタイルが適用されたParagraphを追加します。- その後、この段落は
AddParagraphとともにドキュメントに追加されます。
コードの説明
このコードは、IronWord を使用して DOCX ドキュメント内のテキストを作成およびスタイル設定する方法を示しています。 まず、生成するドキュメントを表す新しい WordDocument オブジェクトを初期化します。 Run オブジェクトが作成され、その中に文字列"Styled text example"を含む TextContent が格納されます。また、テキストの外観を設定するために、TextStyle が Run に適用されます。
TextStyle には、TextStyle レベル(Font 内ではなく)で設定されたフォントサイズ、fontFamily 経由で設定されたフォントファミリー、TextFont テキスト color、および bold 書式設定が含まれます。 これらの設定は、最終的なドキュメントでテキストがどのように表示されるかをカスタマイズします。
Run のスタイル設定が完了すると、AddChild メソッドは Run オブジェクトをドキュメント内の段落に追加します。 このメソッドは、スタイル付きコンテンツを適切な形式で Word ドキュメントに挿入します。 最後に、SaveAs メソッドを呼び出し、ドキュメントを"styled_document.docx"としてエクスポートします。 その結果、指定されたスタイルに従って挿入されたテキストがフォーマットされ、すべてのフォントとフォーマットのプロパティが出力ファイル内で保持されます。

