Praca z polami formularzy
Dokument zawierający puste pola (pola) do wypełnienia nazywany jest formularzem. Na przykład możesz utworzyć formularz rejestracyjny w Microsoft Word, który korzysta z list rozwijanych, z których użytkownicy mogą wybierać wpisy. Pole Form to miejsce, w którym przechowywany jest określony typ danych, taki jak imię i nazwisko lub adres. Pola formularzy w Microsoft Word obejmują wprowadzanie tekstu, pole kombi i pole wyboru.
Możesz używać pól formularzy w swoim projekcie do “komunikowania się” z użytkownikami. Na przykład tworzysz dokument, którego treść jest chroniona, ale edytowalne są tylko pola formularza. Użytkownicy mają możliwość wprowadzenia danych w polach formularza i przesłania dokumentu. Twoja aplikacja korzystająca z Aspose.Words może pobierać dane z pól formularza i je przetwarzać.
Umieszczanie pól formularzy w dokumencie za pomocą kodu jest łatwe. DocumentBuilder posiada specjalne metody ich wstawiania, po jednej dla każdego typu pola formularza. Każda z metod przyjmuje parametr string reprezentujący nazwę pola formularza. Nazwa może być pustym ciągiem znaków. Jeśli jednak podasz nazwę pola formularza, automatycznie utworzona zostanie zakładka o tej samej nazwie.
Wstaw pola formularza
Pola formularzy to szczególny przypadek pól programu Word, który umożliwia “interakcję” z użytkownikiem. Pola formularzy w Microsoft Word obejmują pole tekstowe, pole kombi i pole wyboru.
DocumentBuilder udostępnia specjalne metody wstawiania każdego typu pola formularza do dokumentu: InsertTextInput, InsertCheckBox i InsertComboBox. Pamiętaj, że jeśli określisz nazwę pola formularza, automatycznie utworzona zostanie zakładka o tej samej nazwie.
Poniższy przykład kodu pokazuje, jak wstawić pole formularza combobox do dokumentu:
Wstaw wprowadzany tekst
Użyj metody InsertTextInput, aby wstawić pole tekstowe do dokumentu.
Poniższy przykład kodu pokazuje, jak wstawić pole formularza wprowadzania tekstu do dokumentu:
Wstaw pole wyboru
Wywołaj InsertCheckBox, aby wstawić pole wyboru do dokumentu.
Poniższy przykład kodu pokazuje, jak wstawić pole formularza pola wyboru do dokumentu:
Wstaw pole kombi
Wywołaj InsertComboBox, aby wstawić combobox do dokumentu.
Poniższy przykład kodu pokazuje, jak wstawić pole formularza Combobox do dokumentu:
Uzyskaj pola formularza
Zbiór pól formularzy jest reprezentowany przez klasę FormFieldCollection, którą można pobrać za pomocą właściwości FormFields. Oznacza to, że możesz uzyskać pola formularzy zawarte w dowolnym węźle dokumentu, łącznie z samym dokumentem.
Poniższy przykład kodu pokazuje, jak uzyskać kolekcję pól formularza:
Możesz uzyskać określone pole formularza według jego indeksu lub nazwy.
Poniższy przykład kodu pokazuje, jak uzyskać dostęp do pól formularza:
Właściwości FormField umożliwiają pracę z nazwą, typem i wynikiem pola formularza.
Poniższy przykład kodu pokazuje, jak pracować z nazwą, typem i wynikiem pola formularza:
Formatuj pola formularza
Właściwość Font FormField umożliwia zastosowanie formatowania czcionki do całego pliku FormField, łącznie z wartością pola.
Poniższy przykład kodu pokazuje, jak zastosować formatowanie czcionki do FormField: