HPDFXFABuildRadioButtonAppearance
單元:HPDFXFAHeadless
function HPDFXFABuildRadioButtonAppearance(const Value, Style: AnsiString;
const Items: TXFAFieldOptions; Width, Height: Double;
const TrueTypeFont: SysUtils.TBytes; FirstObjectNumber: Integer;
const Options: TXFAHeadlessPDFOptions;
const ResolvedCaptionRuns: THPDFHeadlessRichTextRuns = nil): THPDFXFAButtonAppearance;
準備一個真實的 radio 成員外觀,使用與自動 headless XFA 建立相同的原生形狀、標記、尺寸、邊框、Unicode 標題與字型消費端
Value 與 Items 包含 UTF-8 資料;Width 與 Height 是實體 PDF point,Style 攜帶 XFA 版面 callback 輸出的詮釋資料
Style 必須包含非空的 radiogrouphex 重複作用域身分與 radiovaluehex 選取組值,組選取為空時也不例外(此時是空的編碼值)
第一個條目提供成員匯出值,除非 buttonexporthex 提供了精確的 raw 值;選取判斷把該匯出值與解碼後的組值相比較,而不是把非空 Value 當成 Boolean
AP 恰好包含 Off 與該成員的選取狀態;checkbox 的 neutral 詮釋資料不會給 radio 增加第三個狀態
保留字、空值與 XFAOn 前綴匯出值使用獨立的外觀別名;接納它的群組在 Opt 陣列中保留字面撰寫的匯出值
TrueTypeFont 提供真實的預設字型程式;Options.CaptionFontFamilies 提供真實的額外 regular、bold、italic、bold-italic 程式
選用的 ResolvedCaptionRuns 與 HPDFXFABuildButtonAppearance 一樣,做完全相同的承載、格式化與有序候選驗證;只有解析出的設定 family 可以不同
FirstObjectNumber 必須為正,並為所有連續產生的物件編號留出空間;回傳的封包在物件被接走之前擁有可達的原生圖
準備過程不更動呼叫端的文件或串流;輸入、物件、字形、字型、序列化位元組與取消預算在準備全程生效
產生時 Properties 保留 AP、AS、MK、H、DA 與 Q;不包含父節點、組值、匯出陣列、頁、矩形或欄位身分
接納它的文件負責建立父節點與 Kids、把每個 widget 連到正確的重複作用域、持久化選取組值,並把 Fonts 註冊進自己的 AcroForm 資源