Page
개요
Page은 Aspose.PDF FOSS for .NET에 포함된 클래스입니다. 상속 대상: IDisposable.
PDF 문서의 페이지를 나타냅니다.
이 클래스는 .NET 프로그램에서 Page 객체를 다루기 위한 58개의 메서드를 제공합니다. 사용 가능한 메서드에는 Accept, AddContent, AddContentStream, AddExtGState, AddFloatingBox, AddGraph, AddGraphics, AddImage, AddStamp, AddTable, AsByteArray, AsXml 및 추가 28개의 메서드가 포함됩니다. 모든 public 멤버는 Aspose.PDF FOSS for .NET 패키지를 설치한 후 any .NET 애플리케이션에서 접근할 수 있습니다. 속성: Actions, Annotations, ArtBox, Artifacts, Background, BackgroundImage 및 추가 35개.
속성
| 이름 | 유형 | 액세스 | 설명 |
|---|---|---|---|
Number | int | 읽기 | 1부터 시작하는 페이지 번호. |
FieldsInTabOrder | IList<Forms.Field> | 읽기 | 이 페이지에 위젯이 표시되는 폼 필드들로, 탭 순서에 따라 정렬됩니다. |
Rect | Rectangle | 읽기/쓰기 | 페이지 사각형 (기본값은 MediaBox입니다). |
Rectangle | Rectangle | 읽기/쓰기 | 페이지 사각형. |
PageInfo | PageInfo | 읽기/쓰기 | 너비/높이/여백 속성을 가진 페이지 정보 컨테이너. |
Background | Color? | 읽기/쓰기 | 페이지 배경 색상. |
MediaBox | Rectangle | 읽기/쓰기 | 이 페이지의 미디어 박스(사양에 따라 필수). |
CropBox | Rectangle | 읽기/쓰기 | 크롭 박스(기본값은 미디어 박스). |
BleedBox | Rectangle | 읽기/쓰기 | 블리드 박스 (기본값은 크롭 박스). |
TrimBox | Rectangle | 읽기/쓰기 | 트림 박스 (기본값은 크롭 박스). |
ArtBox | Rectangle | 읽기/쓰기 | 아트 박스(기본값은 크롭 박스). |
Rotate | Rotation | 읽기/쓰기 | 페이지 회전은 Rotation 열거형으로. |
RotateDegrees | int | 읽기/쓰기 | 페이지 회전(단위: 도)을 int로 표시 (0, 90, 180, 270). |
RotationMatrix | Matrix | 읽기 | 회전되지 않은 PDF 좌표계를 페이지의 사용자 가시(회전된) 좌표계에 매핑하는 아핀 변환. |
Duration | double | 읽기/쓰기 | 프레젠테이션 모드에서 페이지 표시 지속 시간(초). |
Annotations | AnnotationCollection | 읽기 | 이 페이지의 주석. |
Images | XImageCollection | 읽기 | 이 페이지의 이미지 XObjects. |
Fonts | FontCollection | 읽기 | 이 페이지에서 참조되는 폰트. |
Resources | Resources | 읽기 | 페이지 리소스(폰트, 이미지) — 통합 Resources 객체를 통해 접근을 제공합니다. |
Patterns | IReadOnlyDictionary<string, Pattern> | 읽기 | 이 페이지의 패턴 리소스(패턴 이름을 키로 함). |
Contents | OperatorCollection | 읽기 | 콘텐츠 스트림 연산자 컬렉션. |
ContentsAppender | ContentsAppender | 읽기 | 이 페이지의 콘텐츠 스트림에 앞에 붙이거나 뒤에 추가하기 위해 연산자를 버퍼링하는 헬퍼이며, UpdateData에 적용됩니다. |
Width | double | 읽기 | 회전을 고려한 가시 페이지 폭. |
Height | double | 읽기 | 회전을 고려한 가시 페이지 높이. |
ColorType | ColorType | 읽기 | 콘텐츠 스트림 연산자와 이미지 색상 공간을 분석하여 이 페이지의 색상 유형을 가져옵니다. |
Transition | PageTransition? | 읽기 | 페이지 전환 효과이며, 설정되지 않은 경우 null입니다. |
Header | HeaderFooter? | 읽기/쓰기 | 이 페이지 상단에 렌더링할 헤더. |
Footer | HeaderFooter? | 읽기/쓰기 | 이 페이지 하단에 렌더링될 푸터. |
TocInfo | TocInfo? | 읽기/쓰기 | 이 페이지에 대한 TOC 정보. |
Paragraphs | Paragraphs | 읽기/쓰기 | 이 페이지에 추가할 단락 객체들의 컬렉션 (TextFragment, HtmlFragment, Table, Heading 등). |
NoteLineStyle | GraphInfo | 읽기/쓰기 | 각주 / 미주 구분선을 그릴 때 사용되는 기본 스트로크/채우기 스타일. |
Artifacts | ArtifactCollection | 읽기 | 이 페이지에 아티팩트(워터마크 등)를 추가하기 위한 컬렉션. |
OcgLayers | LayerCollection | 읽기 | 이 페이지에서 참조된 레이어(Optional Content Groups)를 가져옵니다. |
Actions | PageActionCollection | 읽기 | 페이지당 추가 작업(열기 / 닫기 / 기타), /AA에 의해 지원됩니다. |
UserUnit | double | 읽기/쓰기 | 사용자 단위 계수(PDF 32000 §14.8.4 /UserUnit 항목). |
IsAddParagraphsAfterLast | bool | 읽기/쓰기 | 문단 추가가 끝에 붙는지 여부(흐름 위치와 대비). |
BackgroundImage | Image? | 읽기/쓰기 | 페이지 배경 이미지. |
Group | Group? | 읽기/쓰기 | 이 페이지에 대한 그룹 / 블렌딩 색상 공간 사전. |
TabOrder | TabOrder | 읽기/쓰기 | 탭 순서 (PDF 32000 §12.5 /Tabs entry). |
Watermark | Watermark? | 읽기/쓰기 | 페이지 워터마크. |
Layers | System.Collections.Generic.List<Layer> | 읽기/쓰기 | 페이지 레이어 (Optional Content Groups). |
메서드
| 시그니처 | 설명 |
|---|---|
SetRotation(degrees: int) | 페이지 회전을 도 단위로 설정합니다 (0, 90, 180, 270). |
SetMediaBox(rect: Rectangle) | 이 페이지의 미디어 박스를 설정합니다. |
SetCropBox(rect: Rectangle) | 이 페이지의 크롭 박스를 설정합니다. |
SetBleedBox(rect: Rectangle) | 이 페이지의 블리드 박스를 설정합니다. |
SetTrimBox(rect: Rectangle) | 이 페이지의 트림 박스를 설정합니다. |
SetArtBox(rect: Rectangle) | 이 페이지의 아트 박스를 설정합니다. |
Accept(visitor: Annotations.AnnotationSelector) | 방문자를 통해 이 페이지의 모든 주석을 순회합니다; 일치 항목은 Selected에 누적됩니다. |
GetResources() | Resources에 대한 메서드 스타일 접근자 — public-API 패리티. |
SetPageSize(width: double, height: double) | 페이지 크기를 MediaBox을(를) 업데이트하여 설정합니다. |
GetPageRect(considerRotation: bool) | 페이지 사각형을 가져오며, 선택적으로 CropBox을 고려합니다. |
Accept(visitor: Text.TextAbsorber) | 공개 API와 일치하는 TextAbsorber 방문자를 허용합니다. |
GetText() | TextAbsorber를 사용하여 페이지에서 모든 텍스트를 추출합니다. |
Accept(visitor: Text.TextFragmentAbsorber) | 공개 API와 일치하는 TextFragmentAbsorber 방문자를 허용합니다. |
GetTextRotationStatistic() | 이 페이지에서 각 회전 각도별로 그려진 텍스트 조각의 수를 계산합니다. |
Accept(visitor: ImagePlacementAbsorber) | ImagePlacementAbsorber 방문자를 수락합니다 (공개 API와 일치함). |
SendTo(device: Devices.ImageDevice, outputFileName: string) | 이 페이지에 스탬프를 추가합니다. |
SendTo(device: Devices.ImageDevice, output: Stream) | 지정된 장치를 사용하여 이 페이지를 렌더링하고 스트림에 씁니다. |
AddStamp(stamp: ImageStamp) | 이 페이지에 이미지 스탬프를 적용합니다. |
AddStamp(stamp: PdfPageStamp) | 이 페이지에 페이지 스탬프를 적용합니다. |
AddStamp(stamp: Aspose.Pdf.Stamps.Stamp) | 이 Page 인스턴스에서 AddStamp(stamp)를 호출합니다. |
AddContentStream(contentBytes: byte[]) | 이 페이지에 콘텐츠 스트림을 추가합니다. |
PrependContentStream(contentBytes: byte[]) | 기존 페이지 콘텐츠 앞에 콘텐츠 스트림 바이트를 추가합니다 (배경 요소용). |
AddContent(contentStreamBytes: byte[]) | 이 페이지에 콘텐츠 스트림 바이트를 추가합니다. |
AddTable(table: Table) | 이 페이지에 표를 추가합니다. |
AddGraph(graph: Drawing.Graph) | 이 페이지에 그래프(도형 모음)를 추가합니다. |
AddFloatingBox(box: FloatingBox) | 이 페이지에 플로팅 박스를 추가합니다. |
AddExtGState(extGState: Content.ExtGState) | 이 페이지의 리소스에 ExtGState 사전을 추가하고 리소스 이름을 반환합니다. |
AddImage(imageData: byte[], rect: Rectangle, blackWhite: bool) | 지정된 위치와 크기로 이 페이지에 이미지를 추가합니다. |
AddImage(imageStream: Stream, rect: Rectangle) | 스트림에서 이미지를 가져와 지정된 위치와 크기로 이 페이지에 추가합니다. |
AddImage(imagePath: string, rectangle: Rectangle) | 파일 경로에서 이미지를 추가합니다; 사각형이 이미지를 제한하며, 이미지는 자체 종횡비를 유지하면서 중앙에 배치됩니다. |
AddImage(imageStream: Stream, imageRect: Rectangle, bbox: Rectangle, autoAdjustRectangle: bool) | imageRect에 explicit bounding-box를 사용하여 이미지를 추가합니다. |
AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool) | 명시적인 픽셀 크기와 비율 플래그를 사용하여 이미지를 추가합니다 (bbox는 이미지 사각형으로 기본 설정됩니다). |
AddImage(imageStream: Stream, imageRect: Rectangle, imageWidth: int, imageHeight: int, saveImageProportions: bool, bbox: Rectangle) | 명시적인 픽셀 크기와 bbox를 사용하여 이미지를 추가합니다. |
AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle) | 이미지를 삽입하고 HOCR(OCR) 문자열을 보이지 않는 텍스트 레이어로 오버레이합니다(텍스트 렌더링 모드 3). 이렇게 하면 페이지에 이미지는 표시되지만 인식된 텍스트는 검색 가능하고 복사·붙여넣기가 가능합니다. |
AddImage(hocr: string, imageStream: Stream, imageRect: Rectangle, bbox: Rectangle) | 이미지를 삽입하고 HOCR(OCR) 문자열을 보이지 않는 텍스트 레이어로 오버레이합니다; API 패리티를 위해 bbox가 허용됩니다. |
Resize(targetSize: Aspose.Pdf.PageSize) | 미디어 박스 업데이트를 통해 이 페이지를 targetSize로 크기 조정합니다. |
AsByteArray(resolution: Aspose.Pdf.Devices.Resolution) | 요청된 해상도로 이 페이지를 PNG 바이트 배열로 렌더링합니다. |
Flatten() | 이 페이지의 모든 주석을 평탄화합니다 — 시각적 모양을 페이지 콘텐츠 스트림에 렌더링하고 주석 배열에서 제거합니다. |
ConvertToPNGMemoryStream() | 페이지가 빈 페이지인지(의미 있는 콘텐츠가 없는지) 판단합니다. |
IsBlank(fillThresholdFactor: double) | 이 Page 인스턴스에서 IsBlank(fillThresholdFactor)를 호출합니다. |
MergeLayers(newLayerName: string) | 이 페이지의 모든 레이어를 지정된 이름을 가진 단일 레이어로 병합합니다. |
MergeLayers(newLayerName: string, newOptionalContentGroupId: string) | 이 페이지의 모든 레이어를 병합하고, 새 OCG에 지정된 ID를 할당합니다. |
HasVectorGraphics() | 이 페이지가 벡터 그래픽을 그리는지 여부, 즉. |
TrySaveVectorGraphics(pathToSave: string) | 이 페이지에서 벡터 그래픽을 pathToSave에 저장합니다. |
AsXml() | 이 페이지의 진단 XML 표현. |
GetNotifications() | 저장하기 전에 EnableNotificationLogging가 설정되었을 때 이 페이지의 흐름 레이아웃에서 발생한 줄바꿈 알림. |
MakeGrayscale() | 이 페이지의 색상을 회색조로 변환합니다: 콘텐츠 스트림 색상 연산자, 이미지 XObjects, 명명된 색상 공간 리소스, 및 주석 외관. |
IntToRotation(rotation: int) | degrees-int 회전을 Rotation으로 변환합니다. |
RotationToInt(rotation: Rotation) | Rotation을 정수 형태의 degrees로 변환합니다. |
FreeMemory() | 캐시된 데이터를 지웁니다. |
Dispose() | 메모리를 해제합니다. |
CalculateContentBBox() | 이 페이지의 page space에서 모든 그려진 콘텐츠(텍스트, 벡터 경로, 이미지, 인라인 이미지, Form XObject를 재귀적으로 포함)를 둘러싸는 가장 작은 axis-aligned rectangle를 계산합니다. |
SendTo(device: PageDevice, output: Stream) | 이 페이지를 PageDevice를 통해 스트림으로 렌더링합니다. |
SendTo(device: PageDevice, outputFileName: string) | 이 페이지를 PageDevice를 통해 파일로 렌더링합니다. |
AddStamp(stamp: Stamp) | 그 스탬프를 Put(Page) 오버라이드로 적용합니다. |
AddGraphics(elements: GraphicElementCollection) | 주어진 벡터 요소들을 (보통 GraphicsAbsorber에 의해 생성됨) 이 페이지의 콘텐츠 스트림에 추가하여, 각 요소의 기하학을 페이지 공간에 재현합니다. |
AddGraphics(elements: GraphicElementCollection, rectangle: Rectangle) | 벡터 요소를 추가합니다; 사각형은 참고용이며(요소들은 전체가 출력되고 자체 기하학을 포함합니다). |
DeleteGraphics(elementsToDelete: GraphicElementCollection) | 동일합니다 — 벡터 요소 제거는 구현되어 있지 않습니다. |
