RichTextBoxField
개요
RichTextBoxField은(는) Aspose.PDF FOSS for .NET에 포함된 클래스입니다. 상속 대상: TextBoxField.
리치 텍스트 플래그(bit 26 of /Ff)를 포함하는 Tx 양식 필드입니다.
이 클래스는 .NET 프로그램에서 RichTextBoxField 객체를 작업하기 위한 34개의 메서드를 제공합니다. 사용 가능한 메서드에는 Accept, AddBarcode, AddImage, ChangeAfterResize, Clone, CopyTo, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field, Flatten, GetCheckedStateName 및 추가 메서드 11개가 포함됩니다. 모든 public 멤버는 Aspose.PDF FOSS for .NET 패키지를 설치한 후 모든 .NET 애플리케이션에서 접근할 수 있습니다. 속성: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags 및 추가 86개.
속성
| 이름 | 유형 | 액세스 | 설명 |
|---|---|---|---|
RichTextValue | string? | 읽기/쓰기 | 필드 값의 리치 텍스트 표현 (PDF /RV 엔트리). |
FormattedValue | string? | 읽기/쓰기 | 포맷된 (리치 텍스트) 표현; RichTextValue의 별칭. |
Value | string? | 읽기/쓰기 | 이 필드(/V 항목)에서 렌더링된 일반 텍스트 값. |
Style | string | 읽기/쓰기 | CSS-스타일 문자열이 리치 텍스트 조각에 적용됩니다 — 예. |
Justify | Aspose.Pdf.Annotations.Justification | 읽기/쓰기 | 텍스트 정렬. |
MaxFontSize | double | 읽기/쓰기 | 새로 생성된 모든 TextBoxFields의 자동 맞춤 외관에 적용되는 정적 기본값. |
MinFontSize | double | 읽기/쓰기 | 새로 생성된 모든 TextBoxFields의 자동 맞춤 외관에 적용되는 정적 기본값 — 자동 크기 조정된 글꼴의 하한값. |
FitIntoRectangle | bool | 읽기/쓰기 | 새로 생성된 모든 TextBoxFields의 FitIntoRectangle 플래그에 적용되는 정적 기본값. |
Width | double | 읽기/쓰기 | 필드가 레이아웃 컨테이너(테이블 셀, 단락) 안에 배치될 때 레이아웃 너비. |
Height | double | 읽기/쓰기 | 필드가 레이아웃 컨테이너 안에 배치될 때 레이아웃 높이. |
Multiline | bool | 읽기/쓰기 | 멀티라인 플래그 (/Ff의 비트 13). |
MaxLen | int | 읽기/쓰기 | 최대 길이를 가져오거나 설정합니다. |
IsMultiline | bool | 읽기 | 멀티라인 여부를 가져옵니다. |
IsPassword | bool | 읽기 | IsPassword 값을 가져옵니다. |
TextVerticalAlignment | VerticalAlignment | 읽기/쓰기 | 필드 외관 내 텍스트의 수직 정렬. |
IsRichText | bool | 읽기 | True는 Tx 필드에 rich-text 플래그(/Ff의 비트 26)가 설정된 경우. |
Justification | int | 읽기 | 텍스트 정렬: 0 = 왼쪽, 1 = 가운데, 2 = 오른쪽. |
ForceCombs | bool | 읽기/쓰기 | /Ff (Comb)의 비트 25: 설정되면, 필드가 MaxLen개의 동일한 너비 comb으로 나뉩니다. |
Scrollable | bool | 읽기/쓰기 | /Ff 비트 24의 반전 (DoNotScroll). |
SpellCheck | bool | 읽기/쓰기 | /Ff 비트 23의 반전 (DoNotSpellCheck). |
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 항목). |
Count | int | 읽기 | 이 필드의 /Kids 배열에 있는 자식 수 — 자식 필드(계층 노드) 또는 위젯 주석(그룹화된 체크박스/라디오와 같은 여러 시각 위젯을 가진 최종 필드). |
Fields | Field[] | 읽기 | 이 필드의 필드 유형 자식들을 스냅샷 배열로 제공 — 폼의 Fields를 그대로 반영하는 편리한 접근자. |
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 | 읽기/쓰기 | 필드 색상 (RGB 형식으로 /DA 기본 외관 문자열에 저장됨). |
AnnotationIndex | int | 읽기/쓰기 | 이 필드의 위젯이 페이지의 /Annots 배열 내에서 차지하는 1 기반 탭 위치 — 배열 순서는 페이지 탭 순서입니다. |
IsGroup | bool | 읽기 | 이 필드가 자식 필드들의 컨테이너/그룹인지 여부. |
IsSharedField | bool | 읽기/쓰기 | 이 필드가 공유 필드 그룹에 속하는지 여부. |
IsSynchronized | bool | 읽기 | 컬렉션이 스레드 안전인지 여부. |
SyncRoot | object | 읽기 | 동기화 루트; 이 인스턴스를 반환합니다. |
MappingName | string? | 읽기/쓰기 | 외부 스크립트가 필드를 식별하는 데 사용하는 매핑 이름. |
AnnotationType | AnnotationType | 읽기 | 항상 Widget. |
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 내부에 그려지는 영역. |
ActiveState | string? | 읽기/쓰기 | 현재 활성화된 외관 상태 (/AS 엔트리). |
Alignment | TextAlignment | 읽기/쓰기 | 자유 텍스트/위젯 주석에 포함된 서식 있는 텍스트의 텍스트 정렬. |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | 읽기/쓰기 | 정렬 외에 노출되는 수평 정렬; 두 옵션은 독립적으로 설정할 수 있습니다. |
States | AppearanceDictionary | 읽기 | Appearance-state dictionary (AP/N의 상태별 하위 사전, 예시). |
UpdateAppearanceOnConvert | bool | 읽기/쓰기 | 주석이 변환된 문서에 저장될 때 appearance stream을 다시 생성할지 여부. |
UseFontSubset | bool | 읽기/쓰기 | 내장된 폰트(있는 경우)를 서브셋할지 여부. |
Contents | string? | 읽기/쓰기 | 주석 내용(텍스트). |
Opacity | double | 읽기/쓰기 | 주석 불투명도 (0.0 = 투명, 1.0 = 불투명). |
InteriorColor | Color? | 읽기/쓰기 | 주석 내부 색상 (/IC 항목, 원/사각형/선 주석용). |
Title | string? | 읽기/쓰기 | 주석 제목 (주석 마크업을 위한 저자). |
Name | string? | 읽기/쓰기 | 주석 이름 (고유 식별자 — /NM 항목). |
Subject | string? | 읽기/쓰기 | 주석 주제 (/Subj 항목). |
ModifiedDate | string? | 읽기 | 수정 날짜. |
Modified | DateTime | 읽기/쓰기 | 타입된 DateTime 형식의 /M (수정된) 날짜. |
AnnotationFlags | AnnotationFlags | 읽기/쓰기 | 공개 표면과 일치하는 Flags의 타입 별칭으로, AnnotationFlags을 속성으로 노출합니다. |
Action | PdfAction? | 읽기/쓰기 | 이 주석과 연결된 동작 (/A 항목). |
Author | string? | 읽기 | 주석 작성자 (/T 항목). |
AnnotationState | string? | 읽기 | 주석 상태 (/State entry), 예: |
AnnotationStateModel | string? | 읽기 | 주석 상태 모델 (/StateModel entry), 예: |
ReplyType | string? | 읽기 | 응답 유형 (/RT entry), 예: |
InReplyTo | Annotation? | 읽기/쓰기 | 이 주석이 답변하고 있는 (/IRT 항목). |
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-order 인덱스. |
메서드
| 시그니처 | 설명 |
|---|---|
RichTextBoxField(page: Page, rect: Rectangle) | 주어진 페이지 사각형에 리치 텍스트 필드를 생성합니다. |
TextBoxField(page: Page, rect: Rectangle) | 지정된 페이지에 주어진 사각형으로 새로운 텍스트 박스 필드를 생성합니다. |
TextBoxField(doc: Document, rect: Rectangle) | 문서와 연결된 새로운 텍스트 박스 필드를 생성합니다 (페이지는 Form.Add을 통해 할당됩니다). |
TextBoxField(doc: Document) | 직사각형 없이 문서에 바인딩된 텍스트 박스. |
TextBoxField(page: Page, rects: Rectangle[]) | 다중 위젯 텍스트 필드 — 첫 번째 직사각형은 위젯 사전에 사용되고; 추가 직사각형은 다중 위젯 계약에 따라 /Kids에 저장됩니다. |
TextBoxField() | 매개변수 없는 ctor — 바인딩되지 않은 텍스트 박스 필드를 생성합니다. |
AddBarcode(code: string) | 필드 값에 자리표시자 바코드로 코드를 인코딩합니다. |
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() | Enumerator가 WidgetAnnotation 타입으로 지정되었습니다. |
ImportValueFromJson(inputJsonStream: Stream) | 이 필드의 값을 JSON 스트림에서 읽습니다. |
ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string) | 이름이 지정된 필드의 값을 JSON 스트림에서 읽습니다 — 단일 필드 객체( ChildFields를 통해 중첩될 수 있음) 또는 그 배열 — 그리고 점 표기 경로가 fieldFullNameInJSON과 일치하는 항목의 값을 적용합니다. |
Recalculate() | 계산 스크립트에서 필드 값을 다시 계산합니다. |
SetPosition(point: Aspose.Pdf.Point) | 필드의 첫 번째 위젯 사각형을 제공된 지점(왼쪽 위 모서리)으로 이동합니다. |
WidgetAnnotation(doc: Document) | 프로그래밍 방식 ctor — 문서 리더와 연결된 기본 위젯 주석을 생성합니다. |
ExportToJson(stream: System.IO.Stream) | 이 위젯 필드를 JSON 형태로 스트림에 직렬화합니다. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | 이 위젯 필드를 단일 FieldExportingData JSON 객체로 스트림에 직렬화합니다. |
GetCheckedStateName() | 이 위젯의 “on”/“checked” 상태를 나타내는 appearance state name을 반환합니다 (보통 “Yes”), /AP/N 사전의 키에서 찾아봅니다 (“Off"가 아닌 모든 것). |
Accept(visitor: AnnotationSelector) | 이 RichTextBoxField 인스턴스에 대해 Accept(visitor)를 호출합니다. |
GetRectangle(considerRotation: bool) | considerRotation에 의해 조정된 경계 사각형. |
ChangeAfterResize(transform: Matrix) | 사용자가 페이지 또는 호스트 사각형의 크기를 조정한 후 주석의 기하학을 조정합니다. |
UpdateAppearances() | 주석의 현재 기하학 및 색상으로부터 일반 외관 스트림 (/AP /N)을 재생성합니다. |
WriteXfdf(writer: System.Xml.XmlWriter) | 이 주석을 XFDF 요소로 직렬화하여 라이터에 씁니다 (PDF 32000 §12.7.8 / XFDF 3.0). |
Clone() | 얕은 복제 — 스칼라/참조 공유 상태를 복사합니다. |