THotPDF.AddLoadedComboBox Method
یک combo box (فیلد انتخابی dropdown با فلگ Combo) به صفحه‌ای از سند بارگذاری‌شده اضافه می‌کند و آن را در AcroForm ثبت می‌کند. appearance stream مقدار انتخاب‌شده را نشان می‌دهد
اعلان
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 | گزینه‌هایی که در فهرست dropdown پیشنهاد می‌شوند |
مقدار بازگشت
اندیس فیلد جدید، برای استفاده با دیگر متدهای فیلد فرم بارگذاری‌شده، یا -1 وقتی PageIndex بیرون از محدوده باشد
یادداشت‌های استفاده
- این API را در جریان کاری هندسهٔ صفحه پیش از نهایی‌شدن صفحه، منبع، فیلد یا شیء کاتالوگ مربوطه به کار ببرید
- نام اشیاء، نام فیلدها، نام منابع و هندل‌های بازگشتی را تا نهایی‌شدن سند پایدار نگه دارید
- ارجاع‌های اشیاء در سند بارگذاری‌شده ممکن است غیرمستقیم باشند؛ پیش از بررسی مقادیر تودرتو، آرایه‌ها، دیکشنری‌ها یا استریم‌ها ارجاع را دنبال کنید