Wstaw Pola

Istnieje kilka różnych sposobów wstawiania pól do dokumentu:

W tym artykule przyjrzymy się każdemu sposobowi bardziej szczegółowo i przeanalizujemy, jak wstawić określone pola za pomocą tych opcji.

Wstawianie pól do dokumentu za pomocą DocumentBuilder

W Aspose.Words metoda InsertField służy do wstawiania nowych pól do dokumentu. Pierwszy parametr akceptuje Pełny kod pola pola, które ma zostać wstawione. Drugi parametr jest opcjonalny i umożliwia ręczne ustawienie wyniku pola pola. Jeśli nie zostanie to dostarczone, pole zostanie automatycznie zaktualizowane. Możesz przekazać null lub empty do tego parametru, aby wstawić pole z pustą wartością pola. Jeśli nie masz pewności co do konkretnej składni kodu pola, najpierw Utwórz pole w Microsoft Word i przełącz, aby zobaczyć jego kod pola.

Poniższy przykład kodu pokazuje, jak wstawić pole scalania do dokumentu za pomocą DocumentBuilder:

Ta sama technika jest używana do wstawiania pól zagnieżdżonych w innych polach.

Poniższy przykład kodu pokazuje, jak wstawić pola zagnieżdżone w innym polu za pomocą DocumentBuilder:

Określ ustawienia regionalne na poziomie pola

Identyfikator języka to standardowy międzynarodowy skrót numeryczny języka w kraju lub regionie geograficznym. Za pomocą Aspose.Words możesz określić ustawienia regionalne na poziomie pola za pomocą właściwości LocaleId, która pobiera lub ustawia ustawienia regionalne pola ID.

Poniższy przykład kodu pokazuje, jak korzystać z tej opcji:

Wstaw Nieobtypowane / Puste Pole

Jeśli chcesz wstawić nieobtypowane / puste pola ({}) tak, jak pozwala na to Microsoft Word, możesz użyć metody InsertField z parametrem FieldType.FieldNone. Aby wstawić pole do dokumentu Word, możesz nacisnąć kombinację klawiszy “Ctrl + F9”.

Poniższy przykład kodu pokazuje, jak wstawić puste pole do dokumentu:

Wstawianie pól do dokumentu za pomocą FieldBuilder

Alternatywnym sposobem wstawiania pól w Aspose.Words jest klasa FieldBuilder. Zapewnia płynny interfejs do określania przełączników pól i wartości argumentów jako tekstu, węzłów, a nawet zagnieżdżonych pól.

Poniższy przykład kodu pokazuje, jak wstawić pole do dokumentu za pomocą FieldBuilder:

Wstawianie pól za pomocą DOM

Możesz także wstawiać różne typy pól za pomocą Aspose.Words Obiektowy Model Dokumentu (DOM). W tej sekcji przyjrzymy się kilku przykładom.

Wstawianie pola scalania do dokumentu za pomocą DOM

Pole MERGEFIELD w dokumencie Word może być reprezentowane przez klasę FieldMergeField. Klasy FieldMergeField można użyć do wykonania następujących operacji:

  • określ nazwę pola scalania
  • określ formatowanie pola scalania
  • określ tekst znajdujący się między separatorem pola a końcem pola pola scalania
  • określ tekst, który ma zostać wstawiony po polu scalania, jeśli pole nie jest puste
  • określ tekst, który ma zostać wstawiony przed polem scalania, jeśli pole nie jest puste

Poniższy przykład kodu pokazuje, jak dodać pole MERGE za pomocą DOM do akapitu w dokumencie:

Wstawianie pola bloku adresu Mail Merge do dokumentu za pomocą DOM

Pole ADDRESSBLOCK służy do wstawiania bloku adresu Mail Merge do dokumentu Word. Pole ADDRESSBLOCK w dokumencie Word może być reprezentowane przez klasę FieldAddressBlock. Klasy FieldAddressBlock można użyć do wykonania następujących operacji:

  • określ, czy w polu należy podać nazwę kraju/regionu
  • określ, czy adres ma być sformatowany zgodnie z krajem / regionem odbiorcy zgodnie z definicją POST * CODE (Universal Postal Union 2006)
  • podaj wykluczoną nazwę kraju / regionu
  • określ format nazwy i adresu
  • określ język ID używany do formatowania adresu

