고급 렌더링 및 내보내기

PDF, SVG, 비트맵, 메타파일, 미리 보기 및 인쇄 경로는 형식별 인코더를 유지하면서 하나의 페이지 매김 모델과 백엔드 중립적인 기하 구조를 공유합니다

사용자 지정 그래픽 백엔드

TXLSGraphicsTextAlign 은 TXLSGraphicsBackend의 왼쪽, 가운데, 오른쪽 텍스트 정렬을 정의합니다. 스타일이 적용된 그리기 호출은 나머지 공유 열거형 — 글꼴 스타일(TXLSGraphicsFontStyles), 선 끝 모양(TXLSGraphicsLineCap), 대시 패턴(TXLSGraphicsLineDash), 세로 텍스트 정렬(TXLSGraphicsTextVAlign) — 을 받습니다

구현은 포인트 단위의 좌표, 해석된 텍스트 및 이미지 효과, 클리핑, 페이지 로컬 그리기 배치를 받으므로 통합 문서 레이아웃 논리를 반복할 필요가 없습니다. 논리 페이지의 각 그리기 항목은 TXLSPageDrawingPlacement 레코드로 전달되며, 이 레코드의 Kind (TXLSPageDrawingKind: xpdkImage, xpdkChart, xpdkTextBox, xpdkShape, xpdkControl)가 백엔드에 무엇을 그리는지 알려줍니다. 워크시트 배경 타일은 디코딩된 TXLSSheetBackgroundRenderData

작업 소유 렌더 기하 구조

TXLSPaginationModel.RenderBackend 는 다음 Build 호출이 캡처할 백엔드 식별자를 선택하고, RenderGeometry 는 그 결과로 만들어진 변경 불가능한 캘리브레이션, 통합 문서 세대, 백엔드, 크기가 제한된 메트릭 캐시 상태를 노출합니다. 활성 렌더 세션은 TXLSRenderSession 핸들로 전달되고 색상 정책은 TXLSRenderColorMode (xlsrcColor 또는 xlsrcMonochrome)입니다

PDF 모델은 xlsrgbPdf를, SVG는 xlsrgbSvg를, 페이지 이미지는 xlsrgbBitmap을, 인쇄 및 인쇄 미리 보기 모델은 xlsrgbPrintPreview를, TXLSWorkbookViewer 는 xlsrgbViewer를 사용합니다. SVG, 이미지, 인쇄, 뷰어 컴포넌트의 PaginationModel 은 소유권을 넘기지 않으면서 진단용으로 활성 모델을 노출합니다

클래식 및 XLSX HTML 진입점은 xlsrgbHtml을 캡처합니다. TXLSHTMLExport.RenderGeometry 는 가장 최근의 클래식 스냅샷을 노출하고, TXLSXHtmlExportSession.RenderGeometry 는 증분 내보내기에서 모든 시트에 걸쳐 유지되는 스냅샷을 노출합니다

HTML 열 출력은 통합 문서 문자 폭 모델을 Normal 글꼴 최대 숫자 폭과 설정된 화면 배율로 환산한 뒤 고정된 CSS 픽셀 길이로 내보냅니다. 포인트-픽셀 변환은 동일하게 캡처된 측정 DPI를 사용합니다

각 작업은 이후 통합 문서가 바뀌어도 캡처 당시의 캘리브레이션을 유지하며, 렌더링은 워크시트 행 높이나 열 너비를 절대 기록하지 않습니다. 페이지 매김은 TXLSLogicalPage 개체로 페이지를 구성하는데, 이 개체의 그리기 목록, 방향(TXLSPageOrientation: xpoPortrait 또는 xpoLandscape), 주석 배치(TXLSPrintComments: xpcNone 또는 xpcAtEnd)는 해석된 페이지 설정에서 나옵니다

