Работа с полета за форма
Документ, който съдържа бланки за попълване (полета) е известен като формуляр. Например, можете да създадете регистрационен формуляр в Microsoft Word който използва падащи списъци, от които потребителите могат да избират записи. На Form
поле е място, където се съхранява определен тип данни, като например име или адрес. Формиране на полета в Microsoft Word включва текстов вход, комбокса и чекова кутия.
Можете да използвате форма полета във вашия проект за “комуникиране” с вашите потребители. Например, създавате документ, чието съдържание е защитено, но само полетата с форма могат да бъдат редактирани. Потребителите могат да въвеждат данните във форма полета и да представят документа. Вашата молба, която използвате Aspose.Words може да извлича данни от полетата на формата и да ги обработва.
Поставянето на полета с форма в документа чрез код е лесно. DocumentBuilder има специални методи за поставянето им, по един за всеки вид поле. Всеки от методите приема низов параметър, представляващ името на полето на формата. Името може да бъде празен низ. Ако обаче посочите име за полето на формата, тогава отметките автоматично се създават със същото име.
Вмъкване на полета с форма
Полета за форма са конкретен случай на 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")
Вмъкване на Combo Box
Обаждане insert_combo_box да поставите Combobox в документа.
Следният пример за код показва как да се въведе поле за формуляр Combobox в документ:
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")
Получете полета с форма
Колекция от полета с форми се представя от FormFieldCollection клас, който може да се извлече чрез form_fields собственост. Това означава, че можете да получите полета във форма, съдържащи се във всеки документ възел, включително самия документ.
Можете да получите определена форма поле по индекс или име.
Следният пример за код показва как да получите достъп до полетата:
На FormField имоти ви позволяват да работите с форма поле име, тип и резултат.
Следният пример с код показва как да се работи с името на полето, вида и резултата:
Формиране на полета
На font на FormField позволява прилагането на форматиране на шрифта към FormField като цяло, включително стойността на полето.
Следният пример с код показва как да се приложи форматиране на шрифта към FormField: