Checkboxes、テキスト入力、または画像を挿入します
マージエンジンはドキュメントを入力として受け取り、その中のMERGEFIELDフィールドを探し、データソースから取得したデータに置き換えます。 通常、プレーンテキストとHTMLが挿入されますが、Aspose.WordsユーザーはMail Mergeフィールドのより珍しいシナリオを処理する文書を生成することもできます。
強力なAspose.Words機能を使用するとMail Mergeプロセスを拡張できます:
- checkboxesおよびテキスト入力フォームフィールドをmail merge中にドキュメントに挿入します
- 任意のカスタムストレージ(ファイル、BLOBフィールドなど)から画像を挿入します。)
Mail Merge中にCheckboxesとテキスト入力を挿入します
差し込み項目でテキストが置換されるのではなく、checkboxまたはテキスト入力フィールドで置換されるように、Mail Merge操作を実行する必要がある場合があります。 これは最も一般的なシナリオではありませんが、一部のタスクでは非常に便利です。
次のWordドキュメントのスクリーンショットは、差し込み項目を含むテンプレートを示しています:
以下のWord文書のスクリーンショットは、既に生成された文書を示しています:
Subjectフィールドはテキスト入力フィールドに置
次のコード例は、mail merge中にcheckboxesと入力テキストフィールドをドキュメントに挿入する方法を示しています:
Mail Merge中に画像を挿入する
Mail Merge操作を実行するときは、特殊なimageMail Mergeフィールドを使用してデータベースからドキュメントにイメージを挿入できます。 ImageMail MergeフィールドはImage:MyFieldNameという名前の差し込み項目です。
データベースからの画像の挿入
Mail merge中に、ドキュメント内で画像Mail Mergeフィールドが検出されると、FieldMergingCallbackイベントが発生します。 このイベントに応答して、ファイル名、ストリーム、または画像オブジェクトをMail Mergeエンジンに返し、ドキュメントに挿入できるようにすることができます。
次のコード例は、データベースBLOBフィールドに格納されている画像をレポートに挿入する方法を示しています:
Mail Merge中にイメージプロパティを設定する
画像の差し込み項目をマージする際に、WrapTypeなどのさまざまな画像プロパティを制御する必要がある場合があります。
現在、ImageFieldMergingArgsを使用すると、それぞれ画像の幅または高さのプロパティのみを設定できます。 この問題を解決するために、Aspose.WordsはShapeプロパティを提供し、挿入された画像やその他の形状を完全に制御するのを容易にします。
次のコード例は、さまざまなイメージプロパティを設定する方法を示しています: