Wstaw pola
Istnieje kilka różnych sposobów umieszczania pól w dokumencie:
W tym artykule, będziemy patrzeć na każdy sposób bardziej szczegółowo i przeanalizować, jak umieścić pewne pola przy użyciu tych opcji.
Wstawianie pól do dokumentu przy użyciu DocumentBuilder
W Aspose.Words do InsertField metoda jest używana do wprowadzania nowych pól do dokumentu. Pierwszy parametr akceptuje pełny kod pola, które ma zostać wstawione. Drugi parametr jest opcjonalny i pozwala na ręczne ustawienie wyniku pola. Jeśli to nie jest dostarczone, pole jest automatycznie aktualizowane. Możesz podać null lub pustym do tego parametru, aby umieścić pole o pustej wartości pola. Jeśli nie jesteś pewien konkretnej składni kodu pola, stwórz pole w Microsoft Word pierwszy i przełącz, aby zobaczyć jego kod pola.
Poniższy przykład kodu pokazuje jak wstawić pole scalania do dokumentu używając DocumentBuilder:
Tę samą technikę stosuje się do umieszczania pól zagnieżdżonych w innych polach.
Poniższy przykład kodu pokazuje jak wstawić pola zagnieżdżone w innym polu używając DocumentBuilder:
Określić położenie na poziomie pola
Identyfikator języka jest standardowym międzynarodowym skrótem numerycznym dla danego języka w kraju lub regionie geograficznym. Z Aspose.Words, możesz określić Locale na poziomie pola za pomocą LocaleId nieruchomość, która pobiera lub ustawia identyfikator lokalizacji pola.
Poniższy przykład kodu pokazuje jak korzystać z tej opcji:
Wstaw niewpisane / puste pole
Jeśli chcesz wstawić niewpisane / puste pola ({}) just like Microsoft Word pozwala, można użyć InsertField metoda z FieldType.FieldNone parametr. Aby umieścić pole w dokumencie Word, można nacisnąć kombinację klawiszy Ctrl + F9.
Poniższy przykład kodu pokazuje jak umieścić puste pole w dokumencie:
Wstaw COMPARE Pole
W COMPARE pole porównuje dwie wartości i zwraca wartość liczbową 1, jeśli porównanie jest true lub 0, jeśli porównanie jest false.
Poniższy przykład kodu pokazuje jak dodać COMPARE pola używające DocumentBuilder:
Wstaw IF Pole
W IF pole może być użyte do oceny argumentów warunkowo.
Poniższy przykład kodu pokazuje jak dodać IF pola używające DocumentBuilder:
Wstawianie pól do dokumentu przy użyciu FieldBuilder
Alternatywny sposób umieszczania pól w Aspose.Words jest FieldBuilder Klasa. Zapewnia płynny interfejs do określenia przełączników pola i wartości argumentów jako tekst, węzły lub nawet zagnieżdżone pola.
Poniższy przykład kodu pokazuje jak wstawić pole do dokumentu używając FieldBuilder:
Wstawianie pól DOM
Można również wprowadzić różne rodzaje pól za pomocą Aspose.Words Document Object Model (DOM). W tej części przyjrzymy się kilku przykładom.
Wstawianie połączenia Pole w dokumencie DOM
MERGEFIELD pole w dokumencie Word może być reprezentowane przez FieldMergeField Klasa. Możesz użyć FieldMergeField klasa do wykonywania następujących operacji:
- podać nazwę pola połączenia
- określić formatowanie pola połączenia
- określić tekst, który znajduje się pomiędzy separatorem pola a końcem pola pola połączenia
- określić tekst, który ma być wstawiony po polu scalania, jeśli pole nie jest puste
- określić tekst, który ma być wstawiony przed polem połączenia, jeśli pole nie jest puste
Poniższy przykład kodu pokazuje jak dodać MERGE użycie pola DOM do ustępu w dokumencie:
Wprowadzanie Mail Merge ADDRESSBLOCK pole w dokumencie DOM
W ADDRESSBLOCK pole jest używane do wprowadzenia mail merge blok adresu w dokumencie Word. ADDRESSBLOCK pole w dokumencie Word może być reprezentowane przez FieldAddressBlock Klasa. Możesz użyć FieldAddressBlock klasa do wykonywania następujących operacji:
- określić, czy włączyć nazwę kraju / regionu do pola
- określić, czy należy formatować adres w zależności od kraju / regionu odbiorcy w rozumieniu POST * CODE (Universal Postal Union 2006)
- podać wyłączoną nazwę kraju / regionu
- określić format nazwy i adresu
- określić identyfikator języka używany do formatowania adresu
Poniższy przykład kodu pokazuje jak dodać Mail Merge ADDRESSBLOCK Pole DOM do ustępu w dokumencie:
Wprowadzanie ADVANCE pole do dokumentu bez korzystania z DocumentBuilder
W ADVANCE pole jest używane do przesunięcia kolejnego tekstu w linii w lewo, prawo, w górę lub w dół. ADVANCE pole w dokumencie Word może być reprezentowane przez FieldAdvance Klasa. Można użyć FieldAdvance klasa do wykonywania następujących operacji:
- określić liczbę punktów, za pomocą których tekst po polu powinien być przesunięty pionowo od górnej krawędzi strony
- określić liczbę punktów, za pomocą których tekst po polu powinien być przesunięty poziomo od lewej krawędzi kolumny, ramki lub pola tekstowego
- określić liczbę punktów, w których tekst po polu powinien być przesunięty w lewo, w prawo, w górę lub w dół
Poniższy przykład kodu pokazuje jak dodać ADVANCE Pole DOM do ustępu w dokumencie:
Wprowadzanie ASK pole do dokumentu bez korzystania z DocumentBuilder
W ASK pole służy do wywołania przez użytkownika tekstu przypisania do zakładki w dokumencie Word. ASK pole w dokumencie Word może być reprezentowane przez FieldAsk Klasa. Możesz użyć FieldAsk klasa do wykonywania następujących operacji:
- podać nazwę zakładki
- określenie domyślnej odpowiedzi użytkownika (wartość początkowa zawarta w oknie “prompt”)
- określić, czy odpowiedź użytkownika powinna być odbierana raz na mail merge działanie
- określić tekst (tytuł okna)
Poniższy przykład kodu pokazuje jak dodać ASK Pole DOM do ustępu w dokumencie:
Wprowadzanie AUTHOR pole do dokumentu bez korzystania z DocumentBuilder
W AUTHOR pole służy do określenia nazwy autora dokumentu z Document nieruchomości. AUTHOR pole w dokumencie Word może być reprezentowane przez FieldAuthor Klasa. Możesz użyć FieldAuthor klasa do wykonywania następujących operacji:
- podać nazwę autora dokumentu
Poniższy przykład kodu pokazuje jak dodać AUTHOR Pole DOM do ustępu w dokumencie:
Wprowadzanie INCLUDETEXT pole do dokumentu bez korzystania z DocumentBuilder
W INCLUDETEXT pole wprowadza tekst i grafikę zawarte w dokumencie określonym w kodzie pola. Można wstawić cały dokument lub część dokumentu, o którym mowa w zakładce. To pole w dokumencie Word jest reprezentowane przez INCLUDETEXT. Możesz użyć FieldIncludeText klasa do wykonywania następujących operacji:
- podać nazwę dołączonego dokumentu zakładki
- określić lokalizację dokumentu
Poniższy przykład kodu pokazuje jak dodać INCLUDETEXT użycie pola DOM do ustępu w dokumencie:
Wprowadzanie TOA pole do dokumentu bez korzystania z DocumentBuilder
W TOA (* Tabela organów *) pole buduje i umieszcza tabelę organów. W TOA pole zbiera wpisy oznaczone przez TA (* Tabela wpisów organów *). Microsoft Office Word wprowadza TOA pole po kliknięciu * Wstaw tabelę organów * w **Tabela organów** Grupa **References** Tab. Kiedy oglądasz TOA pole w dokumencie, składnia wygląda tak:
{ TOA [Switches ] }
Poniższy przykład kodu pokazuje jak dodać TOA użycie pola DOM do ustępu w dokumencie.