THotPDF.AddLoadedComboBox Method
Добавляет combo box (choice-поле с выпадающим списком и установленным флагом 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 (пункты, начало координат — левый нижний угол страницы) |
Y1 | Нижняя граница прямоугольника widget в пользовательском пространстве PDF |
X2 | Правая граница прямоугольника widget в пользовательском пространстве PDF |
Y2 | Верхняя граница прямоугольника widget в пользовательском пространстве PDF |
AFieldName | Имя нового поля; его ещё не должно быть в загруженной форме |
AValue | Выбранная опция; пустая строка — без выбора |
AOptions | Опции, предлагаемые в выпадающем списке |
Возвращаемое значение
Индекс нового поля для остальных методов работы с полями загруженной формы или -1, когда PageIndex вне диапазона
Примечания по использованию
- Используйте этот API в рабочем процессе геометрии страницы до того, как затронутая страница, ресурс, поле или объект каталога будут финализированы
- Сохраняйте стабильными имена объектов, имена полей, имена ресурсов и возвращаемые дескрипторы до финализации документа
- Ссылки на объекты загруженного документа могут быть косвенными; разрешайте массивы, словари или потоки перед просмотром вложенных значений