Struct Widget 

pub struct Widget {
    pub rect: Rectangle,
    pub appearance: WidgetAppearance,
    pub parent: Option<String>,
    pub appearance_streams: Option<AppearanceDictionary>,
}

Widget annotation for form field

Fields

rect: Rectangle

Rectangle for widget position

appearance: WidgetAppearance

Appearance settings

parent: Option<String>

Parent field reference (will be set by FormManager)

appearance_streams: Option<AppearanceDictionary>

Appearance streams (Normal, Rollover, Down)

Implementations

impl Widget

pub fn new(rect: Rectangle) -> Self

Create a new widget

pub fn with_appearance(self, appearance: WidgetAppearance) -> Self

Set appearance

pub fn with_appearance_streams(self, streams: AppearanceDictionary) -> Self

Set appearance streams

pub fn generate_appearance( &mut self, field_type: FieldType, value: Option<&str>, ) -> Result<()>

Generate default appearance streams based on field type.

Backwards-compatible entry point — delegates to [generate_appearance_with_font] without any custom-font context. Emits Helvetica + WinAnsi by default, so non-WinAnsi values fail with PdfError::EncodingError. Callers that need CJK, Arabic, or other scripts must use the _with_font variant (typically via Document::fill_field, which routes through it automatically).

pub fn generate_appearance_with_font( &mut self, field_type: FieldType, value: Option<&str>, default_appearance: Option<&DefaultAppearance>, custom_font: Option<&Font>, ) -> Result<HashMap<String, HashSet<char>>>

Generate appearance streams honouring an optional /DA and an optional pre-resolved custom (Type0) font.

Returns the per-font character accumulator produced by the Type0 path — an empty map for the built-in path — so the caller can merge it into Document::used_characters_by_font (subsetter invariant, issue #204).

pub fn to_annotation_dict(&self) -> Dictionary

Convert to annotation dictionary

Trait Implementations

impl Clone for Widget

fn clone(&self) -> Widget

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Widget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.