ButtonField

개요

ButtonField은(는) Aspose.PDF FOSS에서 .NET용 클래스입니다. 상속 대상: Field.

푸시 버튼 폼 필드 (FT=Btn, Pushbutton 플래그 설정됨).

이 클래스는 .NET 프로그램에서 ButtonField 객체를 다루기 위한 30개의 메서드를 제공합니다. 사용 가능한 메서드에는 Accept, AddImage, ButtonField, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName 및 추가 9개의 메서드가 포함됩니다. 모든 공개 멤버는 Aspose.PDF FOSS for .NET 패키지를 설치한 후 .NET 애플리케이션 어디서든 접근할 수 있습니다. 속성: Action, Actions, ActiveState, Alignment, AlternateCaption, AlternateIcon 및 추가 80개.

속성

이름	유형	액세스	설명
`NormalCaption`	`string?`	읽기/쓰기	정상 상태일 때 버튼에 표시되는 캡션 (MK dict /CA entry).
`AlternateCaption`	`string?`	읽기/쓰기	사용자가 마우스 버튼을 누르고 있을 때 표시되는 캡션 (/MK /AC).
`RolloverCaption`	`string?`	읽기/쓰기	마우스 커서가 위에 있을 때 표시되는 캡션 (/MK /RC).
`NormalIcon`	`XForm?`	읽기/쓰기	정상 상태 아이콘으로 사용되는 Form XObject (/MK /I).
`RolloverIcon`	`XForm?`	읽기/쓰기	롤오버 아이콘으로 사용되는 Form XObject (/MK /RI).
`AlternateIcon`	`XForm?`	읽기/쓰기	다운/대체 아이콘으로 사용되는 Form XObject (/MK /IX).
`ICPosition`	`IconCaptionPosition`	읽기/쓰기	아이콘에 대한 캡션 위치 (/MK /TP).
`IconFit`	`IconFit`	읽기	아이콘 스케일링 매개변수 (/MK /IF).
`Type`	`FieldType`	읽기	필드 유형.
`FullName`	`string?`	읽기	전체 자격을 갖춘 필드 이름.
`TextHorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	읽기/쓰기	필드 위젯 외관에 적용되는 텍스트별 가로 정렬 오버라이드.
`PageIndex`	`int`	읽기	이 필드 위젯을 소유한 페이지의 1부터 시작하는 인덱스.
`PartialName`	`string?`	읽기/쓰기	부분 필드 이름 (/T).
`NormalAppearance`	`XForm?`	읽기	필드의 “Normal” 외관 (/AP /N 엔트리).
`Appearance`	`Aspose.Pdf.Annotations.AppearanceDictionary`	읽기	필드 위젯의 외관 스트림 (/AP 엔트리), 외관 이름을 키로 함.
`OnActivated`	`Annotations.PdfAction?`	읽기/쓰기	이 필드가 활성화될 때 트리거되는 동작 (/A 엔트리).
`Value`	`string?`	읽기/쓰기	필드 값 (/V).
`Count`	`int`	읽기	이 필드의 /Kids 배열에 있는 자식 수 — 자식 필드(계층 노드) 또는 위젯 주석(여러 시각 위젯을 가진 최종 필드, 예: 그룹화된 체크박스/라디오).
`Fields`	`Field[]`	읽기	이 필드의 필드 유형 자식들을 snapshot array로 — 양식의 Fields를 반영하는 편리한 accessor.
`DefaultValue`	`string?`	읽기	기본값 (/DV).
`AlternateName`	`string?`	읽기/쓰기	대체 필드 이름 / 툴팁 (/TU entry).
`Flags`	`Aspose.Pdf.Annotations.AnnotationFlags`	읽기/쓰기	위젯 주석 플래그 (/F entry), 예를 들어.
`TabOrder`	`int`	읽기/쓰기	이 필드의 탭 순서 인덱스.
`IsReadOnly`	`bool`	읽기	필드가 읽기 전용인지 여부.
`ReadOnly`	`bool`	읽기/쓰기	필드가 읽기 전용인지 여부 (API 패리티에 대한 설정 가능한 별칭).
`IsRequired`	`bool`	읽기	필드가 필수인지 여부.
`Characteristics`	`Aspose.Pdf.Annotations.Characteristics`	읽기	외관 특성 (테두리/배경 색상, 위젯 회전).
`DefaultAppearance`	`Aspose.Pdf.Annotations.DefaultAppearance`	읽기/쓰기	필드의 기본 외관(글꼴, 크기, 색상) — WidgetAnnotation의 필드 수준 대응.
`Rect`	`Rectangle?`	읽기/쓰기	필드 사각형.
`Color`	`Color`	읽기/쓰기	필드 색상(/DA 기본 외관 문자열에 RGB로 저장됨).
`AnnotationIndex`	`int`	읽기/쓰기	1 기반 탭 위치는 이 필드 위젯이 페이지의 /Annots 배열 내에서 차지하는 순서이며, 배열 순서는 페이지 탭 순서와 같습니다.
`FitIntoRectangle`	`bool`	읽기/쓰기	전역 플래그: true인 경우, 필드 값이 위젯 사각형에 맞도록 자동으로 크기가 조정됩니다.
`IsGroup`	`bool`	읽기	이 필드가 자식 필드들의 컨테이너/그룹인지 여부.
`IsSharedField`	`bool`	읽기/쓰기	이 필드가 공유 필드 그룹에 속하는지 여부.
`IsSynchronized`	`bool`	읽기	컬렉션이 스레드 안전한지 여부.
`SyncRoot`	`object`	읽기	동기화 루트; 이 인스턴스를 반환합니다.
`MaxFontSize`	`double`	읽기/쓰기	필드의 외형 자동 맞춤에 사용되는 최대 글꼴 크기.
`MinFontSize`	`double`	읽기/쓰기	필드의 외형 자동 맞춤에 사용되는 최소 글꼴 크기.
`MappingName`	`string?`	읽기/쓰기	외부 스크립트가 필드를 식별하기 위해 사용하는 매핑 이름.
`AnnotationType`	`AnnotationType`	읽기	항상 위젯.
`Border`	`Border?`	읽기/쓰기	테두리 너비, 스타일 및 대시 패턴은 위젯의 BS 사전에서 해석됩니다(양식 필드는 여기서 테두리를 보관하며 /Border에 있지 않습니다).
`Actions`	`AnnotationActionCollection`	읽기	위젯의 /AA 트리용 액션 슬롯.
`Exportable`	`bool`	읽기/쓰기	폼 제출 시 위젯 값이 내보내져야 하는지 여부.
`Highlighting`	`HighlightingMode`	읽기/쓰기	사용자가 위젯을 클릭할 때 사용되는 시각적 강조 모드 (/H 항목).
`Parent`	`Forms.Field?`	읽기	이 위젯이 AcroForm 필드의 시각적 자식인 경우 부모 필드.
`Required`	`bool`	읽기/쓰기	제출 전에 위젯을 반드시 입력해야 하는지 여부 (/Ff 비트 2).
`HighlightMode`	`string`	읽기	하이라이트 모드 (/H 항목).
`DefaultAppearanceString`	`string?`	읽기	기본 외관 문자열 (/DA 항목).
`FieldValue`	`string?`	읽기	필드 값 (/V 항목).
`DefaultFieldValue`	`string?`	읽기	기본 필드 값 (/DV 항목).
`FieldType`	`string?`	읽기	필드 유형 (/FT 항목).
`InnerRect`	`Rectangle?`	읽기	주석 사각형은 /RD (rectangle differences) 항목에 의해 안쪽으로 삽입됩니다 — 실제로 Rect 안에 그려지는 영역.
`Width`	`double`	읽기/쓰기	주석 사각형의 너비.
`Height`	`double`	읽기/쓰기	주석 사각형의 높이.
`ActiveState`	`string?`	읽기/쓰기	현재 활성화된 외관 상태 (/AS entry).
`Alignment`	`TextAlignment`	읽기/쓰기	텍스트 정렬 (리치 텍스트를 포함하는 자유 텍스트/위젯 주석용).
`HorizontalAlignment`	`Aspose.Pdf.HorizontalAlignment`	읽기/쓰기	수평 정렬 (Alignment 외에 추가로 제공되며; 두 옵션은 독립적으로 설정 가능).
`States`	`AppearanceDictionary`	읽기	Appearance-state 사전 (각 상태별 AP/N의 하위 사전, e.g.
`UpdateAppearanceOnConvert`	`bool`	읽기/쓰기	주석이 변환된 문서에 저장될 때 외관 스트림을 재생성할지 여부.
`UseFontSubset`	`bool`	읽기/쓰기	내장된 글꼴(있는 경우)을 서브셋화할지 여부.
`Contents`	`string?`	읽기/쓰기	주석 내용 (텍스트).
`Opacity`	`double`	읽기/쓰기	주석 불투명도 (0.0 = 투명, 1.0 = 불투명).
`InteriorColor`	`Color?`	읽기/쓰기	주석 내부 색상 (/IC entry, 원/사각형/선 주석에 사용).
`Title`	`string?`	읽기/쓰기	주석 제목 (마크업 주석의 저자).
`Name`	`string?`	읽기/쓰기	주석 이름 (고유 식별자 — /NM 항목).
`Subject`	`string?`	읽기/쓰기	주석 주제 (/Subj 항목).
`ModifiedDate`	`string?`	읽기	수정 날짜.
`Modified`	`DateTime`	읽기/쓰기	타입된 DateTime 형태의 /M (modified) 날짜.
`AnnotationFlags`	`AnnotationFlags`	읽기/쓰기	공개 표면과 일치하고 AnnotationFlags를 속성으로 노출하는 Flags의 타입 별칭.
`Action`	`PdfAction?`	읽기/쓰기	이 주석과 연결된 동작 (/A entry).
`Author`	`string?`	읽기	주석 작성자 (/T entry).
`AnnotationState`	`string?`	읽기	주석 상태 (/State entry), 예.
`AnnotationStateModel`	`string?`	읽기	주석 상태 모델 (/StateModel 항목), 예:
`ReplyType`	`string?`	읽기	답변 유형 (/RT 항목), 예:
`InReplyTo`	`Annotation?`	읽기/쓰기	이 주석이 회신하고 있는 주석 (/IRT entry).
`QuadPoints`	`Point[]`	읽기/쓰기	QuadPoints을(를) Point 값들의 배열로.
`Page`	`Page?`	읽기	이 주석을 소유하고 있는 페이지, 또는 해결할 수 없을 때는 null (e.g.
`VerticalAlignment`	`VerticalAlignment`	읽기/쓰기	이 문단에 수직 정렬이 적용되었습니다.
`Margin`	`MarginInfo`	읽기/쓰기	이 문단에 외부 여백 정보가 적용되었습니다.
`IsFirstParagraphInColumn`	`bool`	읽기/쓰기	문단이 새 열에서 시작하도록 강제합니다.
`IsKeptWithNext`	`bool`	읽기/쓰기	다음 문단과 같은 페이지에 이 문단을 유지하십시오.
`IsInNewPage`	`bool`	읽기/쓰기	문단을 새 페이지에서 시작하도록 강제하십시오.
`IsInLineParagraph`	`bool`	읽기/쓰기	인라인 단락 플래그 (새 줄을 시작하지 않음).
`HyperlinkText`	`string?`	읽기/쓰기	레거시 문자열형 하이퍼링크 대상.
`Hyperlink`	`Hyperlink?`	읽기/쓰기	문단에 적용된 타입 하이퍼링크 장식.
`ZIndex`	`int`	읽기/쓰기	DOM 렌더러에서 사용되는 Z-순서 인덱스.

메서드

시그니처	설명
`ButtonField()`	이 ButtonField 인스턴스에서 ButtonField를 호출합니다.
`ButtonField(doc: Document, rect: Rectangle)`	이 ButtonField 인스턴스에서 ButtonField(doc, rect)를 호출합니다.
`ButtonField(page: Page, rect: Rectangle)`	이 ButtonField 인스턴스에서 ButtonField(page, rect)를 호출합니다.
`AddImage(image: System.Drawing.Image)`	이미지를 버튼의 일반 아이콘으로 첨부합니다.
`Field(doc: Document)`	문서에 바인딩되는 필드를 생성합니다.
`GetEnumerator()`	이 필드의 /Kids 배열에 있는 자식들에 대한 위젯 주석을 반복합니다.
`CopyTo(array: Aspose.Pdf.Annotations.WidgetAnnotation[], index: int)`	위젯 주석을 배열에 복사하여 지정된 인덱스부터 시작합니다.
`CopyTo(array: Field[], index: int)`	이 필드의 자식들(Field 인스턴스)을 배열에 복사하여 지정된 인덱스부터 시작합니다.
`ExecuteFieldJavaScript(javaScriptAction: Aspose.Pdf.Annotations.JavascriptAction)`	제공된 JavaScript 작업을 이 필드에 대해 실행합니다.
`ExportToJson(stream: Stream)`	제공된 스트림을 통해 이 필드를 JSON(단일 FieldExportingData 객체)로 직렬화합니다.
`ExportToJson(fileName: string)`	이 필드를 JSON 파일로 직렬화합니다.
`ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?)`	제공된 스트림을 통해 이 필드를 JSON로 직렬화합니다.
`ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?)`	이 필드를 JSON 파일에 직렬화합니다.
`ExportValueToJson(outputJsonStream: Stream, indented: bool)`	필드의 이름, 플래그 및 값을 JSON 스트림에 기록합니다.
`Flatten()`	이 필드를 평탄화합니다 — 값을 정적 페이지 콘텐츠로 변환합니다.
`GetWidgetEnumerator()`	열거형이 WidgetAnnotation 타입으로 지정되었습니다.
`ImportValueFromJson(inputJsonStream: Stream)`	이 필드의 값을 JSON 스트림에서 읽습니다.
`ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string)`	이름이 지정된 필드의 값을 JSON 스트림에서 읽습니다 — 단일 필드 객체( ChildFields를 통해 중첩될 수 있음) 또는 그 배열 — 그리고 점으로 구분된 경로가 fieldFullNameInJSON과 일치하는 항목의 값을 적용합니다.
`Recalculate()`	계산 스크립트에서 필드 값을 다시 계산합니다.
`SetPosition(point: Aspose.Pdf.Point)`	필드의 첫 번째 위젯 사각형을 제공된 지점(좌상단)으로 이동합니다.
`WidgetAnnotation(doc: Document)`	Programmatic ctor — 문서 리더와 연결된 빈 위젯 주석을 생성합니다.
`ExportToJson(stream: System.IO.Stream)`	이 위젯의 필드를 JSON 로 스트림에 직렬화합니다.
`ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?)`	이 위젯의 필드를 단일 FieldExportingData JSON 객체로 스트림에 직렬화합니다.
`GetCheckedStateName()`	이 위젯의 “on”/“checked” 상태를 나타내는 외관 상태 이름을 반환합니다(일반적으로 “Yes”), 이는 /AP/N 사전의 키에서 찾아옵니다(“Off"가 아닌 모든 값).
`Accept(visitor: AnnotationSelector)`	이 ButtonField 인스턴스에서 Accept(visitor)를 호출합니다.
`GetRectangle(considerRotation: bool)`	considerRotation에 의해 경계 사각형이 조정됩니다.
`ChangeAfterResize(transform: Matrix)`	사용자가 페이지 또는 호스트 사각형의 크기를 조정한 후 주석의 기하학을 조정합니다.
`UpdateAppearances()`	주석의 현재 기하학 및 색상으로부터 일반 외관 스트림 (/AP /N)을 다시 생성합니다.
`WriteXfdf(writer: System.Xml.XmlWriter)`	이 주석을 XFDF 요소로 직렬화하여 writer에 기록합니다 (PDF 32000 §12.7.8 / XFDF 3.0).
`Clone()`	Shallow clone — 스칼라/레프-공유 상태를 복사합니다.

참조

Aspose.PDF for .NET — Enterprise API Reference