Lucrul cu câmpurile de formular
Un document care conține spații libere de completare (câmpuri) este cunoscut sub numele de formular. De exemplu, puteți crea un formular de înregistrare în Microsoft Word care utilizează liste derulante din care utilizatorii pot selecta intrări. Câmpul Form este o locație în care este stocat un anumit tip de date, cum ar fi un nume sau o adresă. Câmpurile de formular din Microsoft Word includ introducerea textului, combobox și checkbox.
Puteți utiliza câmpurile de formular din proiectul dvs. pentru a" comunica " cu utilizatorii dvs. De exemplu, creați un document al cărui conținut este protejat, dar numai câmpurile de formular sunt editabile. Utilizatorii pot introduce datele în câmpurile formularului și pot trimite documentul. Aplicația dvs. care utilizează Aspose.Words poate prelua date din câmpurile formularului și le poate procesa.
Plasarea câmpurilor de formular în document prin cod este ușoară. DocumentBuilder are metode speciale pentru inserarea lor, câte una pentru fiecare tip de câmp de formular. Fiecare dintre metode acceptă un parametru șir care reprezintă numele câmpului de formular. Numele poate fi un șir gol. Dacă totuși specificați un nume pentru câmpul Formular, atunci un marcaj este creat automat cu același nume.
Introducerea Câmpurilor De Formular
Câmpurile de formular sunt un caz particular de câmpuri de cuvinte care permite “interacțiunea” cu utilizatorul. Câmpurile de formular din Microsoft Word includ textbox, combo box și checkbox.
DocumentBuilder oferă metode speciale pentru a insera fiecare tip de câmp de formular în document: insert_text_input, insert_check_box și insert_combo_box. Rețineți că, dacă specificați un nume pentru câmpul Formular, atunci un marcaj este creat automat cu același nume.
Următorul exemplu de cod arată cum să inserați un câmp de formular combobox într-un document:
Introduceți o introducere de Text
Utilizați metoda insert_text_input pentru a insera o casetă de text în document.
Următorul exemplu de cod arată cum să inserați un câmp de formular de introducere a textului într-un document:
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")Introduceți o casetă de selectare
Apelați insert_check_box pentru a insera un checkbox în document.
Următorul exemplu de cod arată cum să inserați un câmp de formular checkbox într-un document:
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")Introduceți o casetă combinată
Apelați insert_combo_box pentru a insera un Combobox în document.
Următorul exemplu de cod arată cum să inserați un câmp de formular Combobox într-un document:
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")Obțineți Câmpuri De Formular
O colecție de câmpuri de formular este reprezentată de clasa FormFieldCollection care poate fi recuperată folosind proprietatea form_fields. Aceasta înseamnă că puteți obține câmpuri de formular conținute în orice nod de document, inclusiv documentul în sine.
Puteți obține un anumit câmp de formular după indexul sau numele acestuia.
Următorul exemplu de cod arată cum să accesați câmpurile formularului:
Proprietățile FormField vă permit să lucrați cu numele, tipul și rezultatul câmpului de formular.
Următorul exemplu de cod arată cum să lucrați cu numele câmpului de formular, tipul și rezultatul:
Formatați Câmpurile Formularului
Proprietatea font a FormField permite aplicarea formatării fontului la FormField în ansamblu, inclusiv valoarea câmpului.
Următorul exemplu de cod arată cum se aplică formatarea fontului la FormField: