Lucrul cu câmpurile formularului
Un document care conține spații de umplut (campuri) este cunoscut sub numele de formular. De exemplu, poţi crea un formular de înregistrare în Microsoft Word care foloseşte liste derulante din care utilizatorii pot selecta intrări. Câmpul Form este o locație unde un anumit tip de date, cum ar fi un nume sau o adresă, este stocat. Câmpurile formularului din Microsoft Word includ câmpul de intrare text, câmpul combobox și câmpul checkbox.
Poți folosi câmpurile de formular în proiectul tău pentru a “comunica” cu utilizatorii tăi. De exemplu, creezi un document a cărui conținut este protejat, dar doar câmpurile formularului sunt editabile. Utilizatorii pot introduce datele în câmpurile formularului și să trimită documentul. Aplicația ta care foloseşte Aspose.Words poate recupera datele din câmpurile formularului și să le proceseze.
Pune câmpurile de formular în document prin intermediul codului este ușor. DocumentBuilder are metode speciale pentru inserarea lor, una pentru fiecare tip de câmp de formular. Fiecare dintre metode acceptă un parametru de tip șir reprezentând numele câmpului formularului. Numele poate fi un șir gol. Dacă totuși ai specificat un nume pentru câmpul formularului, atunci o marcă de carte este creată automat cu același nume.
Inserare câmpuri formular
Câmpurile de formular sunt un caz particular de câmpuri de cuvânt care permit “interacțiunea” cu utilizatorul. Câmpurile formularului în Microsoft Word includ caseta de text, caseta combinată și caseta de verificare.
DocumentBuilder oferă metode speciale pentru a insera fiecare tip de câmp de formular în document: InsertTextInput, InsertCheckBox și InsertComboBox. Notă că dacă specificați un nume pentru câmpul formularului, atunci se creează automat o marcă cu același nume.
Exemplul de cod următor prezintă modul în care se inserează un câmp formular combobox într-un document
Introduceţi o intrare de text
Foloseşte metoda InsertTextInput pentru a insera o casetă de text în document.
Exemplul de cod următor arată cum să inserezi un câmp de intrare de tip text într-un document:
Introduceți o Casetă de Selectare
Apelați InsertCheckBox pentru a insera o casetă de selectare în document.
Exemplul de cod următor arată cum se introduce un câmp de casetă selectabilă într-un document:
Introduce o casetă combo
Apel InsertComboBox pentru a insera un combobox în documentul.
Exemplul de cod următor arată cum să inserați un câmp formular combobox într-un document:
Obținerea câmpurilor formularului
O colecție de câmpuri de formular este reprezentată de clasa FormFieldCollection care poate fi recuperată folosind proprietatea FormFields. Acest lucru înseamnă că poți obține câmpuri de formular conținute în orice nod de document inclusiv în documentul însuși.
Următorul exemplu de cod arată cum se obține o colecție de câmpuri de formular:
Poţi obţine un anumit câmp formular după indice sau nume.
Exemplul de cod de mai jos arată cum se accesează câmpurile formularului:
Proprietățile FormField îți permit să lucrezi cu numele câmpului formular, tipul și rezultatul.
Exemplul de cod următor arată cum să lucrezi cu numele câmpului formular, tip și rezultat:
Formate câmpuri formular
Proprietatea Font din FormField permite aplicarea formatării fontului la întregul FormField, inclusiv valoarea câmpului.
Exemplul de cod următor arată cum să aplicați formatarea fontului la FormField: