---
title: "Python의 양식 필드 작업"
---


채우기 공백(필드)이 포함된 문서를 양식이라고 합니다. 예를 들어, 사용자가 항목을 선택할 수 있는 드롭다운 목록을 사용하는 Microsoft Word 등록 양식을 만들 수 있습니다. `Form` 필드는 이름이나 주소와 같은 특정 유형의 데이터가 저장되는 위치입니다. Microsoft Word의 양식 필드에는 텍스트 입력, 콤보 상자 및 확인란이 포함됩니다.

프로젝트의 양식 필드를 사용하여 사용자와 "소통"할 수 있습니다. 예를 들어 내용이 보호되어 있지만 양식 필드만 편집할 수 있는 문서를 생성합니다. 사용자는 양식 필드에 데이터를 입력하고 문서를 제출할 수 있습니다. Aspose.Words를 사용하는 애플리케이션은 양식 필드에서 데이터를 검색하고 처리할 수 있습니다.

코드를 통해 문서에 양식 필드를 배치하는 것은 쉽습니다. [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/)에는 각 양식 필드 유형마다 하나씩 삽입하는 특별한 방법이 있습니다. 각 메소드는 양식 필드의 이름을 나타내는 문자열 매개변수를 허용합니다. 이름은 빈 문자열일 수 있습니다. 그러나 양식 필드에 이름을 지정하면 동일한 이름으로 책갈피가 자동으로 생성됩니다.

## 양식 필드 삽입

양식 필드는 사용자와의 "상호작용"을 허용하는 Word 필드의 특별한 경우입니다. Microsoft Word의 양식 필드에는 텍스트 상자, 콤보 상자 및 확인란이 포함됩니다.

[DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/)는 각 유형의 양식 필드([insert_text_input](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_text_input/), [insert_check_box](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_check_box/) 및 [insert_combo_box](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_combo_box/))를 문서에 삽입하는 특별한 방법을 제공합니다. 양식 필드에 이름을 지정하면 동일한 이름으로 책갈피가 자동으로 생성됩니다.

다음 코드 예제에서는 콤보 상자 양식 필드를 문서에 삽입하는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_form_fields-InsertFormFields.py" >}}

### 텍스트 입력 삽입

[insert_text_input](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_text_input/) 메서드를 사용하여 문서에 텍스트 상자를 삽입합니다.

다음 코드 예제에서는 텍스트 입력 양식 필드를 문서에 삽입하는 방법을 보여줍니다

{{< highlight python >}}
doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_text_input("TextInput", aw.fields.TextFormFieldType.REGULAR, "", "Hello", 0)
        
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_text_input_form_field.docx")
{{< /highlight >}}

### 체크박스 삽입

문서에 체크박스를 삽입하려면 [insert_check_box](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_check_box/)를 호출하세요.

다음 코드 예제에서는 확인란 양식 필드를 문서에 삽입하는 방법을 보여줍니다

{{< highlight python >}}
doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_check_box("CheckBox", True, True, 0)
        
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_check_box_form_field.docx")
{{< /highlight >}}

### 콤보 상자 삽입

문서에 콤보박스를 삽입하려면 [insert_combo_box](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/insert_combo_box/)를 호출하세요.

다음 코드 예제에서는 콤보 상자 양식 필드를 문서에 삽입하는 방법을 보여줍니다

{{< highlight python >}}
doc = aw.Document()
builder = aw.DocumentBuilder(doc)

items =  ["One", "Two", "Three"] 
builder.insert_combo_box("DropDown", items, 0)

doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_combo_box_form_field.docx")
{{< /highlight >}}

## 양식 필드 얻기

양식 필드 컬렉션은 [form_fields](https://reference.aspose.com/words/python-net/aspose.words/range/form_fields/) 속성을 사용하여 검색할 수 있는 [FormFieldCollection](https://reference.aspose.com/words/python-net/aspose.words.fields/formfieldcollection/) 클래스로 표시됩니다. 이는 문서 자체를 포함하여 모든 문서 노드에 포함된 양식 필드를 얻을 수 있음을 의미합니다.

{{% alert color="primary" %}}

[Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/blob/master/Examples/Data/Form%20fields.docx)에서 다음 예제의 샘플 파일을 다운로드할 수 있습니다.

{{% /alert %}}

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_form_fields-FormFieldsGetFormFieldsCollection.py" >}}

색인이나 이름으로 특정 양식 필드를 가져올 수 있습니다.

다음 코드 예제에서는 양식 필드에 액세스하는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_form_fields-FormFieldsGetByName.py" >}}

[FormField](https://reference.aspose.com/words/python-net/aspose.words.fields/formfield/) 속성을 사용하면 양식 필드 이름, 유형 및 결과로 작업할 수 있습니다.

다음 코드 예에서는 양식 필드 이름, 유형 및 결과를 사용하여 작업하는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_form_fields-FormFieldsWorkWithProperties.py" >}}

## 양식 필드 형식 지정

[FormField](https://reference.aspose.com/words/python-net/aspose.words.fields/formfield/)의 [font](https://reference.aspose.com/words/python-net/aspose.words/inline/font/) 속성을 사용하면 필드 값을 포함하여 [FormField](https://reference.aspose.com/words/python-net/aspose.words.fields/formfield/) 전체에 글꼴 형식을 적용할 수 있습니다.

다음 코드 예제에서는 **FormField**에 글꼴 서식을 적용하는 방법을 보여줍니다

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_form_fields-FormFieldsFontFormatting.py" >}}