フォームフィールドの操作
穴埋め(フィールド)を含む文書はフォームと呼ばれます。たとえば、ユーザーがエントリを選択できるドロップダウン リストを使用する登録フォームを Microsoft Word で作成できます。 Form
フィールドは、名前やアドレスなどの特定の種類のデータが保存される場所です。 Microsoft Word のフォーム フィールドには、テキスト入力、コンボボックス、チェックボックスが含まれます。
プロジェクト内のフォーム フィールドを使用して、ユーザーと「通信」できます。たとえば、コンテンツは保護されているが、編集できるのはフォーム フィールドのみであるドキュメントを作成するとします。ユーザーはフォームフィールドにデータを入力し、ドキュメントを送信できます。 Aspose.Words を使用するアプリケーションは、フォーム フィールドからデータを取得して処理できます。
コードを使用してフォームフィールドをドキュメントに配置するのは簡単です。 DocumentBuilder には、フォーム フィールドの種類ごとに 1 つずつ、それらを挿入するための特別なメソッドがあります。各メソッドは、フォーム フィールドの名前を表す文字列パラメータを受け入れます。名前は空の文字列にすることができます。ただし、フォーム フィールドの名前を指定すると、ブックマークが同じ名前で自動的に作成されます。
フォームフィールドの挿入
フォーム フィールドは、ユーザーとの「対話」を可能にする Word フィールドの特殊なケースです。 Microsoft Word のフォーム フィールドには、テキスト ボックス、コンボ ボックス、チェックボックスが含まれます。
DocumentBuilder は、insert_text_input、insert_check_box、insert_combo_box などの各タイプのフォーム フィールドをドキュメントに挿入するための特別なメソッドを提供します。フォームフィールドの名前を指定すると、ブックマークが同じ名前で自動的に作成されることに注意してください。
次のコード例は、コンボボックス フォーム フィールドをドキュメントに挿入する方法を示しています。
テキスト入力を挿入する
insert_text_input メソッドを使用して、ドキュメントにテキストボックスを挿入します。
次のコード例は、テキスト入力フォーム フィールドをドキュメントに挿入する方法を示しています。
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.insert_text_input("TextInput", aw.fields.TextFormFieldType.REGULAR, "", "Hello", 0)
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_text_input_form_field.docx")
チェックボックスを挿入する
insert_check_box を呼び出して、ドキュメントにチェックボックスを挿入します。
次のコード例は、チェックボックス フォーム フィールドをドキュメントに挿入する方法を示しています。
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.insert_check_box("CheckBox", True, True, 0)
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_check_box_form_field.docx")
コンボボックスを挿入する
insert_combo_box を呼び出して、ドキュメントにコンボボックスを挿入します。
次のコード例は、コンボボックス フォーム フィールドをドキュメントに挿入する方法を示しています。
doc = aw.Document()
builder = aw.DocumentBuilder(doc)
items = ["One", "Two", "Three"]
builder.insert_combo_box("DropDown", items, 0)
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_combo_box_form_field.docx")
フォームフィールドの取得
フォーム フィールドのコレクションは、form_fields プロパティを使用して取得できる FormFieldCollection クラスによって表されます。これは、ドキュメント自体を含む任意のドキュメント ノードに含まれるフォーム フィールドを取得できることを意味します。
インデックスまたは名前によって特定のフォーム フィールドを取得できます。
次のコード例は、フォーム フィールドにアクセスする方法を示しています。
FormField プロパティを使用すると、フォーム フィールド名、タイプ、結果を操作できます。
次のコード例は、フォーム フィールドの名前、型、および結果を操作する方法を示しています。
フォームフィールドのフォーマット
FormField の font プロパティを使用すると、フィールド値を含む FormField 全体にフォント書式設定を適用できます。
次のコード例は、フォントの書式設定を FormField に適用する方法を示しています。