Poniższy przykład kodu pokazuje, jak dodać pole Mail Merge ADDRESSBLOCK za pomocą DOM do akapitu w dokumencie:

Wstawianie pola Advance do dokumentu bez użycia DocumentBuilder

Pole ADVANCE służy do przesuwania kolejnego tekstu w linii w lewo, w prawo, w górę lub w dół. Pole ADVANCE w dokumencie Word może być reprezentowane przez klasę FieldAdvance. Możesz użyć klasy FieldAdvance do wykonania następujących operacji:

  • określ liczbę punktów, o które tekst następujący po polu powinien zostać przesunięty pionowo od górnej krawędzi strony
  • określ liczbę punktów, o które tekst następujący po polu powinien zostać przesunięty poziomo od lewej krawędzi kolumny, ramki lub pola tekstowego
  • określ liczbę punktów, o które tekst następujący po polu powinien zostać przesunięty w lewo, w prawo, w górę lub w dół

Poniższy przykład kodu pokazuje, jak dodać pole ADVANCE za pomocą DOM do akapitu w dokumencie:

Wstawianie pola ASK do dokumentu bez użycia DocumentBuilder

Pole ASK służy do monitowania użytkownika o przypisanie tekstu do zakładki w dokumencie Word. Pole ASK w dokumencie Word może być reprezentowane przez klasę FieldAsk. Klasy FieldAsk można użyć do wykonania następujących operacji:

  • określ nazwę zakładki
  • określ domyślną odpowiedź użytkownika (wartość początkowa zawarta w oknie monitu)
  • określ, czy odpowiedź użytkownika powinna zostać odebrana raz na operację Mail Merge
  • określ tekst zachęty (tytuł okna zachęty)

Poniższy przykład kodu pokazuje, jak dodać pole ASK za pomocą DOM do akapitu w dokumencie:

Wstawianie pola AUTHOR do dokumentu bez użycia DocumentBuilder

Pole AUTHOR służy do określenia nazwy autora dokumentu z właściwości Document. Pole AUTHOR w dokumencie Word może być reprezentowane przez klasę FieldAuthor. Klasy FieldAuthor można użyć do wykonania następujących operacji:

  • podaj nazwisko autora dokumentu

Poniższy przykład kodu pokazuje, jak dodać pole AUTHOR za pomocą DOM do akapitu w dokumencie:

Wstawianie pola INCLUDETEXT do dokumentu bez użycia DocumentBuilder

Pole INCLUDETEXT wstawia tekst i grafikę zawarte w dokumencie nazwanym w kodzie pola. Możesz wstawić cały dokument lub część dokumentu, do którego odnosi się zakładka. To pole w dokumencie Word jest reprezentowane przez INCLUDETEXT. Klasy FieldIncludeText można użyć do wykonania następujących operacji:

  • określ nazwę zakładki dołączonego dokumentu
  • określ lokalizację dokumentu

Poniższy przykład kodu pokazuje, jak dodać pole INCLUDETEXT za pomocą DOM do akapitu w dokumencie:

Wstawianie pola TOA do dokumentu bez użycia DocumentBuilder

Pole TOA (Table of Authorities) tworzy i wstawia tabelę władz. Pole TOA zbiera wpisy oznaczone polami TA (Table of Authorities Entry). Microsoft Office Word wstawia pole TOA Po kliknięciu Insert Table of Authorities w grupie Table of Authorities na karcie References. Gdy wyświetlasz pole TOA w dokumencie, składnia wygląda następująco:

{ TOA [Switches ] }

Poniższy przykład kodu pokazuje, jak dodać pole TOA za pomocą DOM do akapitu w dokumencie:

/

Przegląd pól w C++ Jak znaleźć Właściwości pola