WidgetAnnotation
개요
WidgetAnnotation은 Aspose.PDF FOSS for .NET에 포함된 클래스입니다. 상속 대상: Annotation.
이 클래스는 .NET 프로그램에서 WidgetAnnotation 객체를 다루기 위한 13개의 메서드를 제공합니다. 사용 가능한 메서드에는: Accept, ChangeAfterResize, Clone, ExportToJson, Flatten, GetCheckedStateName, GetRectangle, UpdateAppearances, WidgetAnnotation, WriteXfdf가 있습니다. 모든 public 멤버는 Aspose.PDF FOSS for .NET 패키지를 설치한 후 모든 .NET 애플리케이션에서 접근할 수 있습니다. 속성: Action, Actions, ActiveState, Alignment, AnnotationFlags, AnnotationState, 및 53개 더.
속성
| 이름 | 유형 | 액세스 | 설명 |
|---|---|---|---|
AnnotationType | AnnotationType | 읽기 | 항상 Widget. |
Border | Border? | 읽기/쓰기 | 테두리 두께, 스타일 및 대시 패턴은 위젯의 BS 사전에서 해결됩니다 (양식 필드는 /Border가 아니라 그곳에 테두리를 보관합니다). |
Actions | AnnotationActionCollection | 읽기 | 위젯의 /AA 트리를 위한 액션 슬롯. |
DefaultAppearance | DefaultAppearance | 읽기/쓰기 | 이 위젯의 기본 외관(글꼴, 크기, 색상). |
Exportable | bool | 읽기/쓰기 | 폼 제출 시 위젯의 값을 내보낼지 여부. |
Highlighting | HighlightingMode | 읽기/쓰기 | 사용자가 위젯을 클릭할 때 사용되는 시각적 강조 모드 (/H 항목). |
OnActivated | PdfAction? | 읽기/쓰기 | 위젯이 활성화될 때 호출되는 동작 (/A 항목). |
Parent | Forms.Field? | 읽기 | 이 위젯이 AcroForm 필드의 시각적 자식인 경우의 상위 필드. |
ReadOnly | bool | 읽기/쓰기 | 위젯이 입력을 거부하는지 여부 (/Ff 비트 1). |
Required | bool | 읽기/쓰기 | 위젯을 제출하기 전에 채워야 하는지 여부 (/Ff 비트 2). |
HighlightMode | string | 읽기 | 하이라이트 모드 (/H 항목). |
DefaultAppearanceString | string? | 읽기 | 기본 외관 문자열 (/DA 항목). |
NormalAppearance | XForm? | 읽기 | 위젯의 “Normal” 외관 (/AP /N 스트림). |
FieldValue | string? | 읽기 | 필드 값 (/V 항목). |
DefaultFieldValue | string? | 읽기 | 기본 필드 값 (/DV 항목). |
FieldType | string? | 읽기 | 필드 유형 (/FT 항목). |
Rect | Rectangle? | 읽기/쓰기 | 주석 사각형(페이지상의 위치). |
InnerRect | Rectangle? | 읽기 | 주석 사각형은 /RD(rectangle differences) 항목에 의해 안쪽으로 삽입된 영역 — 실제로 Rect 내부에 그려지는 영역. |
Width | double | 읽기/쓰기 | 주석 사각형의 너비. |
Height | double | 읽기/쓰기 | 주석 사각형의 높이. |
ActiveState | string? | 읽기/쓰기 | 현재 활성화된 외관 상태 (/AS 항목). |
Alignment | TextAlignment | 읽기/쓰기 | 텍스트 정렬 (리치 텍스트를 포함하는 자유 텍스트/위젯 주석용). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | 읽기/쓰기 | 수평 정렬 (Alignment와 별도로 노출되며; 두 설정은 독립적으로 지정할 수 있습니다). |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | 읽기/쓰기 | 텍스트 전용 수평 정렬 재정의. |
Appearance | AppearanceDictionary | 읽기 | Appearance dictionary (/AP entry) — appearance 스트림 이름(N, D, R)을 키로 사용합니다. |
States | AppearanceDictionary | 읽기 | Appearance-state dictionary (AP/N의 상태별 하위 사전, 예: |
UpdateAppearanceOnConvert | bool | 읽기/쓰기 | 주석이 변환된 문서에 저장될 때 appearance 스트림을 재생성할지 여부. |
UseFontSubset | bool | 읽기/쓰기 | 임베드된 글꼴(있는 경우)을 서브셋화할지 여부. |
Contents | string? | 읽기/쓰기 | 주석 내용(텍스트). |
Opacity | double | 읽기/쓰기 | 주석 불투명도(0.0 = 투명, 1.0 = 불투명). |
Color | Color | 읽기/쓰기 | 주석 테두리 색상 (/C 항목). |
InteriorColor | Color? | 읽기/쓰기 | 주석 내부 색상 (/IC 항목, 원/사각형/선 주석용). |
Title | string? | 읽기/쓰기 | 주석 제목 (마크업 주석의 작성자). |
Name | string? | 읽기/쓰기 | 주석 이름 (고유 식별자 — /NM 항목). |
FullName | string? | 읽기 | 완전한 자격을 갖춘 주석 이름. |
Subject | string? | 읽기/쓰기 | 주석 주제 (/Subj 항목). |
ModifiedDate | string? | 읽기 | 수정 날짜. |
Modified | DateTime | 읽기/쓰기 | 입력된 DateTime 형식의 /M (modified) 날짜. |
Flags | AnnotationFlags | 읽기/쓰기 | 주석 플래그 (/F 항목) — int 형식과 typed 형식 모두에 대한 저장 백업으로 사용됩니다. |
AnnotationFlags | AnnotationFlags | 읽기/쓰기 | Flags의 타입 별 별칭으로, 공개 인터페이스와 일치하며 AnnotationFlags를 속성으로 노출합니다. |
Action | PdfAction? | 읽기/쓰기 | 이 주석 (/A 항목)과 연결된 동작. |
Author | string? | 읽기 | 주석 작성자 (/T 항목). |
AnnotationState | string? | 읽기 | 주석 상태 (/State 항목), 예. |
AnnotationStateModel | string? | 읽기 | 주석 상태 모델 (/StateModel 항목), 예. |
ReplyType | string? | 읽기 | 답글 유형 (/RT entry), 예. |
InReplyTo | Annotation? | 읽기/쓰기 | 이 답글이 회신하는 주석 (/IRT entry). |
QuadPoints | Point[] | 읽기/쓰기 | QuadPoints를 Point 값들의 배열로. |
Characteristics | Characteristics | 읽기 | 외관 특성(테두리 색, 배경 색, 회전). |
PageIndex | int | 읽기 | 이 주석이 속한 페이지의 1 기반 인덱스. |
Page | Page? | 읽기 | 이 주석을 소유하는 페이지, 또는 해결할 수 없을 때는 null (예: |
VerticalAlignment | VerticalAlignment | 읽기/쓰기 | 이 단락에 수직 정렬이 적용되었습니다. |
Margin | MarginInfo | 읽기/쓰기 | 이 단락에 외부 여백 정보가 적용되었습니다. |
IsFirstParagraphInColumn | bool | 읽기/쓰기 | 단락을 새 열에서 시작하도록 강제합니다. |
IsKeptWithNext | bool | 읽기/쓰기 | 이 단락을 다음 단락과 같은 페이지에 유지합니다. |
IsInNewPage | bool | 읽기/쓰기 | 단락을 새 페이지에서 시작하도록 강제합니다. |
IsInLineParagraph | bool | 읽기/쓰기 | 인라인 단락 플래그(새 줄을 시작하지 않음). |
HyperlinkText | string? | 읽기/쓰기 | 레거시 문자열형 하이퍼링크 대상. |
Hyperlink | Hyperlink? | 읽기/쓰기 | 단락에 적용된 타입별 하이퍼링크 장식. |
ZIndex | int | 읽기/쓰기 | DOM 렌더러에서 사용되는 Z-order 인덱스. |
메서드
| 시그니처 | 설명 |
|---|---|
WidgetAnnotation(doc: Document) | 프로그래매틱 ctor — 문서 리더와 연결된 기본 위젯 주석을 생성합니다. |
ExportToJson(stream: System.IO.Stream) | 이 위젯의 필드를 JSON 로 스트림에 직렬화합니다. |
ExportToJson(fileName: string) | 이 위젯의 필드를 JSON 형식으로 파일에 직렬화합니다. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | 이 위젯의 필드를 단일 FieldExportingData JSON 객체로 스트림에 직렬화합니다. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | 이 위젯의 필드를 JSON 형식으로 파일에 직렬화합니다. |
GetCheckedStateName() | 이 위젯의 “on” / “checked” 상태를 나타내는 외관 상태 이름(보통 “Yes”)을 반환합니다. 이 이름은 /AP/N 사전의 키 중 “Off"가 아닌 항목에서 조회됩니다. |
Accept(visitor: AnnotationSelector) | 이 WidgetAnnotation 인스턴스에 대해 Accept(visitor)를 호출합니다. |
GetRectangle(considerRotation: bool) | Bounding rectangle가 considerRotation에 의해 조정되었습니다. |
ChangeAfterResize(transform: Matrix) | 사용자가 페이지 또는 호스트 사각형의 크기를 조정한 후 주석의 기하학을 조정합니다. |
UpdateAppearances() | 주석의 현재 기하학 및 색상으로부터 일반 외관 스트림 (/AP /N)을 다시 생성합니다. |
WriteXfdf(writer: System.Xml.XmlWriter) | 이 주석을 XFDF 요소로 직렬화하여 writer에 기록합니다 (PDF 32000 §12.7.8 / XFDF 3.0). |
Flatten() | 이 주석을 평탄화합니다 — 시각적 모습을 페이지 내용에 렌더링하고 페이지의 주석 배열에서 제거합니다. |
Clone() | 얕은 복제 — 스칼라/참조 공유 상태를 복사합니다. |