논리 페이지는 백엔드나 Callback에 필요한 모든 것을 노출합니다: 식별 정보(DocumentPageNumber, SheetPageNumber, SheetName, 소유 ClassicWorksheet 또는 XlsxWorksheet), 지오메트리(PageWidth, PageHeight, Scale, 그리고 LeftMargin, RightMargin, TopMargin, BottomMargin, HeaderMargin, FooterMargin 값), 인쇄 제목이 붙은 데이터 사각형(DataFirstRow, DataLastRow, DataFirstCol, DataLastCol및RepeatFirstRow, RepeatLastRow, RepeatFirstCol, RepeatLastCol), 배경 배치(BackgroundOffsetX, BackgroundOffsetY), 눈금선 출력(PrintGridlines, GridlineColor), 여섯 개의 머리글/바닥글 밴드 텍스트(LeftHeader, CenterHeader, RightHeader, LeftFooter, CenterFooter, RightFooter), 행/열 뼈대(RowCount 와 Rows 를 갖는 RowEdges, ColumnCount 와 Columns 를 갖는 ColumnEdges), 그리고 그리기 목록(DrawingCount 와 Drawings)입니다. ExpandHeaderFooter 는 페이지를 기준으로 머리글/바닥글 서식 코드를 해석하고, ExpandHeaderFooterStyled 는 여기에 더해 선행 포인트 크기와 색상까지 보고하므로 사용자 지정 페인터가 Excel 자체 머리글 렌더링과 똑같이 맞출 수 있습니다

네이티브 페이지 매김에서 병합된 셀

TXLSPaginationModel.RenderPageToBackend는 병합 범위를 원래 앵커로 해석하고 페이지 조각마다 보이는 사각형 하나를 그립니다. 덮인 셀은 중복 텍스트나 내부 눈금선을 내보내지 않습니다

XLSX 조각은 앵커의 채우기, 정렬, 줄바꿈, 폰트, 조건부 서식 평가를 공유하고, 명시적인 바깥 테두리 세그먼트는 계속 보이며 병합 내부 테두리는 억제됩니다. 클래식 조각은 기존 클래식 텍스트 페인터를 통해 앵커의 텍스트와 단색 채우기를 공유합니다

인쇄 영역이나 페이지 나누기는 병합 범위를 잘라낼 수 있으며, 앵커가 인쇄 영역 밖에 있어도 모든 보이는 조각은 원래 앵커를 사용합니다. 숨겨진 행과 열은 크기 0으로 기여하고, 반복 인쇄 제목 조각도 같은 앵커 정책을 따릅니다

병합이 범위를 한 페이지로 몰아 넣거나 인쇄 영역을 늘리거나 저장된 행 높이·열 너비를 바꾸지는 않습니다. 페이지 매김은 기존 페이지 설정을 유지하고 각 조각을 자신의 논리 페이지로 잘라냅니다

워크시트 배경 렌더링

통합 문서 뷰어는 유효한 클래식 및 XLSX 워크시트 배경을 채워지지 않은 셀 뒤에 반복 타일로 표시하며, 명시적 셀 채우기와 조건부 서식 채우기는 배경 위에 유지됩니다

TXLSPaginationModel, TXLSSvgExport, TXLSPageImageExporter, TXLSPrintDocument, TXLSPDFExport, TXLSHTMLExport, TXLSXHtmlExportOptions, TXLSWorkbookViewer 는 ExportSheetBackgroundImages를 노출합니다. 인쇄, 미리 보기, 메타파일, PDF, SVG, 비트맵, HTML 출력에서 기본값은 False 입니다. 워크시트는 TXLSSheetBackgroundFormat 이미지 형식으로 페이로드를 저장하고, 디코딩된 바이트는 세대, DPI, 색상 모드로 식별되는 TXLSSheetBackgroundResource 로 전달됩니다

활성화된 페이지 매김 출력은 페이지 경계를 넘어 타일 위상을 워크시트 좌표에 고정하고, 렌더 세션 동안 워크시트·리소스 세대·백엔드·DPI·색상 모드 조합별로 디코딩된 이미지를 하나씩 유지합니다. BackgroundDecodeCount 는 진단용 디코딩 총횟수를 노출하고, 손상된 페이로드는 통합 문서 진단과 함께 건너뜁니다. 활성 TXLSRenderSession 이 이 공유 캐시를 직접 관리합니다. AcquireBackground 는 워크시트의 타일용 TXLSSheetBackgroundRenderData 를 가져오고(또는 한 번만 디코딩), DrawTiledBackground 는 잘라낸 페이지 영역에 걸쳐 그리며, DecodeCount 는 지금까지 디코딩된 페이로드 수를 보고합니다

