CreateLayoutOptions

頁面版面配置、分頁、Form XObjects

描述

建構欄位齊全的 TPDFlibDynamicLayoutOptions 記錄，供 ComposeNextLayout 使用，其預設值與單純 ComposeNext 的行為一致

語法

Class Function TPDFlibDynamicComponentSession.CreateLayoutOptions(
  ContentWidth, ContentHeight: Double;
  OverflowPolicy: TPDFlibDynamicOverflowPolicy = dopReject;
  HorizontalAlignment: TPDFlibDynamicHorizontalAlignment = dhaLeft;
  VerticalAlignment: TPDFlibDynamicVerticalAlignment = dvaTop;
  PaginationPolicy: TPDFlibDynamicPaginationPolicy = dppAllowSplit;
  MinimumSlotHeight: Double = 0;
  MinimumFollowingHeight: Double = 0):
  TPDFlibDynamicLayoutOptions; Static;

參數

`ContentWidth`, `ContentHeight`	傳遞給元件的有限正數自然畫布，透過 `AvailableWidth` 與 `AvailableHeight` 提供
`OverflowPolicy`	`dopReject`、`dopClip` 或 `dopScaleDown`
`HorizontalAlignment`	`dhaLeft`、`dhaCenter` 或 `dhaRight`
`VerticalAlignment`	`dvaTop`、`dvaCenter` 或 `dvaBottom`
`PaginationPolicy`	`dppAllowSplit`、`dppKeepTogether` 或 `dppRequireComplete`
`MinimumSlotHeight`	元件複製與組合開始前所需的非負插槽高度
`MinimumFollowingHeight`	在最終已解析片段之後為後續元件保留的非負高度

備註

此輔助方法只把每個記錄欄位從參數指派過去，本身不做驗證；ComposeNextLayout 會在元件工作開始前檢查有限性、正值與列舉範圍

身為靜態類別函數，不需 session 執行個體即可呼叫

ComposeNext 的預設選項由 CreateLayoutOptions(Width, Height) 推導

範例

Options := TPDFlibDynamicComponentSession.CreateLayoutOptions(
  640, 360, dopScaleDown, dhaLeft, dvaTop, dppAllowSplit, 72, 24);

Status := Session.ComposeNextLayout(
  PageNumber, 36, 72, 540, 240, Options, Placement);

傳回值

`TPDFlibDynamicLayoutOptions`	已填入所提供自然畫布、溢位、對齊、分頁與流動空間設定的記錄，可直接用於 `ComposeNextLayout`

另請參閱

ComposeNextLayout, ComposeNext, TPDFlibDynamicComponentSession, KeepTogetherRetryPending, LastRetryReason