THotPDF.AddLoadedComboBox Method
在已載入文件的頁面上新增下拉式清單方塊（設定 Combo 旗標的下拉選擇欄位），並註冊到 AcroForm。外觀串流會顯示選取的值
宣告
function AddLoadedComboBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; const AOptions: array of AnsiString): Integer;單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
PageIndex | 接收此 widget 的已載入頁面索引（從零開始） |
X1 | widget 矩形在 PDF 使用者空間中的左緣（單位為 point，原點在頁面左下角） |
Y1 | widget 矩形在 PDF 使用者空間中的下緣 |
X2 | widget 矩形在 PDF 使用者空間中的右緣 |
Y2 | widget 矩形在 PDF 使用者空間中的上緣 |
AFieldName | 新欄位的名稱；已載入表單中不得已有同名欄位 |
AValue | 選取的選項；留空表示不選取 |
AOptions | 下拉清單中提供的選項 |
傳回值
新欄位的索引，可搭配其他已載入表單欄位方法使用；PageIndex 超出範圍時傳回 -1
使用說明
- 在 AcroForm 工作流程中使用此 API，並在受影響的頁面、資源、欄位或 catalog 物件定案之前呼叫
- 在文件定案之前，保持物件名稱、欄位名稱、資源名稱與傳回的 handle 穩定不變
- 已載入文件的物件參照可能是間接參照；檢查巢狀值之前，請先解析陣列、字典或串流