필드 삽입
문서에 필드를 삽입하는 방법에는 여러 가지가 있습니다
이 문서에서는 각 방법을 더 자세히 살펴보고 이러한 옵션을 사용하여 특정 필드를 삽입하는 방법을 분석합니다.
DocumentBuilder를 사용하여 문서에 필드 삽입
Aspose.Words에서는 insert_field 메서드를 사용하여 문서에 새 필드를 삽입합니다. 첫 번째 매개변수는 삽입할 필드의 전체 필드 코드를 허용합니다. 두 번째 매개변수는 선택사항이며 필드의 필드 결과를 수동으로 설정할 수 있습니다. 이것이 제공되지 않으면 필드가 자동으로 업데이트됩니다. 이 매개변수에 null 또는 공백을 전달하여 빈 필드 값이 있는 필드를 삽입할 수 있습니다. 특정 필드 코드 구문이 확실하지 않은 경우 먼저 Microsoft Word로 필드를 생성하고 전환하여 해당 필드 코드를 확인하세요.
다음 코드 예제에서는 DocumentBuilder를 사용하여 문서에 병합 필드를 삽입하는 방법을 보여줍니다
다음 코드 예제에서는 DocumentBuilder를 사용하여 독일어 로캘이 포함된 병합 필드를 문서에 삽입하는 방법을 보여줍니다
다른 필드 내에 중첩된 필드를 삽입하는 데에도 동일한 기술이 사용됩니다.
다음 코드 예제에서는 DocumentBuilder를 사용하여 다른 필드 내에 중첩된 필드를 삽입하는 방법을 보여줍니다
필드 수준에서 로케일 지정
언어 식별자는 국가 또는 지역의 언어에 대한 표준 국제 숫자 약어입니다. Aspose.Words를 사용하면 필드 수준에서 로케일을 지정할 수 있습니다. locale_id 속성은 필드의 로케일 ID를 가져오거나 설정합니다.
다음 코드 예제에서는 이 옵션을 사용하는 방법을 보여줍니다
유형이 지정되지 않은/빈 필드 삽입
Microsoft Word에서 허용하는 것처럼 형식이 지정되지 않은/빈 필드({})를 삽입하려면 FieldType.FIELD_NONE 매개변수와 함께 insert_field 메서드를 사용할 수 있습니다. Word 문서에 필드를 삽입하려면 “Ctrl + F9” 키 조합을 누르세요.
다음 코드 예제에서는 문서에 빈 필드를 삽입하는 방법을 보여줍니다
FieldBuilder를 사용하여 문서에 필드 삽입
Aspose.Words에 필드를 삽입하는 다른 방법은 FieldBuilder 클래스입니다. 필드 스위치와 인수 값을 텍스트, 노드 또는 중첩 필드로 지정하는 유창한 인터페이스를 제공합니다.
다음 코드 예제에서는 FieldBuilder를 사용하여 문서에 필드를 삽입하는 방법을 보여줍니다
DOM를 사용하여 필드 삽입
Aspose.Words Document Object Model (DOM)를 사용하여 다양한 유형의 필드를 삽입할 수도 있습니다. 이 섹션에서는 몇 가지 예를 살펴보겠습니다.
DOM를 사용하여 문서에 병합 필드 삽입
Word 문서의 MERGEFIELD 필드는 FieldMergeField 클래스로 표현할 수 있습니다. FieldMergeField 클래스를 사용하여 다음 작업을 수행할 수 있습니다
- 병합 필드의 이름을 지정합니다
- 병합 필드의 형식 지정
- 필드 구분 기호와 병합 필드의 필드 끝 사이에 있는 텍스트를 지정합니다
- 필드가 비어 있지 않은 경우 병합 필드 뒤에 삽입할 텍스트를 지정합니다
- 필드가 비어 있지 않은 경우 병합 필드 앞에 삽입할 텍스트를 지정합니다
다음 코드 예제에서는 DOM를 사용하여 문서의 단락에 Merge 필드를 추가하는 방법을 보여줍니다
DOM을 사용하여 문서에 Mail Merge ADDRESSBLOCK 필드 삽입
ADDRESSBLOCK 필드는 Word 문서에 Mail Merge 주소 블록을 삽입하는 데 사용됩니다. Word 문서의 ADDRESSBLOCK 필드는 FieldAddressBlock 클래스로 표현될 수 있습니다. FieldAddressBlock 클래스를 사용하여 다음 작업을 수행할 수 있습니다
- 필드에 국가/지역 이름을 포함할지 여부를 지정합니다
- POST*CODE(Universal Postal Union 2006)에 정의된 대로 수신자의 국가/지역에 따라 주소 형식을 지정할지 여부를 지정합니다
- 제외되는 국가/지역 이름을 지정하세요
- 이름과 주소 형식을 지정합니다
- 주소 형식을 지정하는 데 사용되는 언어 ID를 지정합니다
다음 코드 예제에서는 DOM을 사용하여 문서의 단락에 Mail Merge ADDRESSBLOCK 필드를 추가하는 방법을 보여줍니다
DocumentBuilder를 사용하지 않고 문서에 ADVANCE 필드 삽입
ADVANCE 필드는 줄 내의 후속 텍스트를 왼쪽, 오른쪽, 위 또는 아래로 오프셋하는 데 사용됩니다. Word 문서의 ADVANCE 필드는 FieldAdvance 클래스로 표현할 수 있습니다. FieldAdvance 클래스를 사용하여 다음 작업을 수행할 수 있습니다
- 필드 뒤의 텍스트를 페이지 상단 가장자리에서 수직으로 이동해야 하는 포인트 수를 지정합니다
- 필드 뒤에 오는 텍스트가 열, 프레임 또는 텍스트 상자의 왼쪽 가장자리에서 수평으로 이동되어야 하는 포인트 수를 지정합니다
- 필드 뒤에 오는 텍스트를 왼쪽, 오른쪽, 위쪽 또는 아래쪽으로 이동해야 하는 포인트 수를 지정합니다
다음 코드 예제에서는 DOM를 사용하여 문서의 단락에 ADVANCE 필드를 추가하는 방법을 보여줍니다.
DocumentBuilder를 사용하지 않고 문서에 ASK 필드 삽입
ASK 필드는 Word 문서의 책갈피에 할당할 텍스트를 사용자에게 묻는 데 사용됩니다. Word 문서의 ASK 필드는 FieldAsk 클래스로 표현될 수 있습니다. FieldAsk 클래스를 사용하여 다음 작업을 수행할 수 있습니다
- 북마크의 이름을 지정
- 기본 사용자 응답 지정(프롬프트 창에 포함된 초기 값)
- Mail Merge 작업마다 사용자 응답을 한 번 받아야 하는지 여부를 지정합니다
- 프롬프트 텍스트 지정(프롬프트 창 제목)
다음 코드 예제에서는 DOM를 사용하여 문서의 단락에 ASK 필드를 추가하는 방법을 보여줍니다
DocumentBuilder를 사용하지 않고 문서에 AUTHOR 필드 삽입
AUTHOR 필드는 Document 속성에서 문서 작성자의 이름을 지정하는 데 사용됩니다. Word 문서의 AUTHOR 필드는 FieldAuthor 클래스로 표현할 수 있습니다. FieldAuthor 클래스를 사용하여 다음 작업을 수행할 수 있습니다
- 문서 작성자의 이름을 지정하십시오
다음 코드 예제에서는 DOM를 사용하여 문서의 단락에 AUTHOR 필드를 추가하는 방법을 보여줍니다
DocumentBuilder를 사용하지 않고 문서에 INCLUDETEXT 필드 삽입
INCLUDETEXT 필드는 필드 코드에 명명된 문서에 포함된 텍스트와 그래픽을 삽입합니다. 문서 전체를 삽입할 수도 있고 책갈피가 참조하는 문서의 일부를 삽입할 수도 있습니다. Word 문서의 이 필드는 INCLUDETEXT로 표시됩니다. FieldIncludeText 클래스를 사용하여 다음 작업을 수행할 수 있습니다
- 포함된 문서의 북마크 이름을 지정합니다
- 문서의 위치를 지정
다음 코드 예제에서는 DOM를 사용하여 문서의 단락에 INCLUDETEXT 필드를 추가하는 방법을 보여줍니다
DocumentBuilder를 사용하지 않고 문서에 TOA 필드 삽입
TOA(저거 목록) 필드는 근거 목록을 작성하고 삽입합니다. TOA 필드는 TA(Authority Entry) 필드로 표시된 항목을 수집합니다. Microsoft Office Word는 References 탭의 권한 목록 그룹에서 권한 목록 삽입을 클릭하면 TOA 필드를 삽입합니다. 문서에서 TOA 필드를 보면 구문은 다음과 같습니다
{ TOA [Switches ] }
FieldToa 클래스를 사용하여 TOA 필드에 대한 작업을 수행할 수 있습니다.
다음 코드 예제에서는 DOM를 사용하여 문서의 단락에 TOA 필드를 추가하는 방법을 보여줍니다