통합 문서 개체 표시 정책

ObjectDisplayMode 는 클래식 XLS와 XLSX 통합 문서 모두에 대해 xlsodmShowAll, xlsodmShowPlaceholders, xlsodmHideAll 중 하나를 선택합니다. 뷰어는 세 상태를 모두 처리하며, 자리 표시자 모드에서는 비용이 낮은 유형/이름/텍스트/대체 텍스트 상자를 사용합니다

PDF, SVG, 비트맵, 실제 인쇄, XLSX HTML 내보내기는 기본적으로 자리 표시자 모드를 전체 개체 출력으로 처리합니다. 이미지 디코딩이나 차트 씬 구성 없이 상자만 원한다면 해당 내보내기 또는 HTML 옵션에 ExportObjectPlaceholders 를 설정하세요

xlsodmHideAll 은 더 앞단의 전역 게이트로, 그리기 수집, 개체 기반 범위 확장, 히트 테스트, 미디어 렌더링 자체를 차단합니다. 워크시트 배경, 조건부 서식 아이콘, 머리글/바닥글 그림, 셀, 내보내기별 print-object 필터는 여전히 독립적입니다

차트 소스 데이터 새로 고침

XLSX 차트 직렬화와 공유 차트 렌더링은 현재 통합 문서 세대를 기준으로 로컬 계열 캐시를 해석하므로, 출력 전에 소스 셀 편집, 재계산, 표시 여부 변경이 값, 범주, 거품 크기, 범위 연결 계열 이름을 새로 고칩니다

일반 소스 범위는 로컬 A1 참조의 한 행 또는 한 열이어야 합니다. 따옴표로 묶은 워크시트 이름을 지원하며, 한정되지 않은 범위는 차트가 속한 워크시트를 기준으로 해석됩니다. 계층형 범주 수준은 별도의 사각형 범위 해석기를 그대로 유지합니다

범주 텍스트는 서식이 적용된 셀 텍스트를 쓰고, 숫자 캐시는 빈 칸과 숫자가 아닌 텍스트에 대해 빈 점 슬롯을 유지하며, 오류 셀은 표시되는 오류 리터럴을 유지하고, 날짜는 통합 문서의 1900 또는 1904 직렬 체계를 사용합니다. 숨긴 소스 행·열을 생략할지는 PlotVisibleOnly가 결정합니다

로컬 소스가 한 번도 구체화되지 않았다면 가져오거나 수동으로 채운 캐시는 유지되고, 이미 로컬 셀에서 관리되던 캐시는 삭제 후 오래된 점을 지웁니다. TXLSXChartSeries.RefreshDataCaches는 빈 소스 범위를 포함해 해석 가능한 로컬 소스를 명시적으로 새로 고칩니다

외부 통합 문서 참조와 지원되지 않는 참조 식은 저장된 캐시를 그대로 유지합니다. 캐시 새로 고침은 외부 파일을 열거나 네트워크 요청을 하지 않습니다

달력 인식 차트 날짜 축

TXLSXChartSeries.ResolveDataCaches는 현재 세대 기준으로 지원되는 로컬 계열 소스를 해석하고, RefreshDataCaches는 빈 소스에 셀 히스토리가 없어도 명시적인 새로 고침을 요청합니다

범주 축이 xlsxAxisDate 를 사용하는 XLSX 차트는 모든 유효한 범주를 통합 문서의 1900 또는 1904 날짜 직렬 체계로 매핑하여, 동일한 간격의 점 슬롯을 할당하는 대신 희소한 날짜 사이의 실제 거리를 유지합니다

BaseTimeUnit 은 일/월/년 정규화를 제어하고, MajorUnit, MinorUnit, MajorTimeUnit, MinorTimeUnit 은 눈금을 달력 단위로 전진시킵니다. 덕분에 월 길이가 제각각이고 윤년이 있어도 월/년 간격이 정렬된 상태를 유지합니다

