Form

Обзор

Form — класс в Aspose.PDF FOSS для .NET. Наследуется от: ICollection<Aspose.Pdf.Annotations.WidgetAnnotation>.

Представляет интерактивную форму (AcroForm) PDF-документа.

Этот класс предоставляет 37 методов для работы с объектами Form в программах .NET. Доступные методы включают: Add, AddFieldAppearance, AssignXfa, CopyTo, Delete, ExportFdf, ExportToJson, ExportXfdf, FindByName, FindField, Flatten, Form и ещё 15 методов. Все публичные члены доступны любому приложению .NET после установки пакета Aspose.PDF FOSS для .NET. Свойства: AutoRecalculate, AutoRestoreForm, CalculatedFields, Count, DefaultAppearance, DefaultResources и ещё 14.

Свойства

Имя:Тип:ДоступОписание:
HasXfaboolЧтениеTrue, когда форма содержит часть XFA.
AutoRecalculateboolЧтение/записьЕсли true, пересчитывать вычисляемые поля при каждом изменении зависимости.
AutoRestoreFormboolЧтение/записьВосстанавливает ли форма свои поля из виджетов страниц, когда запись AcroForm /Fields отсутствует/пустая (по умолчанию true).
CalculatedFieldsIEnumerable<Field>?Чтение/записьПорядок полей, используемый для выполнения проходов расчётов.
DefaultAppearanceAspose.Pdf.Annotations.DefaultAppearanceЧтение/записьСтандартный внешний вид, применяемый к полям, у которых нет собственного /DA.
DefaultResourcesAspose.Pdf.Resources?ЧтениеРесурсы шрифта/цветового пространства по умолчанию, используемые в форме.
IsSynchronizedboolЧтениеЯвляется ли базовая коллекция потокобезопасной.
NeedsRenderingboolЧтениеИстина, когда у формы установлен флаг NeedsAppearances.
RemovePermissionboolЧтение/записьЕсли истинно, биты прав доступа документа удаляются перед сохранением.
SignaturesAppendOnlyboolЧтение/записьЕсли true, writer игнорирует модификации, обходящие подпись.
SyncRootobjectЧтениеКорневой объект синхронизации для IsSynchronized.
TypeFormTypeЧтение/записьТип формы (Standard, Static, Dynamic).
IsXfaboolЧтениеЯвляется ли эта форма XFA-формой.
XFAXFA?ЧтениеXFA accessor, раскрывающий базовые пакеты XML (template, datasets, …).
FieldsField[]ЧтениеВозвращает поля формы в виде массива snapshot.
IgnoreNeedsRenderingboolЧтение/записьЕсли истинно, запись NeedAppearances формы подавляется, чтобы Acrobat не восстанавливал внешний вид виджетов при открытии.
EmulateRequierdGroupsboolЧтение/записьКогда истинно, шаг уплощения формы добавляет синтетический маркер Required для XFA-стильных ‘requiredGroups’, у которых не выполнено ограничение at-least-one-required.
CountintЧтениеКоличество корневых полей формы — элементы массива AcroForm /Fields (поля, у которых field-/Parent равен null).
RadioGroupsIReadOnlyList<RadioButtonGroup>ЧтениеВсе группы радиокнопок в форме.
SignaturesExistboolЧтение/записьИстина, если в этой форме существует любое поле подписи с ненулевым словарём подписи /V.

Методы

ПодписьОписание:
GetEnumerator()Вызывает GetEnumerator у данного экземпляра Form.
Add(field: Field, partialName: string, pageNumber: int)Копировать поле в форму под новым частичным именем, привязывая его виджеты к pageNumber.
AddFieldAppearance(field: Field, pageNumber: int, rect: Rectangle)Добавить новое отображение виджета к полю на определённой странице внутри прямоугольника.
AssignXfa(xml: XmlDocument)Заменить наборы данных XFA из данного XmlDocument.
CopyTo(array: Field[], index: int)Скопировать поля в предоставленный массив, начиная с индекса.
Delete(field: Field)Удалить предоставленное поле из формы.
ExportToJson(stream: Stream)Сериализовать поля формы в JSON через предоставленный поток.
ExportToJson(fileName: string)Сериализовать поля формы в JSON в файле.
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?)Сериализовать поля формы в JSON через предоставленный поток.
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?)Сериализовать поля формы в JSON в файле.
GetFieldsInRect(rect: Rectangle)Вернуть поля, которые пересекают заданный прямоугольник.
HasField(field: Field)Истина, когда предоставленное поле принадлежит этой форме.
ImportFromJson(stream: Stream)Считайте значения полей формы из потока JSON и примените их.
ImportFromJson(fileName: string)Считайте значения полей формы из файла JSON и примените их.
MakeFormAnnotationsIndependent(page: Page)Отсоедините аннотации формы от дерева полей, чтобы их можно было перемещать между страницами независимо.
RemoveFieldAppearance(field: Field, appearanceIndex: int)Удалите конкретную запись отображения из поля.
GetXfaDatasetsXml()Получить наборы данных XFA XML, или null, если это не форма XFA.
ExportFdf()Экспортировать данные полей формы в FDF (Forms Data Format) согласно спецификации PDF §12.7.7.
ImportFdf(fdfData: byte[])Импортировать данные полей формы из байтов FDF.
ExportXfdf()Экспортировать данные полей формы в XFDF (XML Forms Data Format).
ImportXfdf(xfdfXml: string)Импортировать данные полей формы из строки XFDF XML.
GetXfaFieldValue(path: string)Получить значение поля XFA по точечному пути в наборах данных XML.
SetXfaFieldValue(path: string, value: string)Установите значение поля XFA по точечному пути в наборах данных XML.
SetXfaFieldValues(values: IReadOnlyList<KeyValuePair<string, string>>)Установите несколько значений полей XFA за один цикл разбора/сериализации наборов данных.
SetXfaFieldImage(path: string, base64: string, contentType: string)Запишите изображение в формате base64 в узел XFA datasets для пути и пометьте его указанным contentType (например,
Flatten()Сведите все поля формы к плоскому виду — отрендерьте их визуальное представление в содержимое страницы и удалите интерактивную форму.
Flatten(document: Document)Сведите все поля формы к плоскому виду — отрендерьте их визуальное представление в содержимое страницы и удалите интерактивную форму.
Form(document: Document)Создать форму, привязанную к документу.
Delete(fieldName: string)Удалить поле формы по имени.
Add(field: Field)Добавьте поле в форму на указанной странице.
Add(field: Field, pageNumber: int)Поле, которое нужно добавить.
findField(fullName: string)Ищет поле по имени; возвращает null, если не найдено.
FindField(fullName: string)PascalCase псевдоним findField.
ToObject()Экспортировать все значения полей как словарь (имя поля → значение).
HasField(fieldName: string)Истина, если поле с указанным полным именем существует в AcroForm.
HasField(fieldName: string, searchChildren: bool)Истина, если поле с указанным именем существует.
FindByName(fullName: string)Найдите поле по его полному имени или по пути XFA для статических форм XFA.

См. также:

 Русский