THPDFXFAButtonAppearance

單元:HPDFXFAHeadless

HPDFXFABuildButtonAppearance 回傳的自有原生外觀組合,含一個 pushbutton 的實際 HotPDF 物件,不帶頁面或欄位身分

成員契約
ObjectCount: Integer含已準備可達間接物件的槽位數,包括外觀 stream 與實際字型資源
Objects[Index: Integer]: THPDFObject索引 0 到 ObjectCount-1 處的借用物件;無效索引丟出 EHPDFXFAHeadlessError
Properties: THPDFDictionaryObject借用的直接 dictionary,含 AP、MK、H 與可用的 DA/Q 條目;不含頁面、矩形、欄位名稱與欄位旗標
Fonts: THPDFDictionaryObject借用的直接 dictionary,含預設外觀字型別名與間接字型參照,供呼叫端的 AcroForm DR 使用
GlyphUnits: Integer準備 normal 與要求的替代 caption 外觀時使用的 glyph 單位總帳
SerializedBytes: Integer序列化間接物件主體與兩個直接屬性/資源根的總和;不含呼叫端的 widget dictionary、物件標頭、xref 與 trailer
DetachObject(Index): THPDFObject移轉所有權並清空索引槽位,其他物件不重新編號;先前已 detach 的槽位回傳 nil
DetachProperties: THPDFDictionaryObject移轉直接屬性根的所有權並清空 Properties
DetachFonts: THPDFDictionaryObject移轉直接資源根的所有權並清空 Fonts

解構子會釋放仍附著的所有物件與根;detach 出來的物件由呼叫端持有,必須釋放或收養

所有間接物件使用從工廠 FirstObjectNumber 開始的連續 generation 0 編號;參照留在組合內部,資源別名使用實際收養的字型物件編號

把組合收養進既有文件時,請保留一個不相交的物件編號區段、收養全部物件、保留其編號、把屬性值附加到實際 widget,並在該文件的 AcroForm DR 註冊 Fonts 條目