동일한 제한된 눈금 컬렉션이 좌표, 레이블, 눈금, 요청된 눈금선을 페이지 매김 기반 PDF, SVG, 비트맵, 미리 보기, 인쇄, 뷰어 출력에 공급하고, XLSX HTML은 인라인 차트 SVG에 같은 달력 산술을 사용합니다

독립형 PDF writer

TXLSPDFWriter 는 송장, 티켓, 라벨, 오버레이 양식처럼 통합 문서에서 비롯되지 않는 PDF 문서를 만듭니다. BeginDoc 은 포인트 정밀도의 페이지 박스를 설정하고, NewPage 는 현재 페이지를 닫으며, SaveToStream 또는 SaveToFile 이 문서를 완성합니다

그리기 메서드는 왼쪽 아래를 원점으로 하는 PDF 포인트를 사용하고, 라이브러리 색상은 $00BBGGRR 또는 $AABBGGRR 형태입니다. 사용 가능한 프리미티브는 채워진/스트로크 사각형, 선, 타원, 폭을 정확히 재는 스타일 텍스트, 아핀 변환, 사각형 클리핑, 그래픽 상태의 명시적 저장/복원을 위한 FillRectangle, StrokeRectangle, ClipRectangle, MeasureText, SaveGraphicsState, RestoreGraphicsState 이며, PageWidth 와 PageHeight 는 현재 페이지 박스를 포인트 단위로 보고합니다

SVG 내보내기

TXLSSvgExport 는 클래식 및 XLSX 범위, 워크시트, 통합 문서, 준비된 논리 페이지에 대한 7개의 SaveAsSVG 오버로드를 제공하며, 지원되는 경우 명명된 개체 출력도 제공합니다

UseWorksheetPageSetup, Orientation및 Margin 은 PDF 및 미리 보기 출력과 동일한 페이지 설정 결정을 사용합니다

TXLSSvgExport.PrintComments (타입 TXLSPrintComments)는 페이지 매김 SVG 출력에서 셀 주석을 내보내는 방식을 선택합니다. xpcAtEnd로 설정하면 시트의 마지막 페이지가 데이터 영역 아래에 주석 목록(셀 주소, 작성자, 텍스트)을 덧붙이고, xpcNone 은 주석을 생략합니다

ExportPages 는 한 번에 하나의 완성된 SVG 문서를 OnPage로 보내고, 커밋된 페이지 수를 ExportedPageCount로 보고하며, Callback이 취소하면 이후 페이지 생성을 중단합니다. IdPrefix 는 클립 패스, 필터, 패턴, 공유 리소스를 위한 결정적인 문서/페이지 네임스페이스를 만듭니다

HyperlinkMode (타입 TXLSSvgHyperlinkMode)를 xshmSafe 로 설정하면 시각 콘텐츠 뒤에 잘라낸 투명 히트 영역이 추가됩니다. 허용되는 외부 스킴은 HTTP, HTTPS, mail, FTP, 상대 링크이고, 활성 콘텐츠, 로컬, UNC, 제어 문자 대상은 생략합니다. LinksInNewWindow 는 noopener noreferrer 보호를 추가하고 화면 설명은 SVG 제목이 됩니다

증분 PNG, JPEG 및 멀티페이지 TIFF 출력

TXLSPageImageFormat 은 PNG 또는 JPEG 출력을 선택하고 TXLSPageImageExporter 는 완료된 각 비트맵을 즉시 해제하면서 하나의 페이지 매김 세션을 유지합니다

태그 PDF 및 PDF/A

TXLSPDFExport.TagMode 는 자동 문서, 표, 행, 머리글 셀, 데이터 셀, 정보성 그림 구조를 활성화하며, 조밀한 페이지 로컬 마크 콘텐츠 식별자, 정확한 부모 트리 매핑, 병합 셀 범위, 아티팩트 격리를 갖춥니다. 인쇄 제목 행과 표 머리글 행은 의미 있는 머리글 셀이 되고, AltText 가 비어 있지 않은 XLSX 그림은 Unicode 대체 텍스트를 가진 독립 Figure 요소가 되며, 대체 텍스트가 없는 그림은 장식용 아티팩트로 남습니다

