Struct PdfFormRadioButtonField

Source
pub struct PdfFormRadioButtonField<'a> { /* private fields */ }
Expand description

A single PdfFormField of type PdfFormFieldType::RadioButton. The form field object defines an interactive radio button widget that can be toggled by the user.

Form fields in Pdfium are wrapped inside page annotations of type PdfPageAnnotationType::Widget or PdfPageAnnotationType::XfaWidget. User-specified values can be retrieved directly from each form field object by unwrapping the form field from the annotation, or in bulk from the PdfForm::field_values() function.

Implementations§

Source§

impl<'a> PdfFormRadioButtonField<'a>

Source

pub fn bindings(&self) -> &'a dyn PdfiumLibraryBindings

Returns the PdfiumLibraryBindings used by this PdfFormRadioButtonField object.

Source

pub fn index_in_group(&self) -> u32

Returns the index of this PdfFormRadioButtonField in its control group.

Control groups are used to group related interactive fields together. Checkboxes and radio buttons can be grouped such that only a single button can be selected within the control group. Each field within the group has a unique group index.

Source

pub fn group_value(&self) -> Option<String>

Returns the value set for the control group containing this PdfFormRadioButtonField.

Control groups are used to group related interactive fields together. Checkboxes and radio buttons can be grouped such that only a single button can be selected within the control group. In this case, a single value can be shared by the group, indicating the value of the currently selected field within the group.

Source

pub fn is_checked(&self) -> Result<bool, PdfiumError>

Returns true if this PdfFormRadioButtonField object has its radio button selected.

Source

pub fn set_checked(&mut self) -> Result<(), PdfiumError>

Selects the radio button of this PdfFormRadioButtonField object.

Source

pub fn is_group_selection_required(&self) -> bool

Returns true if exactly one radio button in the control group containing this PdfFormRadioButtonField must be selected at all times. If so, then toggling the currently selected radio button is not possible. If false, then toggling the currently selected radio button will deselect it, leaving no radio button in the group selected.

Source

pub fn set_is_group_selection_required( &mut self, is_group_selection_required: bool, ) -> Result<(), PdfiumError>

Controls whether or not the control group containing this PdfFormRadioButtonField requires exactly one radio button to be selected at all times.

Source

pub fn is_group_in_unison(&self) -> bool

Returns true if all radio buttons in the same control group as this PdfFormRadioButtonField use the same value for the checked state; if so, if one is checked, then all will be checked, and so all radio buttons will turn on and off in unison.

This flag was added in PDF version 1.5.

Source

pub fn set_is_group_in_unison( &mut self, is_group_in_unison: bool, ) -> Result<(), PdfiumError>

Controls whether or not all radio buttons in the same control group as this PdfFormRadioButtonField use the same value for the checked state; if so, if one is checked, then all will be checked, and so all radio buttons will turn on and off in unison.

This flag was added in PDF version 1.5.

Trait Implementations§

Source§

impl<'a> From<PdfFormRadioButtonField<'a>> for PdfFormField<'a>

Source§

fn from(field: PdfFormRadioButtonField<'a>) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<'a, T> PdfFormFieldCommon for T
where T: PdfFormFieldPrivate<'a>,

Source§

fn name(&self) -> Option<String>

Returns the name of this PdfFormField, if any.
Source§

fn appearance_stream(&self) -> Option<String>

Returns the name of the currently set appearance stream for this PdfFormField, if any.
Source§

fn appearance_mode_value( &self, appearance_mode: PdfAppearanceMode, ) -> Option<String>

Returns the value currently set for the given appearance mode for this PdfFormField, if any.
Source§

fn is_read_only(&self) -> bool

Returns true if the value of this PdfFormField is read only. Read more
Source§

fn set_is_read_only(&mut self, is_read_only: bool) -> Result<(), PdfiumError>

Controls whether or not the value of this PdfFormField is read only.
Source§

fn is_required(&self) -> bool

Returns true if this PdfFormField must have a value at the time it is exported by any “submit form” action. Read more
Source§

fn set_is_required(&mut self, is_required: bool) -> Result<(), PdfiumError>

Controls whether or not this PdfFormField must have a value at the time it is exported by any “submit form” action. Read more
Source§

fn is_exported_on_submit(&self) -> bool

Returns true if the value of this PdfFormField will be exported by any “submit form” action. Read more
Source§

fn set_is_exported_on_submit( &mut self, is_exported: bool, ) -> Result<(), PdfiumError>

Controls whether or not the value of this PdfFormField will be exported by any “submit form” action. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.