THotPDF.GetLoadedFormFieldOption Method
讀取已載入 PDF 表單欄位中指定選項的匯出值,同時透過輸出參數傳回對應的顯示文字
宣告
function GetLoadedFormFieldOption(FieldIndex, OptionIndex: Integer; out ADisplayValue: AnsiString): AnsiString;
單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
FieldIndex | 目標表單欄位的從零開始的索引 |
OptionIndex | 欄位選項清單中的從零開始的選項索引 |
ADisplayValue | 輸出參數,接收該選項在介面上顯示給使用者的文字 |
ADisplayText | GetLoadedFormFieldOption 所使用的輸入 |
傳回值
傳回該選項的匯出值(export value),即提交表單時實際傳遞給伺服器或 FDF 的字串
使用注意事項
- 僅適用于包含選項列表的欄位類型(如下拉框 ComboBox 或列表框 ListBox),对普通文字欄位呼叫将傳回空字串
- OptionIndex 必須在 0 到 範圍内,越界将觸發例外
- 匯出值與顯示文字可以不同,提交前請區分兩者用途,避免將顯示文字誤作提交內容