동일한 이미지 페이로드가 하나의 PDF XObject를 공유하더라도 보이는 정보성 그림 인스턴스마다 자체 Figure 요소와 마크 콘텐츠 식별자를 받습니다. AltTextTitle 은 없는 대체 텍스트를 대신하지 않고, 차트는 아티팩트로 유지되며, 이 집중된 구조 지원이 완전한 PDF/UA 적합성을 주장하지는 않습니다

TXLSPDFExport.PDFAProfile 은 적합성 수준 a 또는 b에서 PDF/A-1, PDF/A-2 또는 PDF/A-3을 선택합니다. 호환되지 않는 암호화, 글꼴, 첨부 파일, 투명도, 서명 및 메타데이터는 출력 스트림이 커밋되기 전에 검증됩니다

TXLSPDFExport.ExportCommentsAsAnnotations 는 원본 셀 사각형에 유니코드 작성자 및 주석 텍스트를 배치하며, 전통적인 끝부분 주석 출력은 독립적으로 구성할 수 있습니다

UsePDFA 는 PDF/A-1b용 호환성 스위치이며, UseXRefStream 은 선택한 프로필이 허용하는 경우 교차 참조 스트림을 선택합니다

페이지 기하 구조 및 선택

6개의 CalculatePageCount 오버로드는 PDF 개체를 만들지 않고 클래식 및 XLSX 범위, 워크시트 또는 통합 문서를 허용합니다

PaperWidth 및 PaperHeight 는 포인트 단위의 용지 크기를 재정의하고, LastPage 는 1 기반 출력 구간을 닫으며, Orientation (타입 TXLSPDFOrientation)는 세로 또는 가로 출력을 선택하고, HidePrintObjects ( TXLSPDFHidePrintObject집합: xlsPdfHideHeaders, xlsPdfHideFooters)는 선택한 머리글 또는 바닥글 밴드를 숨기고, PageLayout (타입 TXLSPDFPageLayout)는 초기 뷰어 페이지 배열을 설정합니다

PDF 페이지 모드 및 열기 동작

TXLSPDFExport.PageMode (타입 TXLSPDFPageMode)는 문서를 열 때 PDF 뷰어가 패널을 배치하는 방식을 xlsPdfModeDefault, xlsPdfModeUseOutlines, xlsPdfModeUseThumbs, xlsPdfModeFullScreen, xlsPdfModeUseOC, xlsPdfModeUseAttachments

OpenAction (타입 TXLSPDFOpenAction)는 xlsPdfOpenNone, xlsPdfOpenPage, xlsPdfOpenOutlines중에서 초기 뷰어 동작을 선택합니다. xlsPdfOpenPage에서 OpenActionPage 는 1 기반 대상 페이지(페이지 수 범위로 제한)이고 OpenActionZoom 은 초기 배율입니다. 0이면 뷰어 기본 배율 또는 맞춤을 유지합니다

공유 적응형 벡터 기하 구조

XLSBuildEllipticArcCubics 는 타원 호를 3차 베지어 세그먼트로 변환하면서 호출자가 지정한 평탄도 한계를 재귀적으로 강제합니다. PDF, SVG, 비트맵 렌더링이 이 공유 기하 구조를 사용하므로 크거나 이심률이 큰 호가 단순한 호에 불이익을 주지 않으면서 더 많은 세그먼트를 받습니다

XLSDecodeVectorScene 은 플랫폼 메타파일 재생을 호출하지 않고 EMF 및 WMF 헤더, 레코드 정렬과 크기, 선언된 총계, 정확한 EOF 위치, 리소스 한계를 검증합니다. 네이티브 허용 목록은 저장/복원이 있는 디바이스 컨텍스트 상태 스택, 월드 변환과 결합된 창/뷰포트 매핑, 스톡 개체를 포함한 펜·브러시·확장 펜 개체 테이블, 사각형, 타원, 선 사슬, 다각형, 폴리라인, 대시 스타일이 있는 베지어 곡선, 채우기/스트로크/채우기+스트로크 패스가 있는 패스 브래킷, 둥근 사각형, 호, 현, 부채꼴, 정확한 호→베지어 변환을 통한 각도 호, 크기가 제한된 RGNDATA 사각형 기반의 영역 채우기와 프레임, 글꼴/색/정렬이 있는 제한된 텍스트 실행, Canvas와 SVG를 통해 PNG로 다시 인코딩되는 제한된 stretch-DIB 이미지를 재생하고, escape 레코드는 거부하며, 클리핑과 프라이빗 레코드는 기존의 크기 제한 Fallback에 맡깁니다

