RadioButtonField
Обзор
RadioButtonField — это класс в Aspose.PDF FOSS для .NET. Наследуется от: ChoiceField.
Этот класс предоставляет 37 методов для работы с объектами RadioButtonField в программах .NET. Доступные методы включают: Accept, Add, AddOption, ChangeAfterResize, ChoiceField, Clone, CopyTo, DeleteOption, ExecuteFieldJavaScript, ExportToJson, ExportValueToJson, Field и еще 12 методов. Все публичные члены доступны любому приложению .NET после установки пакета Aspose.PDF FOSS для .NET. Свойства: Action, Actions, ActiveState, Alignment, AlternateName, AnnotationFlags и еще 89.
Свойства
| Имя: | Тип: | Доступ | Описание: |
|---|---|---|---|
NoToggleToOff | bool | Чтение/запись | /Ff бит 15 (NoToggleToOff): когда истинно пользователь не может снять выбранную радиокнопку, кликнув по ней ещё раз. |
Style | BoxStyle | Чтение/запись | Визуальный стиль глифа радиокнопки (/MK /CA). |
Shape | BoxShape | Чтение/запись | Форма внешней границы виджетов радиокнопок. |
PageIndex | int | Чтение | Индекс страницы, начинающийся с 1, первого виджета поля. |
Options | OptionCollection | Чтение | Коллекция вариантов радиокнопок. |
IsRadio | bool | Чтение | Является ли это радиокнопкой (всегда истинно для RadioButtonField). |
IsPushbutton | bool | Чтение | Является ли это кнопкой (для RadioButtonField всегда ложь). |
SelectedValue | string? | Чтение | Текущее выбранное значение, или null, если ничего не выбрано. |
Selected | int | Чтение/запись | Получает или задает индекс, начинающийся с 1, выбранного варианта радиокнопки среди состояний отображения дочернего виджета /AP/N (исключая универсальное состояние «Off»). |
Value | string? | Чтение/запись | Переопределение значения. |
IsCombo | bool | Чтение | Получает значение is combo. |
IsEditable | bool | Чтение | Получает значение is editable. |
IsMultiSelect | bool | Чтение | Получает признак множественного выбора. |
IsSorted | bool | Чтение | Получает значение is sorted. |
MultiSelect | bool | Чтение/запись | Получить/установить MultiSelect (/Ff бит 22 — 0-based 21). |
CommitImmediately | bool | Чтение/запись | Получить/установить CommitOnSelChange (/Ff бит 27 — 0-based 26). |
SelectedItems | int[] | Чтение/запись | 0-based индексы выбранных вариантов (public-API shape int[] sibling of SelectedIndices; сеттер переписывает /V из соответствующих вариантов). |
SelectedValues | IReadOnlyList<string> | Чтение/запись | Текущие выбранные значения. |
SelectedIndices | IReadOnlyList<int> | Чтение | Индексы выбранных значений (нумерация с нуля) в списке Options. |
Type | FieldType | Чтение | Тип поля. |
FullName | string? | Чтение | Полностью квалифицированное имя поля. |
TextHorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Чтение/запись | Переопределение горизонтального выравнивания, специфичное для текста, применённое к внешнему виду виджета поля. |
PartialName | string? | Чтение/запись | Частичное имя поля (/T). |
NormalAppearance | XForm? | Чтение | Отображение поля “Normal” (запись /AP /N). |
Appearance | Aspose.Pdf.Annotations.AppearanceDictionary | Чтение | Потоки отображения виджета поля (запись /AP), индексированные по имени отображения. |
OnActivated | Annotations.PdfAction? | Чтение/запись | Действие, вызываемое при активации этого поля (запись /A). |
Count | int | Чтение | Number of kids in this field’s /Kids array — either child fields (hierarchy nodes) or widget annotations (a terminal field with multiple visual widgets, such as a grouped checkbox/radio). |
Fields | Field[] | Чтение | Field-typed child kids of this field as a snapshot array — convenience accessor mirroring Fields on the form. |
DefaultValue | string? | Чтение | Значение по умолчанию (/DV). |
AlternateName | string? | Чтение/запись | Альтернативное имя поля / подсказка (/TU entry). |
Flags | Aspose.Pdf.Annotations.AnnotationFlags | Чтение/запись | Флаги аннотации виджета (/F entry), например. |
TabOrder | int | Чтение/запись | Индекс порядка табуляции для этого поля. |
IsReadOnly | bool | Чтение | Является ли поле только для чтения. |
ReadOnly | bool | Чтение/запись | Является ли поле только для чтения (настраиваемый псевдоним для API parity). |
IsRequired | bool | Чтение | Требуется ли поле. |
Characteristics | Aspose.Pdf.Annotations.Characteristics | Чтение | Характеристики внешнего вида (цвета границы / фона, вращение виджета). |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | Чтение/запись | Внешний вид по умолчанию (шрифт, размер, цвет) поля — полевой аналог WidgetAnnotation. |
Rect | Rectangle? | Чтение/запись | Прямоугольник поля. |
Color | Color | Чтение/запись | Цвет поля (хранится в строке /DA default appearance в виде RGB). |
AnnotationIndex | int | Чтение/запись | Позиция вкладки этого виджета поля в массиве /Annots страницы, считаемая с 1 — порядок в массиве определяет порядок вкладок на странице. |
FitIntoRectangle | bool | Чтение/запись | Глобальный флаг: когда true, значение поля автоматически масштабируется, чтобы соответствовать прямоугольнику виджета. |
IsGroup | bool | Чтение | Является ли это поле контейнером/группой дочерних полей. |
IsSharedField | bool | Чтение/запись | Является ли это поле частью группы shared-fields. |
IsSynchronized | bool | Чтение | Является ли коллекция потокобезопасной. |
SyncRoot | object | Чтение | Корень синхронизации; возвращает этот экземпляр. |
MaxFontSize | double | Чтение/запись | Максимальный размер шрифта, используемый для автоматической подгонки внешнего вида поля. |
MinFontSize | double | Чтение/запись | Минимальный размер шрифта, используемый при автоподгонке внешнего вида поля. |
MappingName | string? | Чтение/запись | Имя отображения, используемое внешними скриптами для идентификации поля. |
AnnotationType | AnnotationType | Чтение | Всегда Widget. |
Border | Border? | Чтение/запись | Ширина границы, стиль и шаблон штриха берутся из BS-словаря виджета (поля формы хранят свою границу там, а не в /Border). |
Actions | AnnotationActionCollection | Чтение | Слоты действий для дерева /AA виджета. |
Exportable | bool | Чтение/запись | Следует ли экспортировать значение виджета при отправке формы. |
Highlighting | HighlightingMode | Чтение/запись | Режим визуального выделения, используемый при щелчке пользователя по виджету (/H entry). |
Parent | Forms.Field? | Чтение | Родительское поле, когда этот виджет является визуальным дочерним элементом поля AcroForm. |
Required | bool | Чтение/запись | Нужно ли заполнять виджет перед отправкой (/Ff bit 2). |
HighlightMode | string | Чтение | Режим выделения (/H entry). |
DefaultAppearanceString | string? | Чтение | Строка внешнего вида по умолчанию (/DA entry). |
FieldValue | string? | Чтение | Значение поля (/V entry). |
DefaultFieldValue | string? | Чтение | Значение поля по умолчанию (/DV entry). |
FieldType | string? | Чтение | Тип поля (/FT entry). |
InnerRect | Rectangle? | Чтение | Прямоугольник аннотации, уменьшенный записью /RD (rectangle differences) — область, фактически нарисованная внутри Rect. |
Width | double | Чтение/запись | Ширина прямоугольника аннотации. |
Height | double | Чтение/запись | Высота прямоугольника аннотации. |
ActiveState | string? | Чтение/запись | Текущее активное состояние внешнего вида (запись /AS). |
Alignment | TextAlignment | Чтение/запись | Выравнивание текста (для аннотаций свободного текста / виджетов, содержащих форматированный текст). |
HorizontalAlignment | Aspose.Pdf.HorizontalAlignment | Чтение/запись | Горизонтальное выравнивание (доступно в дополнение к Alignment; оба параметра можно задавать независимо). |
States | AppearanceDictionary | Чтение | Словарь состояний внешнего вида (подсловарь AP/N для каждого состояния, напр., |
UpdateAppearanceOnConvert | bool | Чтение/запись | Определяет, следует ли регенерировать поток отображения, когда аннотация сохраняется в преобразованном документе. |
UseFontSubset | bool | Чтение/запись | Нужно ли выполнять подмножество встроенного шрифта (если он есть). |
Contents | string? | Чтение/запись | Содержимое аннотации (текст). |
Opacity | double | Чтение/запись | Непрозрачность аннотации (0.0 = прозрачная, 1.0 = непрозрачная). |
InteriorColor | Color? | Чтение/запись | Цвет внутренней части аннотации (/IC entry, для аннотаций круга/квадрата/линии). |
Title | string? | Чтение/запись | Заголовок аннотации (автор для разметочных аннотаций). |
Name | string? | Чтение/запись | Имя аннотации (уникальный идентификатор — запись /NM). |
Subject | string? | Чтение/запись | Тема аннотации (/Subj запись). |
ModifiedDate | string? | Чтение | Дата изменения. |
Modified | DateTime | Чтение/запись | Дата /M (modified) в виде набранного DateTime. |
AnnotationFlags | AnnotationFlags | Чтение/запись | Типизированный псевдоним Flags, соответствующий публичному интерфейсу, который раскрывает AnnotationFlags как свойство. |
Action | PdfAction? | Чтение/запись | Действие, связанное с этой аннотацией (запись /A). |
Author | string? | Чтение | Автор аннотации (запись /T). |
AnnotationState | string? | Чтение | Состояние аннотации (/State entry), например, |
AnnotationStateModel | string? | Чтение | Модель состояния аннотации (/StateModel entry), например, |
ReplyType | string? | Чтение | Тип ответа (/RT entry), например, |
InReplyTo | Annotation? | Чтение/запись | Аннотация, на которую отвечает эта (/IRT entry). |
QuadPoints | Point[] | Чтение/запись | QuadPoints как массив значений Point. |
Page | Page? | Чтение | Страница, которой принадлежит эта аннотация, или null, когда её невозможно разрешить (например, |
VerticalAlignment | VerticalAlignment | Чтение/запись | Вертикальное выравнивание применено к этому абзацу. |
Margin | MarginInfo | Чтение/запись | Информация о внешних полях применена к этому абзацу. |
IsFirstParagraphInColumn | bool | Чтение/запись | Заставьте абзац начинать новую колонку. |
IsKeptWithNext | bool | Чтение/запись | Оставьте этот абзац на той же странице, что и следующий. |
IsInNewPage | bool | Чтение/запись | Принудить абзац начинаться на новой странице. |
IsInLineParagraph | bool | Чтение/запись | Флаг встроенного абзаца (не начинает новую строку). |
HyperlinkText | string? | Чтение/запись | Устаревшая строковая цель гиперссылки. |
Hyperlink | Hyperlink? | Чтение/запись | К абзацу применено типизированное оформление гиперссылки. |
ZIndex | int | Чтение/запись | Индекс Z-order, используемый рендерером DOM. |
Методы
| Подпись | Описание: |
|---|---|
RadioButtonField(page: Page) | Создаёт новое поле радиокнопки, привязанное к читателю указанной страницы. |
RadioButtonField(page: Page, rect: Rectangle) | Создавать с установленным на уровне поля параметром /Rect. |
RadioButtonField(doc: Document) | Вызывает RadioButtonField(doc) на этом экземпляре RadioButtonField. |
AddOption(optionName: string, rect: Rectangle) | Добавляет опцию с указанным именем состояния отображения в заданном прямоугольнике. |
AddOption(optionName: string) | Добавляет радиовариант только по имени; затемняет унаследованную версию ChoiceField, поэтому отражение отображает её для данного типа. |
Add(option: RadioButtonOptionField) | Добавляет сконфигурированный RadioButtonOptionField в качестве дочернего виджета этой радиогруппы. |
SetPosition(point: Aspose.Pdf.Point) | Перемещает прямоугольник виджета поля в точку, сохраняя текущую ширину/высоту. |
ChoiceField(doc: Document) | Вызывает ChoiceField(doc) у этого экземпляра RadioButtonField. |
ChoiceField(doc: Document, rect: Rectangle) | Создайте флажок, привязанный к . |
ChoiceField(page: Page, rect: Rectangle) | Вызвает ChoiceField(page, rect) у этого экземпляра RadioButtonField. |
AddOption(export: string, name: string) | Добавьте параметр с отдельными значениями экспорта и отображения. |
DeleteOption(optionName: string) | Удалите первый параметр, соответствующий optionName (либо как простой PdfString, либо как отображаемая часть пары [export, name]). |
Field(doc: Document) | Создайте поле, привязанное к документу. |
GetEnumerator() | Итерирует аннотации виджетов для дочерних элементов этого поля в массиве /Kids. |
CopyTo(array: Aspose.Pdf.Annotations.WidgetAnnotation[], index: int) | Копирует аннотации виджетов в массив, начиная с индекса. |
CopyTo(array: Field[], index: int) | Копирует дочерние элементы этого поля (в виде экземпляров Field) в массив, начиная с индекса. |
ExecuteFieldJavaScript(javaScriptAction: Aspose.Pdf.Annotations.JavascriptAction) | Выполняет предоставленное действие JavaScript над этим полем. |
ExportToJson(stream: Stream) | Сериализуйте это поле в JSON (единственный объект FieldExportingData) через предоставленный поток. |
ExportToJson(fileName: string) | Сериализуйте это поле в файл JSON. |
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?) | Сериализуйте это поле в JSON через предоставленный поток. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | Сериализуйте это поле в файл JSON. |
ExportValueToJson(outputJsonStream: Stream, indented: bool) | Запишите имя поля, флаги и значение в поток JSON. |
Flatten() | Сведите это поле — превратите его значение в статическое содержимое страницы. |
GetWidgetEnumerator() | Перечислитель типизирован как WidgetAnnotation. |
ImportValueFromJson(inputJsonStream: Stream) | Прочитайте значение этого поля из потока JSON. |
ImportValueFromJson(inputJsonStream: Stream, fieldFullNameInJSON: string) | Прочитайте значение именованного поля из потока JSON — отдельного объекта поля (возможно вложенного через ChildFields) или массива таких объектов — и примените значение записи, чей точечный путь совпадает с fieldFullNameInJSON. |
Recalculate() | Пересчитайте значение поля с помощью его сценария вычисления. |
WidgetAnnotation(doc: Document) | Программный ctor — создает простую аннотацию виджета, связанную с ридером документа. |
ExportToJson(stream: System.IO.Stream) | Сериализуйте поле этого виджета как JSON в поток. |
ExportToJson(stream: System.IO.Stream, options: ExportFieldsToJsonOptions?) | Сериализуйте поле этого виджета как один объект FieldExportingData JSON в поток. |
GetCheckedStateName() | Возвращает имя состояния внешнего вида, представляющего состояние “on” / “checked” данного виджета (обычно “Yes”), получаемое из ключей словаря /AP/N (любой, кроме “Off”). |
Accept(visitor: AnnotationSelector) | Вызывает Accept(visitor) у этого экземпляра RadioButtonField. |
GetRectangle(considerRotation: bool) | Граничный прямоугольник, скорректированный с учётом considerRotation. |
ChangeAfterResize(transform: Matrix) | Отрегулировать геометрию аннотации после того, как пользователь изменил размер страницы или хост-прямоугольника. |
UpdateAppearances() | Сгенерировать заново поток нормального отображения (/AP /N) из текущей геометрии и цветов аннотации. |
WriteXfdf(writer: System.Xml.XmlWriter) | Сериализовать эту аннотацию как элемент XFDF в writer (PDF 32000 §12.7.8 / XFDF 3.0). |
Clone() | Поверхностное клонирование — копирует скалярное/совместно используемое состояние ссылок. |