Form
개요
Form은 Aspose.PDF FOSS for .NET에 포함된 클래스입니다. 상속 대상: ICollection<Aspose.Pdf.Annotations.WidgetAnnotation>.
PDF 문서의 대화형 양식 (AcroForm)을 나타냅니다.
이 클래스는 .NET 프로그램에서 Form 객체를 다루기 위한 37개의 메서드를 제공합니다. 사용 가능한 메서드에는 Add, AddFieldAppearance, AssignXfa, CopyTo, Delete, ExportFdf, ExportToJson, ExportXfdf, FindByName, FindField, Flatten, Form 및 추가 15개의 메서드가 포함됩니다. 모든 공개 멤버는 Aspose.PDF FOSS for .NET 패키지를 설치한 후 any .NET 애플리케이션에서 접근할 수 있습니다. 속성: AutoRecalculate, AutoRestoreForm, CalculatedFields, Count, DefaultAppearance, DefaultResources 및 추가 14개.
속성
| 이름 | 유형 | 액세스 | 설명 |
|---|---|---|---|
HasXfa | bool | 읽기 | 폼에 XFA 파트가 포함된 경우 true. |
AutoRecalculate | bool | 읽기/쓰기 | true인 경우, 종속성이 변경될 때마다 계산된 필드를 다시 계산합니다. |
AutoRestoreForm | bool | 읽기/쓰기 | 폼이 AcroForm /Fields 항목이 없거나 비어 있을 때 페이지 위젯에서 필드를 재구성하는지 여부 (기본값 true). |
CalculatedFields | IEnumerable<Field>? | 읽기/쓰기 | 계산 패스를 구동하는 데 사용되는 필드 순서. |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | 읽기/쓰기 | 자체 /DA를 가지고 있지 않은 필드에 적용되는 기본 외형. |
DefaultResources | Aspose.Pdf.Resources? | 읽기 | 양식에서 사용되는 기본 글꼴 / 색공간 리소스. |
IsSynchronized | bool | 읽기 | 기본 컬렉션이 스레드 안전한지 여부. |
NeedsRendering | bool | 읽기 | 양식에 NeedsAppearances 플래그가 설정된 경우 true. |
RemovePermission | bool | 읽기/쓰기 | true인 경우, 문서를 저장하기 전에 문서의 권한 비트가 제거됩니다. |
SignaturesAppendOnly | bool | 읽기/쓰기 | true인 경우, 작성자는 서명 우회 수정을 무시합니다. |
SyncRoot | object | 읽기 | IsSynchronized에 대한 동기화 루트 객체. |
Type | FormType | 읽기/쓰기 | 양식 유형 (Standard, Static, Dynamic). |
IsXfa | bool | 읽기 | 이 양식이 XFA 양식인지 여부. |
XFA | XFA? | 읽기 | 기본 XML 패킷(템플릿, 데이터셋 등)을 노출하는 XFA 액세서. |
Fields | Field[] | 읽기 | 폼 필드를 스냅샷 배열로 반환합니다. |
IgnoreNeedsRendering | bool | 읽기/쓰기 | true인 경우, 폼의 NeedAppearances 항목이 억제되어 Acrobat이 열 때 위젯 외관을 재구성하지 않게 됩니다. |
EmulateRequierdGroups | bool | 읽기/쓰기 | true일 경우, 폼의 flatten 단계는 XFA 스타일 ‘requiredGroups’에 대해 최소 하나가 필요함 제약이 충족되지 않은 경우 합성 Required 마커를 추가합니다. |
Count | int | 읽기 | ROOT 양식 필드 수 — AcroForm /Fields 배열의 항목들 (field-/Parent가 null인 필드). |
RadioGroups | IReadOnlyList<RadioButtonGroup> | 읽기 | 양식에 있는 모든 라디오 버튼 그룹. |
SignaturesExist | bool | 읽기/쓰기 | 양식에 non-null /V 서명 사전이 있는 서명 필드가 하나라도 존재하면 true. |
메서드
| 시그니처 | 설명 |
|---|---|
GetEnumerator() | 이 Form 인스턴스에서 GetEnumerator를 호출합니다. |
Add(field: Field, partialName: string, pageNumber: int) | 필드를 새 부분 이름 아래에 폼으로 복사하고, 해당 위젯을 pageNumber에 바인딩합니다. |
AddFieldAppearance(field: Field, pageNumber: int, rect: Rectangle) | 특정 페이지의 사각형 영역 내 필드에 새 위젯 외관을 추가합니다. |
AssignXfa(xml: XmlDocument) | 주어진 XmlDocument에서 XFA 데이터 세트를 교체합니다. |
CopyTo(array: Field[], index: int) | 필드를 제공된 배열의 지정된 인덱스부터 복사합니다. |
Delete(field: Field) | 제공된 필드를 양식에서 제거합니다. |
ExportToJson(stream: Stream) | 제공된 스트림을 통해 양식 필드를 JSON 로 직렬화합니다. |
ExportToJson(fileName: string) | 양식 필드를 파일에 JSON 로 직렬화합니다. |
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?) | 제공된 스트림을 통해 JSON 로 폼 필드를 직렬화합니다. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | 파일에 JSON 로 폼 필드를 직렬화합니다. |
GetFieldsInRect(rect: Rectangle) | 제공된 사각형과 교차하는 필드를 반환합니다. |
HasField(field: Field) | 제공된 필드가 이 폼에 속하면 True. |
ImportFromJson(stream: Stream) | 폼 필드 값을 JSON 스트림에서 읽고 적용합니다. |
ImportFromJson(fileName: string) | 폼 필드 값을 JSON 파일에서 읽고 적용합니다. |
MakeFormAnnotationsIndependent(page: Page) | 폼 주석을 필드 트리에서 분리하여 페이지 간에 독립적으로 이동할 수 있도록 합니다. |
RemoveFieldAppearance(field: Field, appearanceIndex: int) | 필드에서 특정 외관 항목을 제거합니다. |
GetXfaDatasetsXml() | XFA 데이터 세트 XML를 가져오며, XFA 양식이 아닌 경우 null을 반환합니다. |
ExportFdf() | PDF 사양 §12.7.7에 따라 FDF(Forms Data Format) 형식으로 양식 필드 데이터를 내보냅니다. |
ImportFdf(fdfData: byte[]) | FDF 바이트에서 양식 필드 데이터를 가져옵니다. |
ExportXfdf() | XFDF (XML Forms Data Format) 형식으로 양식 필드 데이터를 내보냅니다. |
ImportXfdf(xfdfXml: string) | XFDF XML 문자열에서 양식 필드 데이터를 가져옵니다. |
GetXfaFieldValue(path: string) | 데이터 세트 XML에서 점 구분 경로를 사용하여 XFA 필드 값을 가져옵니다. |
SetXfaFieldValue(path: string, value: string) | 데이터셋 XML에서 점 표기 경로를 사용하여 XFA 필드 값을 설정합니다. |
SetXfaFieldValues(values: IReadOnlyList<KeyValuePair<string, string>>) | 하나의 데이터셋 파싱/직렬화 사이클에서 여러 XFA 필드 값을 설정합니다. |
SetXfaFieldImage(path: string, base64: string, contentType: string) | 경로용 XFA 데이터셋 노드에 base64 이미지를 쓰고 주어진 contentType으로 태그합니다 (예: |
Flatten() | 모든 폼 필드를 평탄화합니다 — 시각적 모습을 페이지 콘텐츠에 렌더링하고 인터랙티브 폼을 제거합니다. |
Flatten(document: Document) | 모든 양식 필드를 평탄화합니다 — 시각적 모습을 페이지 내용으로 렌더링하고 인터랙티브 양식을 제거합니다. |
Form(document: Document) | 문서에 연결된 양식을 생성합니다. |
Delete(fieldName: string) | 이름으로 양식 필드를 삭제합니다. |
Add(field: Field) | 지정된 페이지의 양식에 필드를 추가합니다. |
Add(field: Field, pageNumber: int) | 추가할 필드. |
findField(fullName: string) | 이름으로 필드를 조회합니다; 찾지 못하면 null을 반환합니다. |
FindField(fullName: string) | PascalCase findField의 별칭. |
ToObject() | 모든 필드 값을 사전으로 내보냅니다 (필드 이름 → 값). |
HasField(fieldName: string) | 주어진 전체 이름을 가진 필드가 AcroForm에 존재하면 True. |
HasField(fieldName: string, searchChildren: bool) | 주어진 이름을 가진 필드가 존재하면 True. |
FindByName(fullName: string) | 전체 이름이나 정적 XFA 양식의 XFA 경로로 필드를 찾습니다. |