PDF 아웃라인 및 페이지 Callback

PDF 아웃라인은 Bookmarks 컬렉션(타입 TXLSPDFBookmarks)에 담깁니다. Add 와 AddForSheet 는 항목을 추가하고, Delete 는 하나를 제거하며, Count 와 Items 가 트리를 열거합니다. 각 TXLSPDFBookmark 항목은 부모/자식 항목(Children), 형제 체인, Unicode 제목, 색상(Color), PageNumber 대상, 워크시트 북마크용 원본 SheetName , 굵게/기울임 플래그( TXLSPDFBookmarkStyle집합: xlsPdfBookmarkBold, xlsPdfBookmarkItalic), 펼치거나 접힌 하위 항목까지 지원합니다. 자동 워크시트 북마크도 동일한 계층 모델을 사용하며, AutoSheetBookmarks 가 생성 여부를 켜고 끕니다

BeforeNewPage 는 각 페이지 박스를 조정할 수 있고, BeforeGeneratePage 와 AfterGeneratePage 는 공개 페이지 도우미인 AppendPageContent, FillPageRectangle, StrokePageRectangle, DrawPageText

서명 및 첨부 파일

TXLSPDFSignature 는 표시 또는 숨김 서명 필드를 구성하고, CertificationPolicy 는 변경 불가, 양식 작성 및 서명 허용, 양식 작성·서명·주석 허용 중 하나를 허용하는 DocMDP 인증 서명을 선택적으로 만듭니다. PDF/A-1은 이 PDF 1.5 기능을 허용하지 않으므로 출력이 커밋되기 전에 거부됩니다

TXLSPDFCertificationPolicy 는 서명 정책을 명시적으로 선택하기 위한 xlsPdfApprovalSignature, xlsPdfCertifyNoChanges, xlsPdfCertifyFormFillingAndSigning, xlsPdfCertifyFormFillingSigningAndAnnotations 를 제공합니다

A TXLSPDFSignDigestEvent 는 다이제스트를 받아 호스트가 생성한 CMS 데이터를 반환하므로 HotXLS에는 개인 키가 필요하지 않습니다

TXLSPDFExport.Signature 는 서명 구성을 연결하고, PDF/A-3 프로필은 AddAttachment를 통해 검증된 연관 파일을 포함할 수 있습니다. 이 메서드는 TXLSPDFAttachment를 큐에 넣습니다. 상세 오버로드는 Unicode 표시 이름, MIME 타입, 설명, 수정 시간, 페이로드, Source/Data/Alternative/Supplement/Unspecified 중 하나인 TXLSPDFAttachmentRelationship 값을 받으며, AttachmentCount 는 큐에 쌓인 총수를 보고하고, AttachmentDuplicatePolicy (타입 TXLSPDFAttachmentDuplicatePolicy)는 같은 이름의 처리 방식을 선택합니다

TXLSPDFSignature.ImageData, ImageFormat, ImageFit (타입 TXLSPDFSignatureImageFit: contain, cover 또는 stretch)는 byte range가 고정되기 전에 일반 모양 Form에 PNG를 배치합니다. contain, cover, stretch 모드는 문서 이미지 캐시를 공유하고, 잘못된 이미지는 서명 전에 실패합니다

The IXLSPDFAttachmentSource 오버로드는 저장할 때까지 지연 실행되고 저장당 소스를 한 번씩 호출하며, EmbeddedFile 개체가 만들어지기 전에 최대 256 MiB까지 스풀합니다. 덕분에 공급자가 실패해도 출력 대상 트랜잭션은 그대로 유지됩니다

최종 조립은 문서 전체 문자열을 하나 만들지 않고 개체를 대상에 순차적으로 기록합니다. 서명하지 않은 내보내기는 순방향 전용 스트림으로 바로 흘러가고, 각 EmbeddedFile은 페이로드 뒤에 내보내지는 간접 /Length 개체로 자신의 바이트 크기를 참조하며, 공급자 바이트는 스풀에서 고정 청크로 복사됩니다. 서명한 내보내기는 크기가 제한된 문서 스풀로 조립되는데, 이 스풀이 ByteRange 와 서명 내용 패치, 두 커버 범위에 대한 증분 SHA-256, 단일 순방향 복사를 받습니다

PDF/A-3 출력은 각 연관 파일을 EmbeddedFiles 이름 트리와 카탈로그 AF 배열 양쪽에 기록하며, Unicode UF 이름, 이스케이프된 MIME PDF Name, AFRelationship, 바이트 크기, 선택적 수정 날짜, 선택적 설명을 갖습니다. PDF/A-1과 PDF/A-2는 큐에 쌓인 첨부 파일을 출력 커밋 전에 거부합니다

문서 메타데이터

DocumentTitle, DocumentAuthor, DocumentSubject, DocumentKeywords및 DocumentFileName 은 PDF 정보 및 메타데이터 사전을 채웁니다

글꼴 대체

TXLSPDFExport.SetFontFallbackChain, AddFontFallback및 ClearFontFallbackChains 는 원본 패밀리 및 스타일별 대체 계층을 구성합니다. LoadedFallbackFontCount 는 캐시된 페이스 수를, FontFallbackSelectionCacheCount 는 캐시된 선택별 Fallback 결정 수를 노출하며, 둘 다 진단용입니다

TXLSPDFExport.FontSize 는 기본 텍스트 크기를 포인트 단위로 설정합니다. 기본값은 9입니다

대체 선택은 글리프 커버리지를 사용하며 유니코드 매핑, 보충 스칼라, 그래핌 클러스터, 셰이핑 클러스터 및 독립형 TTC 페이스를 보존합니다

OnGetFontDirectories 는 요청된 글꼴 패밀리와 스타일에 대해 세미콜론으로 구분된 하나 이상의 글꼴 디렉터리를 반환할 수 있습니다. 허용된 디렉터리는 한 번만 재귀적으로 탐색되고 내부 패밀리/스타일 메타데이터로 인덱싱되어 이후 측정과 그리기에 캐시됩니다

글꼴 포함 정책

TXLSPDFExport.FontEmbedding (타입 TXLSPDFFontEmbedding)는 xlsPdfFontEmbedAuto, xlsPdfFontEmbedSubset, xlsPdfFontEmbedFull, xlsPdfFontEmbedNone으로 자동 포함, 필수 서브셋, 전체 글꼴 프로그램, 맵 전용 출력을 선택합니다. 유효한 서브셋을 만들 수 없으면 필수 서브셋은 원자적으로 실패하고, TTC 페이스는 독립형 글꼴로 변환되며, PDF/A는 맵 전용 출력을 거부합니다

OnFontEmbed 는 Unicode 페이스마다 메트릭, 문자 맵, 셰이핑, 글리프 식별자가 해석되기 전에 한 번 발생합니다. Handled 를 설정하면 반환된 글꼴별 모드와 선택적 교체 바이트를 받아들이고, false로 두면 문서 정책과 원본 페이스를 유지합니다

CFF 아웃라인을 가진 독립형 OpenType 글꼴은 FontFile3 스트림과 OpenType 하위 글꼴이 있는 CIDFontType0 로 포함됩니다. 자동 및 전체 모드는 완전한 프로그램을 유지하고, 필수 CFF 서브셋은 유효한 서브셋을 보존할 수 없어 원자적으로 실패합니다

OpenType GPOS 또는 레거시 kern 데이터를 지닌 포함 글꼴은 단순/복잡 텍스트 모두에 위치가 조정된 글리프 전진 값을 사용합니다. 덕분에 측정, 줄바꿈, 정렬, 내보낸 글리프 위치가 동일한 커닝 결과를 공유합니다

진행률 및 취소

TXLSPDFExport.OnProgress 및 OnProgressEx 는 시작, 페이지 및 끝 단계를 보고합니다. Cancel 은 취소를 요청하고 Aborted 는 부분 스트림을 커밋하지 않고 최종 상태를 보고합니다

참고 항목

• TXLSPaginationModel
• SaveAsPDF
• 고급 통합 문서 워크플로